Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
212 changes: 106 additions & 106 deletions README.md

Large diffs are not rendered by default.

102 changes: 51 additions & 51 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ https://github.com/user-attachments/assets/fd23be91-5cf4-457c-a77e-bac24b76e58f

<p align="center"><strong>一键启动团队</strong></p>

<p align="center">用 TOML 模板定义任意团队原型 —— 角色、任务、提示词 —— 一条命令 <code>oh launch</code> 启动</p>
<p align="center">用 TOML 模板定义任意团队原型 —— 角色、任务、提示词 —— 一条命令 <code>clawteam launch</code> 启动</p>

</td>
</tr>
Expand Down Expand Up @@ -162,11 +162,11 @@ ClawTeam 实现了 **Agent 群体智能(Swarm Intelligence)**—— Agent
<td width="33%" valign="top">

### 🦞 Agent 创建 Agent
Leader Agent 调用 `oh spawn` 创建 Worker。每个 Worker 自动获得独立的 **Git Worktree**、**tmux 窗口**和**身份标识**。
Leader Agent 调用 `clawteam spawn` 创建 Worker。每个 Worker 自动获得独立的 **Git Worktree**、**tmux 窗口**和**身份标识**。

```bash
# Leader Agent 执行:
oh spawn --team my-team \
clawteam spawn --team my-team \
--agent-name worker1 \
--task "实现认证模块"
```
Expand All @@ -179,9 +179,9 @@ Worker 检查收件箱、更新任务状态、汇报结果 —— 全部通过 C

```bash
# Worker Agent 检查任务:
oh task list my-team --owner me
clawteam task list my-team --owner me
# 汇报结果:
oh inbox send my-team leader \
clawteam inbox send my-team leader \
"认证模块完成,全部测试通过。"
```

Expand All @@ -193,9 +193,9 @@ oh inbox send my-team leader \

```bash
# 同时观看所有 Agent
oh board attach my-team
clawteam board attach my-team
# 或打开 Web 仪表板
oh board serve --port 8080
clawteam board serve --port 8080
```

</td>
Expand Down Expand Up @@ -232,16 +232,16 @@ oh board serve --port 8080

🦞 Leader Agent 的行动:
├── 📖 阅读 program.md,理解实验协议
├── 🏗️ oh team spawn-team autoresearch
├── 🏗️ clawteam team spawn-team autoresearch
├── 🚀 为每块 GPU 分配研究方向:
│ ├── GPU 0: oh spawn --task "探索模型深度(DEPTH 10-16)"
│ ├── GPU 1: oh spawn --task "探索模型宽度(ASPECT_RATIO 80-128)"
│ ├── GPU 2: oh spawn --task "调优学习率和优化器"
│ ├── GPU 3: oh spawn --task "探索批量大小"
│ ├── GPU 4-7: oh spawn tmux codex --task "..."(Codex Agent)
│ ├── GPU 0: clawteam spawn --task "探索模型深度(DEPTH 10-16)"
│ ├── GPU 1: clawteam spawn --task "探索模型宽度(ASPECT_RATIO 80-128)"
│ ├── GPU 2: clawteam spawn --task "调优学习率和优化器"
│ ├── GPU 3: clawteam spawn --task "探索批量大小"
│ ├── GPU 4-7: clawteam spawn tmux codex --task "..."(Codex Agent)
│ └── 🌳 每个 Agent 独立的 Git Worktree 和分支
├── 🔄 每 30 分钟检查进展:
│ ├── oh board show autoresearch
│ ├── clawteam board show autoresearch
│ ├── 读取每个 Agent 的 results.tsv
│ ├── 🏆 识别最佳发现(depth=12、batch=2^17、norm-before-RoPE)
│ └── 📡 交叉融合:让新 Agent 从最佳配置开始
Expand All @@ -264,7 +264,7 @@ oh board serve --port 8080
人类提示词:"做一个全栈 Todo 应用,包含认证、数据库和 React 前端。"

🦞 Leader Agent 的行动:
├── 🏗️ oh team spawn-team webapp -d "全栈 Todo 应用"
├── 🏗️ clawteam team spawn-team webapp -d "全栈 Todo 应用"
├── 📋 创建带依赖链的任务:
│ ├── T1: "设计 REST API 接口" → architect
│ ├── T2: "实现 JWT 认证" --blocked-by T1 → backend1
Expand All @@ -290,7 +290,7 @@ oh board serve --port 8080

