OpenClaw Add Agent

Add a new agent to OpenClaw configuration. Use when user wants to add a new Telegram bot agent to OpenClaw. Triggers: add agent, new agent, bind telegram.

Add Agent to OpenClaw

Workflow

Step 1: Collect Agent Info

Required info from user:

• Bot token: Telegram bot token (format: 123456789:ABCdef...)
• Agent ID: Unique identifier (e.g., translator, customer_support)
• Purpose/Name: Display name (optional, defaults to agent ID)
• Allow users: Telegram user IDs that can access this bot (default: same as existing agents)

Step 2: Update openclaw.json

Edit /home/xgao/.openclaw/openclaw.json:

A. Add agent to agents.list:

{
  "id": "<agent_id>",
  "name": "<name>",
  "workspace": "/home/xgao/clawd-workspace/<agent_id>"
}

B. Add binding:

{
  "agentId": "<agent_id>",
  "match": {
    "channel": "telegram",
    "accountId": "<agent_id>"
  }
}

C. Add telegram account:

"<agent_id>": {
  "enabled": true,
  "dmPolicy": "allowlist",
  "botToken": "<token>",
  "allowFrom": [<user_ids>],
  "groupPolicy": "allowlist",
  "streaming": "partial"
}

Step 3: Create Workspace Directory

mkdir -p /home/xgao/clawd-workspace/<agent_id>

Step 4: Ask About Memory Isolation

Ask user: "是否需要独立的memory？"

• Yes → Each agent already has independent workspace, memory is automatically isolated
• No → Share workspace (not recommended)

Step 5: Restart OpenClaw

Inform user to restart: openclaw restart

Minimal Config Example

For a simple translator bot:

// agents.list
{ "id": "translator", "name": "translator", "workspace": "/home/xgao/clawd-workspace/translator" }

// bindings
{ "agentId": "translator", "match": { "channel": "telegram", "accountId": "translator" } }

// channels.telegram.accounts
"translator": { "enabled": true, "dmPolicy": "allowlist", "botToken": "8223784004:AAE-...", "allowFrom": ["8538882690"], "groupPolicy": "allowlist", "streaming": "partial" }