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`.

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

All examples below use `$TB` as shorthand.

## View Org Tree

```bash
# Human-readable tree
$TB --tree

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

JSON output example:
```json
{
  "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

```bash
# 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:<key>`, or `skip` |
| `--model` | No | inherit | Model override |
| `--feishu-app-id` | No | - | Feishu bot App ID |
| `--feishu-secret` | No | - | Feishu bot...

# OpenClaw Team Builder

> AI Agent 团队管理工具 — 让你的 AI 团队像公司一样运转

[![OpenClaw](https://img.shields.io/badge/OpenClaw-2026.3.x-blue)](https://docs.openclaw.ai)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

## 它做什么？

OpenClaw 原生支持多 Agent，但缺少**团队管理**能力：

- 没有组织架构 → Team Builder 提供树状层级管理
- 没有批量操作 → 一键部署"超级个体"4人团队
- 没有健康检查 → 自动扫描 agentToAgent、SOUL.md、binding 缺失
- 没有一键修复 → 根据体检结果自动修复所有问题
- 没有回退机制 → 每次操作自动备份，随时撤回

## 双模式

| 模式 | 用户 | 触发方式 |
|------|------|----------|
| TUI 交互式 | 人类 | `bash team-builder.sh`（无参数） |
| CLI 批处理 | AI Agent | `bash team-builder.sh --tree --json` |

## 快速开始

### 作为 ClawhHub Skill 安装

```bash
npx clawhub install team-builder
```

### 手动安装

```bash
mkdir -p ~/.openclaw/skills/team-builder/scripts/
cp scripts/team-builder.sh ~/.openclaw/skills/team-builder/scripts/
cp SKILL.md ~/.openclaw/skills/team-builder/
```

### 独立脚本使用

```bash
# 直接运行 TUI
bash openclaw-team-builder.sh

# CLI 模式
bash openclaw-team-builder.sh --tree --json
bash openclaw-team-builder.sh --add --id finance --soul template:caiwu --yes
```

## CLI 命令速查

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

$TB --tree [--json]                          # 查看架构
$TB --add --id <id> [--name --emoji --role --parent --soul --model] [--yes]  # 新增
$TB --solo [--model <m>] [--yes]             # 超级个体模板
$TB --suggest --goal "业务目标" [--json]     # 目标驱动团队推荐
$TB --channels [--agent <id>] [--json]      # 渠道状态
$TB --channels --agent <id> --channel telegram --token <t> --yes  # 添加 bot
$TB --templates [--json]                     # 角色模板列表
$TB --checkup [--json]                       # 健康检查
$TB --fix [--yes]                            # 一键修复
$TB --status [--json]                        # 军团状态
$TB --rollback [--index N] [--yes]...