agent-zero-bridge

# Agent Zero Bridge

Bidirectional communication between Clawdbot and [Agent Zero](https://github.com/frdel/agent-zero).

## When to Use

- Complex coding tasks requiring iteration/self-correction
- Long-running builds, tests, or infrastructure work
- Tasks needing persistent Docker execution environment
- Research with many sequential tool calls
- User explicitly asks for Agent Zero

## Setup (First Time Only)

### 1. Prerequisites
- Node.js 18+ (for built-in fetch)
- Agent Zero running (Docker recommended, port 50001)
- Clawdbot Gateway with HTTP endpoints enabled

### 2. Install
```bash
# Copy skill to Clawdbot skills directory
cp -r <this-skill-folder> ~/.clawdbot/skills/agent-zero-bridge

# Create config from template
cd ~/.clawdbot/skills/agent-zero-bridge
cp .env.example .env
```

### 3. Configure .env
```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_token

# Clawdbot Gateway
CLAWDBOT_API_URL=http://127.0.0.1:18789
CLAWDBOT_API_TOKEN=your_gateway_token

# For 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
```python
# 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`:
```json
{
  "gateway": {
    "bind": "0.0.0.0",
    "auth": { "mode": "token", "token": "your_token" },
    "http": { "endpoints": { "chatCompletions": { "enabled": true } } }
  }
}
```
Then: `clawdbot gateway restart`

### 6. Deploy Client to Agent Zero Container
```bash
docker exec <container> mkdir -p /a0/bridge/lib
docker cp scripts/lib/. <container>:/a0/bridge/lib/
docker cp scripts/clawdbot_client.js <container>:...

# Agent Zero Bridge - Clawdbot Skill

Bidirectional communication bridge between [Clawdbot](https://github.com/clawdbot/clawdbot) and [Agent Zero](https://github.com/frdel/agent-zero).

## What It Does

```
┌─────────────┐                    ┌─────────────┐
│  Clawdbot   │◄──────────────────►│ Agent Zero  │
│  (Claude)   │                    │   (A0)      │
└─────────────┘                    └─────────────┘
```

- **Clawdbot → Agent Zero**: Delegate complex coding/research tasks
- **Agent Zero → Clawdbot**: Report progress, ask questions, notify completion
- **Task Breakdown**: Break complex tasks into tracked, checkable steps

## Installation

### Option 1: Let Clawdbot Install It

Just tell Clawdbot:
> "Install the Agent Zero bridge skill"

Or if you have this repo cloned:
> "Install the Agent Zero bridge skill from ~/path/to/this/folder"

### Option 2: Manual Installation

```bash
# Clone or download this repo
git clone https://github.com/DOWingard/Clawdbot-Agent0-Bridge.git

# Copy to Clawdbot skills directory
cp -r Clawdbot-Agent0-Bridge ~/.clawdbot/skills/agent-zero-bridge

# Configure
cd ~/.clawdbot/skills/agent-zero-bridge
cp .env.example .env
# Edit .env with your API keys (see SKILL.md for details)
```

## Quick Start

After installation, tell Clawdbot:
- "Ask Agent Zero to build a REST API"
- "Delegate this coding task to A0"
- "Have Agent Zero review this code"

Or use the CLI directly:
```bash
node ~/.clawdbot/skills/agent-zero-bridge/scripts/a0_client.js "Your task here"
```

## File Structure

```
agent-zero-bridge/
├── SKILL.md          # Clawdbot skill definition + setup guide
├── .env.example      # Configuration template
├── .gitignore
├── LICENSE           # MIT
├── README.md         # This file
└── scripts/
    ├── a0_client.js        # CLI: Clawdbot → Agent Zero
    ├── clawdbot_client.js  # CLI: Agent Zero → Clawdbot
    ├── task_breakdown.js   # Task breakdown workflow
    └── lib/
        ├── config.js       # Configuration loader
        ├─...