核心用法
Agent Zero Bridge 是 Clawdbot 与开源框架 Agent Zero 之间的双向通信网关，专为需要长时间运行、迭代式自校正的复杂任务设计。
主要功能
- 任务委托：将复杂编码、研究或基础设施任务 offload 到 Agent Zero 的持久化 Docker 环境中执行
- 双向通信：支持 A0 → Clawdbot 的进度汇报、工具调用和输入请求
- 文件附件：可附带代码文件进行审查或修改
- 任务拆解：自动生成可跟踪的项目步骤文档（notebook/tasks/projects/*.md）
显著优点
1. 自校正循环：Agent Zero 内置多轮迭代机制，适合需要反复调试的复杂构建任务
2. 持久化环境：Docker 容器保持状态，避免 Clawdbot 上下文长度限制
3. 工具链隔离：A0 独立执行多步骤工具调用（搜索、代码生成、测试），不占用主会话资源
4. 状态透明：通过 status、history 命令实时追踪远程执行进度
潜在缺点与局限
- 部署复杂：需同时配置 Node.js 18+、Agent Zero 服务、Clawdbot Gateway 三层基础设施
- 网络配置敏感：Docker 容器访问宿主机需手动配置 LAN IP，防火墙/NAT 场景易出故障
- 认证令牌生成繁琐：A0 的 mcp_server_token 需通过 SHA256 哈希 runtime_id 计算，无 UI 直接获取
- LLM 依赖双重：A0 本身需要独立的 Gemini/OpenAI API key，故障排查链条长
- 单向优化：主要设计为 Clawdbot → A0 的任务下发，A0 → Clawdbot 的工具调用能力较基础
适合人群
- 需要运行耗时 >10 分钟的自动化构建/测试的开发者
- 研究任务涉及 20+ sequential tool calls 的知识工作者
- 希望隔离"实验性"任务以免影响主 Clawdbot 会话的高级用户
- 已有 Agent Zero 运维经验、愿意维护额外基础设施的技术团队
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | .env 文件含 A0 和 Clawdbot 双令牌 | 使用 Docker secrets 或运行时注入，避免提交到版本控制 |
| 网络暴露 | Gateway 绑定 0.0.0.0 可能暴露于局域网 | 配合防火墙规则限制 18789 端口访问源 |
| 容器逃逸 | A0 默认赋予 Docker socket 访问权限执行工具 | 生产环境使用 rootless Docker 或 gVisor 隔离 |
| 成本失控 | 长时任务 × 多轮 LLM 调用累积费用 | 设置 A0 的 max_iterations 和 Clawdbot 的超时限制 |