核心用法
openclaw-agent-orchestrator 专用于管理 OpenClaw 平台上的持久化子智能体(durable agents)。其核心工作流为:先运行 ./scripts/verify-runtime.sh 验证当前运行时真相,若目标智能体不存在则通过 ./scripts/create-agent.sh 创建,需要路由时执行 openclaw agents bind 添加绑定,最后再次验证状态并仅报告经确认存在的对象。
显著优点
1. 状态真实性保障:强制要求 openclaw agents list --json 和 openclaw agents bindings --json 返回确认后才宣告成功,杜绝"幻觉式"编排
2. 规避已知陷阱:明确禁止使用 sessions_spawn 的 mode="session" 模式,因此运行时缺乏 thread=true 和 subagent_spawning 钩子支持
3. 防御性编程:内置 guardrails 阻止未验证前的成功断言(如"GO"、"starting now"等),显著降低运维事故
潜在缺点与局限性
- 环境依赖强:仅适用于已部署 OpenClaw 的运行时,无法跨平台使用
- 脚本前置要求:依赖特定 shell 脚本(
verify-runtime.sh、create-agent.sh)的存在与可执行性 - 功能边界清晰:不处理 crontab 类调度,需转用
openclaw cron系列命令 - 无自动修复:仅报告验证失败,不自动重试或回滚
适合人群
平台运维工程师、SRE、需要确保智能体真实存在的系统管理员,以及遇到"运行时声称已启动但查询无记录"问题的调试人员。
常规风险
- 脚本权限风险:若
./scripts/目录脚本缺失或权限错误,验证流程将中断 - 并发状态竞争:验证与创建之间若存在其他操作者,可能导致状态不一致
- JSON 解析依赖:验证步骤依赖
--json输出格式,若 CLI 版本变更可能解析失败