Agent Zero Bridge
by @dowingard
Delegate complex coding, research, or autonomous tasks to Agent Zero framework. Use when user says "ask Agent Zero", "delegate to A0", "have Agent Zero build", or needs long-running autonomous coding with self-correction loops. Supports bidirectional communication, file attachments, task breakdown, and progress reporting.
clawhub install agent-zero-bridgeπ About This Skill
name: agent-zero-bridge description: Delegate complex coding, research, or autonomous tasks to Agent Zero framework. Use when user says "ask Agent Zero", "delegate to A0", "have Agent Zero build", or needs long-running autonomous coding with self-correction loops. Supports bidirectional communication, file attachments, task breakdown, and progress reporting.
Agent Zero Bridge
Bidirectional communication between Clawdbot and Agent Zero.
When to Use
Setup (First Time Only)
1. Prerequisites
2. Install
# Copy skill to Clawdbot skills directory
cp -r ~/.clawdbot/skills/agent-zero-bridgeCreate config from template
cd ~/.clawdbot/skills/agent-zero-bridge
cp .env.example .env
3. Configure .env
# Agent Zero (get token from A0 settings or calculate from runtime ID)
A0_API_URL=http://127.0.0.1:50001
A0_API_KEY=your_agent_zero_tokenClawdbot Gateway
CLAWDBOT_API_URL=http://127.0.0.1:18789
CLAWDBOT_API_TOKEN=your_gateway_tokenFor Docker containers reaching host (use your machine's LAN IP)
CLAWDBOT_API_URL_DOCKER=http://192.168.1.x:18789
4. Get Agent Zero Token
# Calculate from A0's runtime ID
import hashlib, base64
runtime_id = "your_A0_PERSISTENT_RUNTIME_ID" # from A0's .env
hash_bytes = hashlib.sha256(f"{runtime_id}::".encode()).digest()
token = base64.urlsafe_b64encode(hash_bytes).decode().replace("=", "")[:16]
print(token)
5. Enable Clawdbot Gateway Endpoints
Add to~/.clawdbot/clawdbot.json:
{
"gateway": {
"bind": "0.0.0.0",
"auth": { "mode": "token", "token": "your_token" },
"http": { "endpoints": { "chatCompletions": { "enabled": true } } }
}
}
Then: clawdbot gateway restart6. Deploy Client to Agent Zero Container
docker exec mkdir -p /a0/bridge/lib
docker cp scripts/lib/. :/a0/bridge/lib/
docker cp scripts/clawdbot_client.js :/a0/bridge/
docker cp .env :/a0/bridge/
docker exec sh -c 'echo "DOCKER_CONTAINER=true" >> /a0/bridge/.env'
Usage
Send Task to Agent Zero
node scripts/a0_client.js "Build a REST API with JWT authentication"
node scripts/a0_client.js "Review this code" --attach ./file.py
node scripts/a0_client.js "New task" --new # Start fresh conversation
Check Status
node scripts/a0_client.js status
node scripts/a0_client.js history
node scripts/a0_client.js reset # Clear conversation
Task Breakdown (Creates Tracked Project)
node scripts/task_breakdown.js "Build e-commerce platform"
Creates notebook/tasks/projects/.md with checkable steps
From Agent Zero β Clawdbot
Inside A0 container:# Report progress
node /a0/bridge/clawdbot_client.js notify "Working on step 3..."Ask for input
node /a0/bridge/clawdbot_client.js "Should I use PostgreSQL or SQLite?"Invoke Clawdbot tool
node /a0/bridge/clawdbot_client.js tool web_search '{"query":"Node.js best practices"}'
Troubleshooting
| Error | Fix | |-------|-----| | 401 / API key error | Check A0_API_KEY matches Agent Zero's mcp_server_token | | Connection refused from Docker | Use host LAN IP in CLAWDBOT_API_URL_DOCKER, ensure gateway binds 0.0.0.0 | | A0 500 errors | Check Agent Zero's LLM API key (Gemini/OpenAI) is valid |
β‘ When to Use
π‘ Examples
Send Task to Agent Zero
node scripts/a0_client.js "Build a REST API with JWT authentication"
node scripts/a0_client.js "Review this code" --attach ./file.py
node scripts/a0_client.js "New task" --new # Start fresh conversation
Check Status
node scripts/a0_client.js status
node scripts/a0_client.js history
node scripts/a0_client.js reset # Clear conversation
Task Breakdown (Creates Tracked Project)
node scripts/task_breakdown.js "Build e-commerce platform"
Creates notebook/tasks/projects/.md with checkable steps
From Agent Zero β Clawdbot
Inside A0 container:# Report progress
node /a0/bridge/clawdbot_client.js notify "Working on step 3..."Ask for input
node /a0/bridge/clawdbot_client.js "Should I use PostgreSQL or SQLite?"Invoke Clawdbot tool
node /a0/bridge/clawdbot_client.js tool web_search '{"query":"Node.js best practices"}'
π Tips & Best Practices
| Error | Fix | |-------|-----| | 401 / API key error | Check A0_API_KEY matches Agent Zero's mcp_server_token | | Connection refused from Docker | Use host LAN IP in CLAWDBOT_API_URL_DOCKER, ensure gateway binds 0.0.0.0 | | A0 500 errors | Check Agent Zero's LLM API key (Gemini/OpenAI) is valid |