English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Français | Español | Deutsch | Italiano | Русский | Português (Brasil)

🦞ClawTeam-OpenClaw

CLIコーディングエージェントのためのマルチエージェントスワーム連携 — OpenClaw をデフォルトに

HKUDS/ClawTeam のフォーク — OpenClaw との深い統合を実現：デフォルトの openclaw エージェント、エージェントごとのセッション分離、実行承認の自動設定、本番環境対応のスポーンバックエンドを搭載。上流の修正はすべて同期されます。

目標を設定するだけ。エージェントスワームが残りを処理します — ワーカーの生成、タスクの分割、連携、結果の統合まですべて自動です。

OpenClaw（デフォルト）、Claude Code、Codex、nanobot、Cursor、およびあらゆる CLI エージェントで動作します。

なぜ ClawTeam なのか？

現在の AI エージェントは強力ですが、孤立して動作しています。ClawTeam を使えば、エージェントが自律的にチームを編成し、作業を分担し、コミュニケーションし、人間が細かく管理しなくても結果を収束させることができます。

仕組み

clawteam spawn --team my-team \
  --agent-name worker1 \
  --task "Implement auth module"

clawteam task list my-team --owner me
clawteam inbox send my-team leader \
  "Auth done. All tests passing."

clawteam board attach my-team
# Or web dashboard
clawteam board serve --port 8080

クイックスタート

方法 1: エージェントに任せる（推奨）

ClawTeam をインストールし、エージェントにプロンプトを与えます：

"Build a web app. Use clawteam to split the work across multiple agents."

エージェントが自動でチームを作成し、ワーカーを生成し、タスクを割り当て、連携を行います — すべて clawteam CLI を通じて。

方法 2: 手動で操作する

# Create a team
clawteam team spawn-team my-team -d "Build the auth module" -n leader

# Spawn workers — each gets a git worktree + tmux window
clawteam spawn --team my-team --agent-name alice --task "Implement OAuth2 flow"
clawteam spawn --team my-team --agent-name bob   --task "Write unit tests for auth"

# Watch them work
clawteam board attach my-team

対応エージェント

インストール

ステップ 1: 前提条件

ClawTeam には Python 3.10+、tmux、および少なくとも1つの CLI コーディングエージェント（OpenClaw、Claude Code、Codex など）が必要です。

既にインストール済みのものを確認：

python3 --version   # Need 3.10+
tmux -V             # Need any version
openclaw --version  # Or: claude --version / codex --version

不足している前提条件のインストール：

OpenClaw の代わりに Claude Code や Codex を使用する場合は、それぞれのドキュメントに従ってインストールしてください。OpenClaw はデフォルトですが、必須ではありません。

ステップ 2: ClawTeam のインストール

⚠️ pip install clawteam や npm install -g clawteam を直接実行しないでください：

• pip install clawteam は PyPI 上の上流バージョンをインストールし、デフォルトが claude で OpenClaw 向けの適応が含まれていません。
• npm install -g clawteam は無関係のスクワッティングパッケージをインストールします（発行者 a9logic）。clawteam --version で "Coming Soon" と表示される場合は誤ったパッケージです。まず npm uninstall -g clawteam で削除してください。

以下の 3 つのコマンドを使用してください — clone 後の pip install -e . は必須です。PyPI からではなくローカルリポジトリからインストールします。

git clone https://github.com/win4r/ClawTeam-OpenClaw.git
cd ClawTeam-OpenClaw
pip install -e .    # ← 必須！ローカルリポジトリからインストール。pip install clawteam とは異なります

オプション — P2P トランスポート（ZeroMQ）：

pip install -e ".[p2p]"

ステップ 3: ~/bin/clawteam シンボリックリンクの作成

生成されたエージェントは、pip の bin ディレクトリが PATH にない新しいシェルで実行されます。~/bin にシンボリックリンクを作成することで、clawteam が常に到達可能になります：

mkdir -p ~/bin
ln -sf "$(which clawteam)" ~/bin/clawteam

which clawteam が何も返さない場合は、バイナリを手動で見つけてください：

# Common locations:
# ~/.local/bin/clawteam
# /opt/homebrew/bin/clawteam
# /usr/local/bin/clawteam
# /Library/Frameworks/Python.framework/Versions/3.*/bin/clawteam
find / -name clawteam -type f 2>/dev/null | head -5

次に、~/bin が PATH に含まれていることを確認します — 含まれていない場合は ~/.zshrc または ~/.bashrc に以下を追加してください：

export PATH="$HOME/bin:$PATH"

ステップ 4: OpenClaw スキルのインストール（OpenClaw ユーザーのみ）

スキルファイルは、OpenClaw エージェントに自然言語で ClawTeam の使い方を教えます。OpenClaw を使用していない場合は、このステップをスキップしてください。

mkdir -p ~/.openclaw/workspace/skills/clawteam
cp skills/openclaw/SKILL.md ~/.openclaw/workspace/skills/clawteam/SKILL.md

ステップ 5: 実行承認の設定（OpenClaw ユーザーのみ）

