Openclaw Team Builder

OpenClaw Team Builder

Manage your AI agent team: add agents to any position in the org tree, deploy templates, run health checks, auto-fix issues, and rollback changes.

Setup

The script is at ~/.openclaw/skills/team-builder/scripts/team-builder.sh. It requires openclaw CLI and python3.

TB="bash ~/.openclaw/skills/team-builder/scripts/team-builder.sh"

All examples below use $TB as shorthand.

View Org Tree

# Human-readable tree
$TB --tree
JSON output (for parsing)
$TB --tree --json

JSON output example:

{
  "main": {"name":"软软","emoji":"😘","role":"director","reports_to":null,"manages":["xingzheng"],"description":""},
  "xingzheng": {"name":"xingzheng","emoji":"🤖","role":"worker","reports_to":"main","manages":[],"description":""}
}

Add an Agent

# Full CLI mode (no prompts)
$TB --add \
  --id finance-lead \
  --name "小财-财务助手" \
  --emoji "💰" \
  --role "负责报销审核、预算管理、财务报表" \
  --parent main \
  --soul auto \
  --yes
Use a built-in role template (auto-fills role description)
$TB --add \
  --id caiwu \
  --soul template:caiwu \
  --parent main \
  --yes
With model override and feishu config
$TB --add \
  --id translator \
  --name "翻译官" \
  --emoji "🌐" \
  --role "负责中英文翻译" \
  --parent main \
  --model anthropic/claude-sonnet-4-6 \
  --feishu-app-id cli_xxx \
  --feishu-secret yyy \
  --yes

Parameters

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | --id | Yes | - | Agent ID (english, kebab-case) | | --name | No | same as id | Display name | | --emoji | No | 🤖 | Agent emoji | | --role | No | 通用AI助手 | Role description for SOUL.md | | --parent | No | main | Parent agent ID in org tree | | --soul | No | auto | auto, template:, or skip | | --model | No | inherit | Model override | | --feishu-app-id | No | - | Feishu bot App ID | | --feishu-secret | No | - | Feishu bot App Secret | | --yes | No | false | Skip confirmation prompts |

Soul modes

Goal-Driven Team Suggestion

Given a business goal, recommend the best team configuration from built-in templates.

# Get recommendation (human-readable)
$TB --suggest --goal "电商平台运营"
JSON output (for AI Agent parsing)
$TB --suggest --goal "电商平台运营" --json

JSON output example:

{
  "goal": "电商平台运营",
  "matched_scenario": "ecommerce",
  "scenario_name": "电商团队",
  "recommended_agents": [
    {"id": "kefu", "template": "kefu", "reason": "处理客户咨询和售后"},
    {"id": "yunying", "template": "yunying", "reason": "运营数据分析和活动策划"}
  ],
  "deploy_commands": ["$TB --add --id kefu --soul template:kefu --parent main --yes", "..."],
  "total_agents": 4
}

Supported scenarios: ecommerce(电商), content(内容创作), devteam(研发), startup(创业), consulting(专业服务), solo(超级个体).

AI Agent Workflow: Creating a New Agent

When the user wants to add a new agent, follow these exact steps in order.

CRITICAL: Collect ALL info in ONE message. Do NOT use multi-step Q&A — session context may be lost between messages.

Step 1: Ask ONE compound question (all in a single message):

"好的！帮你创建新助手，请一次性告诉我： 1️⃣ 名字和 emoji（比如：小财 💰） 2️⃣ 核心任务（一句话，比如：负责报销和财务） 3️⃣ 自主级别：建议/执行/全自动 4️⃣ 语调：专业/亲切/简洁

比如：'小财 💰，负责报销和预算，全自动，简洁'"

If the user gives a short answer (e.g. "财务助手"), infer reasonable defaults:

If the user gives partial info, fill in sensible defaults and proceed. Do NOT ask follow-up questions.

Step 2: Immediately construct and execute (do NOT use openclaw agents add directly):

$TB --add \
  --id  \
  --name "" \
  --emoji "" \
  --role "核心任务：。自主级别：。语调：" \
  --parent main \
  --soul auto \
  --yes

Then restart gateway:

openclaw gateway restart

The script automatically: creates agent, generates SOUL.md, configures agentToAgent, and binds to ALL enabled channels (Telegram, Discord, Feishu, WeChat, iMessage).

Step 3: Confirm to user (in the SAME response as execution):

"✅ 已创建并加入团队！已自动绑定所有可用渠道。"

Then show the tree:

$TB --tree

Step 4: Channel configuration (in the SAME response):

After creation, check which channels the agent is missing:

$TB --channels --agent  --json

Then guide the user based on missing_channels:

"📡 缺少以下渠道：

要配置独立的 bot 吗？

When user provides credentials:

# Telegram
$TB --channels --agent  --channel telegram --token  --yes
Discord
$TB --channels --agent  --channel discord --token  --yes
Feishu
$TB --channels --agent  --channel feishu --feishu-app-id  --feishu-secret  --yes

Then restart gateway:

openclaw gateway restart

IMPORTANT:

# Deploy with defaults
$TB --solo --yes
Deploy with specific model
$TB --solo --model anthropic/claude-sonnet-4-6 --yes
Skip SOUL generation
$TB --solo --soul skip --yes

# Human-readable
$TB --templates
JSON
$TB --templates --json

# List all channels and bindings
$TB --channels --json
Filter by agent
$TB --channels --agent kefu --json
Add a Telegram bot for an agent
$TB --channels --agent kefu --channel telegram --token  --yes
Add a Discord bot for an agent
$TB --channels --agent kefu --channel discord --token  --yes
Add a Feishu app for an agent
$TB --channels --agent kefu --channel feishu --feishu-app-id cli_xxx --feishu-secret yyy --yes

{
  "channels": {
    "telegram": {"enabled": true, "type": "shared", "accounts": []},
    "feishu": {"enabled": true, "type": "per-agent", "accounts": ["main"]}
  },
  "agents": [
    {
      "id": "main", "name": "软软",
      "bindings": [{"channel": "telegram", "accountId": ""}],
      "missing_channels": ["feishu"]
    }
  ]
}

$TB --channels --agent  --json

# Telegram
$TB --channels --agent  --channel telegram --token  --yes
Discord
$TB --channels --agent  --channel discord --token  --yes
Feishu
$TB --channels --agent  --channel feishu --feishu-app-id  --feishu-secret  --yes

openclaw gateway restart

# Human-readable
$TB --checkup
JSON
$TB --checkup --json

{
  "checks": [
    {"name": "gateway", "status": "ok", "detail": null},
    {"name": "a2a_allow", "status": "warn", "detail": "缺失: xingzheng"}
  ],
  "issues": 1
}

# Auto-fix (with confirmation)
$TB --fix
Auto-fix (no prompts)
$TB --fix --yes

# Human-readable
$TB --status
JSON (comprehensive)
$TB --status --json

# Interactive rollback (pick from list)
$TB --rollback
Rollback to most recent backup
$TB --rollback --index 1 --yes

$TB --add --id caiwu --soul template:caiwu --parent main --yes

$TB --status --json

$TB --checkup --json
If issues > 0:
$TB --fix --yes

$TB --rollback --index 1 --yes

The script is at ~/.openclaw/skills/team-builder/scripts/team-builder.sh. It requires openclaw CLI and python3.

TB="bash ~/.openclaw/skills/team-builder/scripts/team-builder.sh"

All examples below use $TB as shorthand.