用途：把 ibl.ai 智能体连接或断开到 Claw 沙箱实例，管理实例与模型提供方，推送配置并做健康/连通性检查，设置智能体工作区使用的模型。
认证与约定：基础地址 https://api.iblai.app，每个请求带 Authorization: Api-Token $IBLAI_API_KEY。路径前缀为 https://api.iblai.app/dm/api/ai-mentor（/dm 网关路由到 Data Manager 服务，…/api/ai-agent/… 为同一路由的别名）。路径变量：{org}=$IBLAI_ORG，{username}=$IBLAI_USERNAME，{mentor} 为智能体 UUID，claw/instances/ 与 claw/model-providers/ 的 {id} 为整数主键。未连接时先运行 /iblai-api-login 填充环境变量。
主要能力：读取实例列表与详情、模型提供方、智能体 claw-config（404 表示未连接）、agent-config 与可用模型；写入包括注册/编辑/删除实例，健康检查（202 排队，轮询 last_health_status）、连通性测试、刷新版本、请求配对、推送提供方、安全审计（仅 OpenClaw）；模型提供方的增删改；连接/编辑/断开智能体 claw-config、推送配置、更新 agent-config（model、allowed_models 及 identity/soul 等工作区文件字段）。
用法示例：POST …/orgs/$IBLAI_ORG/mentors/$MENTOR/claw-config/，请求体 {"server": 12, "enabled": true}，server 为实例整数 id。
限制：删除实例/提供方、断开连接、请求配对、推送提供方、安全审计等为对外或破坏性操作，需先与用户确认。gateway_token、auth_headers、connection_params 只写不读。OpenClaw 实例需在 connection_params.device_identity 提供 Ed25519 密钥对，否则推送失败。config 为拒绝列表校验，禁止写入 gateway.auth、gateway.controlUi.dangerouslyDisableDeviceAuth、tools.exec.host、sandbox.mode、hooks.allowUnsafeExternalContent。claw_type 为 openclaw、ironclaw 或 nemoclaw。更多概念与排错见随附 references/concepts.md 与 references/workspace-files.md。