生成された OpenClaw エージェントは、clawteam コマンドを実行するための許可が必要です。この設定がないと、エージェントがインタラクティブな許可プロンプトでブロックされます。

# Ensure security mode is "allowlist" (not "full")
python3 -c "
import json, pathlib
p = pathlib.Path.home() / '.openclaw' / 'exec-approvals.json'
if p.exists():
    d = json.loads(p.read_text())
    d.setdefault('defaults', {})['security'] = 'allowlist'
    p.write_text(json.dumps(d, indent=2))
    print('exec-approvals.json updated: security = allowlist')
else:
    print('exec-approvals.json not found — run openclaw once first, then re-run this step')
"

# Add clawteam to the allowlist (use the absolute path — OpenClaw 4.2+ requires it)
openclaw approvals allowlist add --agent "*" "$(which clawteam)"

openclaw approvals が失敗する場合、OpenClaw ゲートウェイが起動していない可能性があります。先にゲートウェイを起動してからリトライしてください。

ステップ 6: 動作確認

clawteam --version          # Should print version
clawteam config health      # Should show all green

OpenClaw を使用している場合は、スキルが読み込まれていることも確認してください：

openclaw skills list | grep clawteam

自動インストーラー

上記のステップ 2〜6 は、単一のスクリプトでも実行できます：

git clone https://github.com/win4r/ClawTeam-OpenClaw.git
cd ClawTeam-OpenClaw
bash scripts/install-openclaw.sh

トラブルシューティング

ユースケース

1. 自律型 ML 研究 — 8 エージェント x 8 GPU

@karpathy/autoresearch に基づく。1つのプロンプトで 8 つの研究エージェントを H100 上に展開し、2000 以上の実験を自律的に設計します。

Human: "Use 8 GPUs to optimize train.py. Read program.md for instructions."

Leader agent:
├── Spawns 8 agents, each assigned a research direction (depth, width, LR, batch size...)
├── Each agent gets its own git worktree for isolated experiments
├── Every 30 min: checks results, cross-pollinates best configs to new agents
├── Reassigns GPUs as agents finish — fresh agents start from best known config
└── Result: val_bpb 1.044 → 0.977 (6.4% improvement) across 2430 experiments in ~30 GPU-hours

詳細な結果: novix-science/autoresearch

2. エージェント駆動ソフトウェア開発

Human: "Build a full-stack todo app with auth, database, and React frontend."

Leader agent:
├── Creates tasks with dependency chains (API schema → auth + DB → frontend → tests)
├── Spawns 5 agents (architect, 2 backend, frontend, tester) in separate worktrees
├── Dependencies auto-resolve: architect completes → backend unblocks → tester unblocks
├── Agents coordinate via inbox: "Here's the OpenAPI spec", "Auth endpoints ready"
└── Leader merges all worktrees into main when complete

3. AI ヘッジファンド — テンプレート起動

TOML テンプレートで、1つのコマンドで完全な 7 エージェント投資チームを生成します：

clawteam launch hedge-fund --team fund1 --goal "Analyze AAPL, MSFT, NVDA for Q2 2026"

5 人のアナリストエージェント（バリュー、グロース、テクニカル、ファンダメンタルズ、センチメント）が並行して作業します。リスクマネージャーがすべてのシグナルを統合します。ポートフォリオマネージャーが最終判断を下します。

テンプレートは TOML ファイルです — あらゆるドメインに合わせて独自のテンプレートを作成できます。

機能

その他: プラン承認ワークフロー、グレースフルなライフサイクル管理、全コマンドで --json 出力、クロスマシン対応（NFS/SSHFS または P2P）、マルチユーザーネームスペース、自動ロールバック付きスポーン検証、並行安全のための fcntl ファイルロック。

OpenClaw 統合

このフォークは OpenClaw をデフォルトエージェントにしています。ClawTeam なしでは、各 OpenClaw エージェントは孤立して動作します。ClawTeam がそれをマルチエージェントプラットフォームに変えます。

スキルをインストールしたら、任意のチャンネルで OpenClaw ボットに話しかけてください：

  You (Telegram/Discord/TUI)
         │
         ▼
  ┌──────────────────┐
  │  OpenClaw Gateway │  ← activates clawteam skill
  └────────┬─────────┘
           │
           ▼
  ┌──────────────────┐     clawteam spawn     ┌─────────────────┐
  │  Leader Agent    │ ─────────────────────► │  openclaw tui   │
  │  (openclaw)      │ ──┐                    │  (tmux window)  │
  │                  │   │                    │  git worktree   │
  │  Manages swarm   │   ├──────────────────► ├─────────────────┤
  │  via clawteam    │   │                    │  openclaw tui   │
  │  CLI             │   ├──────────────────► ├─────────────────┤
  └──────────────────┘   │                    │  openclaw tui   │
                         └──────────────────► └─────────────────┘
                                               All coordinate via
                                               ~/.clawteam/ (tasks, inboxes)