```bash
# 一条命令启动完整团队:
oh launch hedge-fund --team fund1 --goal "分析 AAPL、MSFT、NVDA 的 Q2 2026 投资价值"
clawteam launch hedge-fund --team fund1 --goal "分析 AAPL、MSFT、NVDA 的 Q2 2026 投资价值"
```

```
Expand Down Expand Up @@ -343,15 +343,15 @@ pip install -e ".[p2p]"

```bash
tmux -V
oh --help
clawteam --help

# 把 claude 换成你实际要用的 agent:
claude --version
codex --version
nanobot --help
```

如果 agent CLI 自己都跑不起来,`oh spawn` 也不会帮你修好它。
如果 agent CLI 自己都跑不起来,`clawteam spawn` 也不会帮你修好它。

### ⚡ 方式一:让 Agent 驱动(推荐)

Expand All @@ -362,36 +362,36 @@ ClawTeam 自带一个可复用的 skill,位于 `skills/clawteam/`。
把这个 skill 安装到 `~/.claude/skills/clawteam`,然后直接告诉你的 Agent:

```
"帮我做一个 Web 应用。用 oh 把工作拆分给多个 Agent。"
"帮我做一个 Web 应用。用 clawteam 把工作拆分给多个 Agent。"
```

**Codex**

把同一个 skill 安装到 `$CODEX_HOME/skills/clawteam`(通常是 `~/.codex/skills/clawteam`),然后提示:

```
用 $oh 把这个任务拆成多 Agent 团队,协调执行直到完成。
用 $clawteam 把这个任务拆成多 Agent 团队,协调执行直到完成。
```

Agent 会自动使用 `oh` 命令创建团队、启动 Worker、分配任务、协调工作。
Agent 会自动使用 `clawteam` 命令创建团队、启动 Worker、分配任务、协调工作。

### 🔧 方式二:手动操作

```bash
# 1. 创建团队
oh team spawn-team my-team -d "构建认证模块" -n leader
clawteam team spawn-team my-team -d "构建认证模块" -n leader

# 2. 启动 Worker Agent —— 每个自动获得 Git Worktree、tmux 窗口和身份
oh spawn --team my-team --agent-name alice --task "实现 OAuth2 流程"
oh spawn --team my-team --agent-name bob --task "编写认证单元测试"
clawteam spawn --team my-team --agent-name alice --task "实现 OAuth2 流程"
clawteam spawn --team my-team --agent-name bob --task "编写认证单元测试"

# 3. Worker 自动获得协作提示词,知道如何:
# ✅ 查看任务:oh task list my-team --owner alice
# ✅ 更新状态:oh task update my-team <id> --status completed
# ✅ 汇报 Leader:oh inbox send my-team leader "完成!"
# ✅ 查看任务:clawteam task list my-team --owner alice
# ✅ 更新状态:clawteam task update my-team <id> --status completed
# ✅ 汇报 Leader:clawteam inbox send my-team leader "完成!"

# 4. 观看 Agent 协同工作
oh board attach my-team
clawteam board attach my-team
```

### 🧩 Profiles 和 Presets
Expand All @@ -401,25 +401,25 @@ oh board attach my-team

```bash
# 查看内置 provider 模板
oh preset list
oh preset show moonshot-cn
clawteam preset list
clawteam preset show moonshot-cn

# 从 preset 生成可复用的 runtime profile
oh preset generate-profile moonshot-cn claude --name claude-kimi
clawteam preset generate-profile moonshot-cn claude --name claude-kimi

# MiniMax(M2.7)— 国际或国内端点
oh preset generate-profile minimax-global claude --name claude-minimax
oh preset generate-profile minimax-cn claude --name claude-minimax-cn
clawteam preset generate-profile minimax-global claude --name claude-minimax
clawteam preset generate-profile minimax-cn claude --name claude-minimax-cn

# 或使用交互式 TUI
oh profile wizard
clawteam profile wizard

# Claude Code 在全新机器 / 全新 HOME 下通常只需要执行一次
oh profile doctor claude
clawteam profile doctor claude

