用途:在 Next.js 应用中添加 Agent Sandbox 标签页,形成“Sandbox → Prompts → Skills”三段式工作区,把智能体连接到 OpenClaw 沙箱实例,编辑其运行时提示词文件,并分配可复用技能。
主要能力:Sandbox 段提供实例表格(可搜索、分页,含名称、URL、类型、状态、健康、版本、最后检查),支持新增实例(名称、类型 OpenClaw、服务器 URL、Gateway Token)、连接、运行健康与连通性检查、编辑、删除,以及已连接实例卡片、Auto Push on Save、手动 Push 与模型选择。Prompts 段管理八个工作区文件:Identity、Soul、User Context、Tools、Agents、Bootstrap、Heartbeat、Memory,更新为 upsert。Skills 段提供技能表格与新建对话框,可启用/停用技能,技能 CRUD 为平台级、分配为智能体级。
使用方式:需先完成认证(/iblai-auth),配置 MCP 服务器与技能,向用户索取真实 mentorId,并准备可访问的 OpenClaw 实例 URL 与 Gateway Token。项目根目录需有 iblai.env(含 PLATFORM、DOMAIN、TOKEN),模板可用 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载。三个组件从 @iblai/iblai-js/web-containers 导入,均需 platformKey 与 mentorUniqueId,SandboxConfig 的 username 可选。Sandbox 标签默认关闭,由智能体设置中的 enable_claw 控制,宿主应用需自行读取并决定是否渲染标签与路由。完成后运行 /iblai-ops-test,并以 pnpm dev 启动开发服务器。
限制:Gateway Token 只写不可读,编辑时留空保留原值;无提示词内容时 Push 返回 400;未连接沙箱时 Prompts 与 Skills 段不显示;技能分配以 skill.unique_id 为键;useGetClawMentorConfigQuery 的 404 表示未连接而非错误;不要为 SDK 组件添加自定义样式或暗色模式;需安装 sonner 与 @iblai/iblai-web-mentor,Redux store 需包含 mentorReducer 与 mentorMiddleware。