アーキテクチャ

  Human: "Optimize this LLM"
         │
         ▼
  ┌──────────────┐     clawteam spawn     ┌──────────────┐
  │  Leader      │ ──────────────────────► │  Worker      │
  │  (any agent) │ ──────┐                │  git worktree │
  │              │       ├──────────────► │  tmux window  │
  │  spawn       │       │                ├──────────────┤
  │  task create │       ├──────────────► │  Worker      │
  │  inbox send  │       │                │  git worktree │
  │  board show  │       └──────────────► │  tmux window  │
  └──────────────┘                        └──────────────┘
                                                 │
                                                 ▼
                                      ┌─────────────────────┐
                                      │    ~/.clawteam/     │
                                      │ ├── teams/   (who) │
                                      │ ├── tasks/   (what)│
                                      │ ├── inboxes/ (talk)│
                                      │ └── workspaces/    │
                                      └─────────────────────┘

すべてのステートは ~/.clawteam/ に JSON ファイルとして保存されます。データベースもサーバーも不要です。fcntl ファイルロックによるアトミック書き込みでクラッシュ安全性を確保しています。

コマンドリファレンス

# Team lifecycle
clawteam team spawn-team <team> -d "description" -n <leader>
clawteam team discover                    # List all teams
clawteam team status <team>               # Show members
clawteam team cleanup <team> --force      # Delete team

# Spawn agents
clawteam spawn --team <team> --agent-name <name> --task "do this"
clawteam spawn tmux codex --team <team> --agent-name <name> --task "do this"

# Task management
clawteam task create <team> "subject" -o <owner> --blocked-by <id1>,<id2>
clawteam task update <team> <id> --status completed   # auto-unblocks dependents
clawteam task list <team> --status blocked --owner worker1
clawteam task wait <team> --timeout 300

# Messaging
clawteam inbox send <team> <to> "message"
clawteam inbox broadcast <team> "message"
clawteam inbox receive <team>             # consume messages
clawteam inbox peek <team>                # read without consuming

# Monitoring
clawteam board show <team>                # terminal kanban
clawteam board live <team> --interval 3   # auto-refresh
clawteam board attach <team>              # tiled tmux view
clawteam board serve --port 8080          # web UI

# Workspace (git worktree management)
clawteam workspace list <team>
clawteam workspace checkpoint <team> <agent>    # auto-commit
clawteam workspace merge <team> <agent>         # merge back to main
clawteam workspace cleanup <team> <agent>       # remove worktree

# Plan approval
clawteam plan submit <team> <agent> "plan" --summary "TL;DR"
clawteam plan approve <team> <plan-id> <agent> --feedback "LGTM"
clawteam plan reject <team> <plan-id> <agent> --feedback "Revise X"

# Lifecycle
clawteam lifecycle request-shutdown <team> <agent> --reason "done"
clawteam lifecycle approve-shutdown <team> <request-id> <agent>
clawteam lifecycle idle <team>

# Templates
clawteam launch <template> --team <name> --goal "Build X"
clawteam template list

# Config
clawteam config show
clawteam config set transport p2p
clawteam config health

エージェントごとのモデル割り当て（プレビュー）

ブランチ: feat/per-agent-model-assignment

この機能は、別ブランチで早期テスト向けに公開されています。OpenClaw の --model フラグがリリースされ次第、main にマージされる予定です。

マルチエージェントスワームにおいて、コストとパフォーマンスのトレードオフを最適化するために、異なるエージェントロールに異なるモデルを割り当てます。

# Install from the feature branch
pip install -e "git+https://github.com/win4r/ClawTeam-OpenClaw.git@feat/per-agent-model-assignment#egg=clawteam"

テンプレートでのエージェントごとのモデル指定：

[template]
name = "my-team"
command = ["openclaw"]
model = "sonnet-4.6"              # default for all agents
model_strategy = "auto"           # or: leaders→strong, workers→balanced

[template.leader]
name = "lead"
model = "opus"                    # override for leader

[[template.agents]]
name = "worker"
model_tier = "cheap"              # cost tiers: strong / balanced / cheap

CLI フラグ：

clawteam spawn --model opus                          # single agent
clawteam launch my-template --model gpt-5.4          # override all agents
clawteam launch my-template --model-strategy auto     # auto-assign by role

詳細は issue #1 で機能リクエストとディスカッションを参照してください。

ロードマップ

コントリビューション

コントリビューションを歓迎します：

• エージェント統合 — より多くの CLI エージェントのサポート
• チームテンプレート — 新しいドメイン向けの TOML テンプレート
• トランスポートバックエンド — Redis、NATS など
• ダッシュボード改善 — Web UI、Grafana
• ドキュメント — チュートリアルとベストプラクティス

謝辞

• @karpathy/autoresearch — 自律型 ML 研究フレームワーク
• OpenClaw — デフォルトエージェントバックエンド
• Claude Code および Codex — 対応 AI コーディングエージェント
• ai-hedge-fund — ヘッジファンドテンプレートのインスピレーション
• CLI-Anything — 姉妹プロジェクト

ライセンス

MIT — 自由に使用、改変、再配布できます。