# 在真正 spawn 之前先做 smoke test
MOONSHOT_API_KEY=... oh profile test claude-kimi
MINIMAX_API_KEY=... oh profile test claude-minimax
MOONSHOT_API_KEY=... clawteam profile test claude-kimi
MINIMAX_API_KEY=... clawteam profile test claude-minimax
```

可以这样理解:
Expand All @@ -431,20 +431,20 @@ MINIMAX_API_KEY=... oh profile test claude-minimax

### 🧭 我到底该用哪条 spawn 命令?

通用格式是 `oh spawn [backend] [command] ...`。`command` 要填你机器上本来就能工作的 agent CLI:
通用格式是 `clawteam spawn [backend] [command] ...`。`command` 要填你机器上本来就能工作的 agent CLI:

```bash
# Claude Code
oh spawn tmux claude --team my-team --agent-name alice --task "实现 OAuth2"
clawteam spawn tmux claude --team my-team --agent-name alice --task "实现 OAuth2"

# Codex
oh spawn tmux codex --team my-team --agent-name bob --task "编写前端测试"
clawteam spawn tmux codex --team my-team --agent-name bob --task "编写前端测试"

# nanobot
oh spawn tmux nanobot --team my-team --agent-name carol --task "构建 API"
clawteam spawn tmux nanobot --team my-team --agent-name carol --task "构建 API"

# 已配置好的 profile(推荐用于非默认 provider / 模型)
oh spawn tmux --profile claude-kimi --team my-team --agent-name dave --task "重构认证流程"
clawteam spawn tmux --profile claude-kimi --team my-team --agent-name dave --task "重构认证流程"
```

说明:
Expand All @@ -467,7 +467,7 @@ oh spawn tmux --profile claude-kimi --team my-team --agent-name dave --task "重
如果你不确定一个 agent 是否兼容,先这样测:

```bash
oh spawn subprocess <your-agent> --team my-team --agent-name test --task "Say OK"
clawteam spawn subprocess <your-agent> --team my-team --agent-name test --task "Say OK"
```

这条能跑通,再切到 `tmux` 做交互式监控。
Expand All @@ -478,13 +478,13 @@ oh spawn subprocess <your-agent> --team my-team --agent-name test --task "Say OK

| Agent | 启动命令 | 状态 |
|-------|---------|------|
| [Claude Code](https://claude.ai/claude-code) | `oh spawn tmux claude --team ...` | ✅ 完全支持 |
| [Codex](https://openai.com/codex) | `oh spawn tmux codex --team ...` | ✅ 完全支持 |
| [OpenClaw](https://github.com/openclaw/openclaw) | `oh spawn tmux openclaw --team ...` | ✅ 完全支持 |
| [nanobot](https://github.com/HKUDS/nanobot) | `oh spawn tmux nanobot --team ...` | ✅ 完全支持 |
| [Kimi CLI](https://github.com/MoonshotAI/kimi-cli) | `oh spawn tmux kimi --team ...` | ✅ 完全支持 |
| [Cursor](https://cursor.com) | `oh spawn subprocess cursor --team ...` | 🔮 实验性 |
| 自定义脚本 | `oh spawn subprocess python --team ...` | ✅ 完全支持 |
| [Claude Code](https://claude.ai/claude-code) | `clawteam spawn tmux claude --team ...` | ✅ 完全支持 |
| [Codex](https://openai.com/codex) | `clawteam spawn tmux codex --team ...` | ✅ 完全支持 |
| [OpenClaw](https://github.com/openclaw/openclaw) | `clawteam spawn tmux openclaw --team ...` | ✅ 完全支持 |
| [nanobot](https://github.com/HKUDS/nanobot) | `clawteam spawn tmux nanobot --team ...` | ✅ 完全支持 |
| [Kimi CLI](https://github.com/MoonshotAI/kimi-cli) | `clawteam spawn tmux kimi --team ...` | ✅ 完全支持 |
| [Cursor](https://cursor.com) | `clawteam spawn subprocess cursor --team ...` | 🔮 实验性 |
| 自定义脚本 | `clawteam spawn subprocess python --team ...` | ✅ 完全支持 |

像 “Claude Code 走 Moonshot Kimi”、”Claude Code 走 MiniMax” 或 “Gemini 走 Vertex” 这类 provider-aware 场景,
推荐先用 `profile` + `preset` 配好,再通过 `--profile` 启动。
Expand Down Expand Up @@ -529,7 +529,7 @@ oh spawn subprocess <your-agent> --team my-team --agent-name test --task "Say OK

### 🎪 团队模板
- **TOML 文件**定义团队原型(角色、任务、提示词)
- 一条命令启动完整团队:`oh launch <template>`
- 一条命令启动完整团队:`clawteam launch <template>`
- 内置:AI 对冲基金(7 Agent),可自定义

</td>
Expand Down
Loading