# [🚀观看我的哔哩哔哩视频](https://space.bilibili.com/3493277319825652)

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

🦞ClawTeam-OpenClaw

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

Upstream Quick Start License

Python Agents Transport Version

> **[HKUDS/ClawTeam](https://github.com/HKUDS/ClawTeam) のフォーク** — OpenClaw との深い統合を実現:デフォルトの `openclaw` エージェント、エージェントごとのセッション分離、実行承認の自動設定、本番環境対応のスポーンバックエンドを搭載。上流の修正はすべて同期されます。 目標を設定するだけ。エージェントスワームが残りを処理します — ワーカーの生成、タスクの分割、連携、結果の統合まですべて自動です。 [OpenClaw](https://openclaw.ai)(デフォルト)、[Claude Code](https://claude.ai/claude-code)、[Codex](https://openai.com/codex)、[nanobot](https://github.com/HKUDS/nanobot)、[Cursor](https://cursor.com)、およびあらゆる CLI エージェントで動作します。 --- ## なぜ ClawTeam なのか? 現在の AI エージェントは強力ですが、**孤立して**動作しています。ClawTeam を使えば、エージェントが自律的にチームを編成し、作業を分担し、コミュニケーションし、人間が細かく管理しなくても結果を収束させることができます。 | | ClawTeam | 他のマルチエージェントフレームワーク | |---|---------|----------------------------| | **使うのは誰か** | AI エージェント自身 | オーケストレーションコードを書く人間 | | **セットアップ** | `pip install` + プロンプト1つ | Docker、クラウド API、YAML 設定ファイル | | **インフラ** | ファイルシステム + tmux | Redis、メッセージキュー、データベース | | **エージェント対応** | あらゆる CLI エージェント | フレームワーク固有のみ | | **分離** | Git worktree(実ブランチ) | コンテナまたは仮想環境 | --- ## 仕組み
### エージェントがエージェントを生成 リーダーが `clawteam spawn` を呼び出してワーカーを作成します。各ワーカーは独自の **Git worktree**、**tmux ウィンドウ**、**アイデンティティ**を持ちます。 ```bash clawteam spawn --team my-team \ --agent-name worker1 \ --task "Implement auth module" ``` ### エージェント間の通信 ワーカーは受信箱を確認し、タスクを更新し、結果を報告します — すべてプロンプトに**自動注入**される CLI コマンドを通じて行われます。 ```bash clawteam task list my-team --owner me clawteam inbox send my-team leader \ "Auth done. All tests passing." ``` ### あなたは見守るだけ タイル表示の tmux ビューまたは Web UI からスワームを監視します。リーダーが連携を担当します。 ```bash 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: 手動で操作する ```bash # 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 ``` ### 対応エージェント | エージェント | スポーンコマンド | ステータス | |-------|--------------|--------| | [OpenClaw](https://openclaw.ai) | `clawteam spawn tmux openclaw --team ...` | **デフォルト** | | [Claude Code](https://claude.ai/claude-code) | `clawteam spawn tmux claude --team ...` | 完全対応 | | [Codex](https://openai.com/codex) | `clawteam spawn tmux codex --team ...` | 完全対応 | | [nanobot](https://github.com/HKUDS/nanobot) | `clawteam spawn tmux nanobot --team ...` | 完全対応 | | [Cursor](https://cursor.com) | `clawteam spawn subprocess cursor --team ...` | 実験的 | | カスタムスクリプト | `clawteam spawn subprocess python --team ...` | 完全対応 | --- ## インストール ### ステップ 1: 前提条件 ClawTeam には **Python 3.10+**、**tmux**、および少なくとも1つの CLI コーディングエージェント(OpenClaw、Claude Code、Codex など)が必要です。 **既にインストール済みのものを確認:** ```bash python3 --version # Need 3.10+ tmux -V # Need any version openclaw --version # Or: claude --version / codex --version ``` **不足している前提条件のインストール:** | ツール | macOS | Ubuntu/Debian | |------|-------|---------------| | Python 3.10+ | `brew install python@3.12` | `sudo apt update && sudo apt install python3 python3-pip` | | tmux | `brew install tmux` | `sudo apt install tmux` | | OpenClaw | `pip install openclaw` | `pip install openclaw` | > 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 からではなくローカルリポジトリからインストールします。** ```bash git clone https://github.com/win4r/ClawTeam-OpenClaw.git cd ClawTeam-OpenClaw pip install -e . # ← 必須!ローカルリポジトリからインストール。pip install clawteam とは異なります ``` オプション — P2P トランスポート(ZeroMQ): ```bash pip install -e ".[p2p]" ``` ### ステップ 3: ~/bin/clawteam シンボリックリンクの作成 生成されたエージェントは、pip の bin ディレクトリが PATH にない新しいシェルで実行されます。`~/bin` にシンボリックリンクを作成することで、`clawteam` が常に到達可能になります: ```bash mkdir -p ~/bin ln -sf "$(which clawteam)" ~/bin/clawteam ``` `which clawteam` が何も返さない場合は、バイナリを手動で見つけてください: ```bash # 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` に以下を追加してください: ```bash export PATH="$HOME/bin:$PATH" ``` ### ステップ 4: OpenClaw スキルのインストール(OpenClaw ユーザーのみ) スキルファイルは、OpenClaw エージェントに自然言語で ClawTeam の使い方を教えます。OpenClaw を使用していない場合は、このステップをスキップしてください。 ```bash mkdir -p ~/.openclaw/workspace/skills/clawteam cp skills/openclaw/SKILL.md ~/.openclaw/workspace/skills/clawteam/SKILL.md ``` ### ステップ 5: 実行承認の設定(OpenClaw ユーザーのみ) 生成された OpenClaw エージェントは、`clawteam` コマンドを実行するための許可が必要です。この設定がないと、エージェントがインタラクティブな許可プロンプトでブロックされます。 ```bash # 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: 動作確認 ```bash clawteam --version # Should print version clawteam config health # Should show all green ``` OpenClaw を使用している場合は、スキルが読み込まれていることも確認してください: ```bash openclaw skills list | grep clawteam ``` ### 自動インストーラー 上記のステップ 2〜6 は、単一のスクリプトでも実行できます: ```bash git clone https://github.com/win4r/ClawTeam-OpenClaw.git cd ClawTeam-OpenClaw bash scripts/install-openclaw.sh ``` ### トラブルシューティング | 問題 | 原因 | 解決方法 | |---------|-------|-----| | `clawteam: command not found` | pip の bin ディレクトリが PATH にない | ステップ 3(シンボリックリンク + PATH)を実行 | | 生成されたエージェントが `clawteam` を見つけられない | エージェントが pip の PATH なしの新しいシェルで実行される | `~/bin/clawteam` シンボリックリンクが存在し、`~/bin` が PATH にあることを確認 | | `openclaw approvals` が失敗する | ゲートウェイが起動していない | 先に `openclaw gateway` を起動してから、ステップ 5 をリトライ | | `exec-approvals.json not found` | OpenClaw が一度も実行されていない | `openclaw` を一度実行して設定を生成してから、ステップ 5 をリトライ | | エージェントが許可プロンプトでブロックされる | 実行承認のセキュリティが "full" になっている | ステップ 5 を実行して "allowlist" に切り替え | | `pip install -e .` が失敗する | ビルド依存関係が不足 | 先に `pip install hatchling` を実行 | | `clawteam --version` が "Coming Soon" と表示される | npm のスクワッティングパッケージを誤ってインストール(`a9logic`、本プロジェクトとは無関係) | `npm uninstall -g clawteam` を実行し、ステップ 2 に従って再インストール | --- ## ユースケース ### 1. 自律型 ML 研究 — 8 エージェント x 8 GPU [@karpathy/autoresearch](https://github.com/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](https://github.com/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 エージェント投資チームを生成します: ```bash clawteam launch hedge-fund --team fund1 --goal "Analyze AAPL, MSFT, NVDA for Q2 2026" ``` 5 人のアナリストエージェント(バリュー、グロース、テクニカル、ファンダメンタルズ、センチメント)が並行して作業します。リスクマネージャーがすべてのシグナルを統合します。ポートフォリオマネージャーが最終判断を下します。 テンプレートは TOML ファイルです — あらゆるドメインに合わせて**独自のテンプレートを作成**できます。 --- ## 機能
### エージェントの自己組織化 - リーダーがワーカーを生成・管理 - 自動注入される連携プロンプト — 手動セットアップ不要 - ワーカーが自動でステータスとアイドル状態を報告 - あらゆる CLI エージェントが参加可能 ### ワークスペース分離 - 各エージェントが独自の **Git worktree** を取得 - 並行エージェント間でマージコンフリクトなし - チェックポイント、マージ、クリーンアップコマンド - ブランチ命名規則: `clawteam/{team}/{agent}` ### 依存関係付きタスク管理 - 共有カンバン: `pending` → `in_progress` → `completed` / `blocked` - `--blocked-by` チェーンと完了時の自動アンブロック - `task wait` がすべてのタスク完了まで待機 ### エージェント間メッセージング - ポイントツーポイント受信箱(送信、受信、ピーク) - 全チームメンバーへのブロードキャスト - ファイルベース(デフォルト)または ZeroMQ P2P トランスポート ### モニタリングとダッシュボード - `board show` — ターミナルカンバン - `board live` — 自動更新ダッシュボード - `board attach` — タイル表示の tmux ビュー - `board serve` — リアルタイム更新の Web UI ### チームテンプレート - TOML ファイルでチームのアーキタイプを定義(ロール、タスク、プロンプト) - コマンド1つ: `clawteam launch