连接Clawdbot与Agent Zero框架的双向桥接器，支持复杂编码任务的委托、自校正循环和持久化Docker执行环境。
说明：
## 核心用法
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 的超时限制 |
