名称： agent-zero-bridge
描述： 将复杂的编码、研究或自主任务委托给 Agent Zero 框架。当用户提及“询问 Agent Zero”、“委托给 A0”、“让 Agent Zero 构建”或需要长时间运行且具备自我修正循环的自主编码时使用。支持双向通信、文件附件、任务分解和进度报告。

Agent Zero 桥接器

Clawdbot 与 Agent Zero 之间的双向通信桥梁。

使用场景

• 需要迭代/自我修正的复杂编码任务
• 长时间运行的构建、测试或基础设施工作
• 需要持久化 Docker 执行环境的任务
• 涉及大量顺序工具调用的研究任务
• 用户明确要求使用 Agent Zero

首次设置

1. 前提条件

• Node.js 18+ (用于内置 fetch)
• Agent Zero 正在运行 (推荐使用 Docker，端口 50001)
• 已启用 HTTP 端点的 Clawdbot Gateway

2. 安装

# 将技能复制到 Clawdbot 技能目录
cp -r <此技能文件夹> ~/.clawdbot/skills/agent-zero-bridge

# 从模板创建配置文件
cd ~/.clawdbot/skills/agent-zero-bridge
cp .env.example .env

3. 配置 .env 文件

# Agent Zero (从 A0 设置获取令牌或根据运行时 ID 计算)
A0_API_URL=http://127.0.0.1:50001
A0_API_KEY=你的_agent_zero_令牌

# Clawdbot Gateway
CLAWDBOT_API_URL=http://127.0.0.1:18789
CLAWDBOT_API_TOKEN=你的网关令牌

# 供 Docker 容器访问宿主机 (使用你的机器局域网 IP)
CLAWDBOT_API_URL_DOCKER=http://192.168.1.x:18789

4. 获取 Agent Zero 令牌

# 根据 A0 的运行时 ID 计算
import hashlib, base64
runtime_id = "你的_A0_PERSISTENT_RUNTIME_ID"  # 来自 A0 的 .env 文件
hash_bytes = hashlib.sha256(f"{runtime_id}::".encode()).digest()
token = base64.urlsafe_b64encode(hash_bytes).decode().replace("=", "")[:16]
print(token)

5. 启用 Clawdbot Gateway 端点

在 ~/.clawdbot/clawdbot.json 中添加：

{
  "gateway": {
    "bind": "0.0.0.0",
    "auth": { "mode": "token", "token": "你的令牌" },
    "http": { "endpoints": { "chatCompletions": { "enabled": true } } }
  }
}

然后执行：clawdbot gateway restart

6. 部署客户端到 Agent Zero 容器

docker exec <容器名或ID> mkdir -p /a0/bridge/lib
docker cp scripts/lib/. <容器名或ID>:/a0/bridge/lib/
docker cp scripts/clawdbot_client.js <容器名或ID>:/a0/bridge/
docker cp .env <容器名或ID>:/a0/bridge/
docker exec <容器名或ID> sh -c 'echo "DOCKER_CONTAINER=true" >> /a0/bridge/.env'

使用方法

向 Agent Zero 发送任务

node scripts/a0_client.js "构建一个带有 JWT 认证的 REST API"
node scripts/a0_client.js "审查这段代码" --attach ./file.py
node scripts/a0_client.js "新任务" --new  # 开始新的对话

检查状态

node scripts/a0_client.js status
node scripts/a0_client.js history
node scripts/a0_client.js reset  # 清空对话

任务分解 (创建可追踪的项目)

node scripts/task_breakdown.js "构建电子商务平台"
# 在 notebook/tasks/projects/<项目名>.md 中创建带有可勾选步骤的文件

从 Agent Zero 到 Clawdbot

在 A0 容器内部：

# 报告进度
node /a0/bridge/clawdbot_client.js notify "正在处理步骤 3..."

# 请求输入
node /a0/bridge/clawdbot_client.js "我应该使用 PostgreSQL 还是 SQLite?"

# 调用 Clawdbot 工具
node /a0/bridge/clawdbot_client.js tool web_search '{"query":"Node.js 最佳实践"}'

故障排除