ClawTeam

ClawTeam マルチエージェント調整

ClawTeam は、複数の AI エージェントをチームとして調整する、フレームワークに依存しない CLI ツールです。 チーム／タスク管理、エージェント間メッセージング、Git ワークツリーによる分離、プロバイダーに応じたランタイムプロファイル、Git コンテキストの注入、スナップショット、ターミナルベースの監視ダッシュボードを提供します。

すべての操作は clawteam CLI を通じて実行します。データはデフォルトで ~/.clawteam/ に保存されます。

インストール

clawteam がすでに利用可能か確認します。

clawteam --version

コマンドが見つからない場合は、インストールして続行します。

pip install clawteam

Python 3.10 以降が必要です。P2P トランスポートをサポートするには、pip install "clawteam[p2p]" を実行します。

前提条件

• tmux がインストールされていること（デフォルトの起動バックエンド）
• claude、codex、gemini、kimi、nanobot、openclaw などの CLI コーディングエージェント
• ワークツリーによる分離とコンテキスト機能を利用するための Git リポジトリ
• TUI ウィザード（clawteam profile wizard）を利用する場合は、デフォルトの依存関係がインストールされていること

主な概念

チーム — リーダー 1 人と 0 人以上のワーカーで構成される、名前付きのエージェントグループです。

受信トレイ — エージェントごとのファイルベースのメッセージキューです。receive はメッセージを削除しますが、peek は削除しません。

タスク — pending、in_progress、completed、blocked の状態を持つ共有タスクボードです。 タスクは依存関係の連鎖と優先度に対応しています。

プロファイル — spawn と launch で使用する、再利用可能なクライアント／プロバイダー／ランタイム設定です。

プリセット — 1 つ以上のプロファイルの生成に使用する、共有プロバイダーテンプレートです。

コンテキスト — 重複チェック、最近の変更、プロンプトへの注入に使う、Git／ワークツリーを考慮したコンテキストツールです。

ボード — カンバンタスク、受信トレイの件数、メッセージ履歴のビューに加え、gource によるアクティビティの可視化を備えたチームダッシュボードです。

クイックスタート

タスクを含むチームを設定する

export CLAWTEAM_AGENT_ID="leader-001"
export CLAWTEAM_AGENT_NAME="leader"
export CLAWTEAM_AGENT_TYPE="leader"

clawteam team spawn-team my-team -d "Project team" -n leader
clawteam task create my-team "Design system" -o leader
clawteam task create my-team "Implement feature" -o worker1
clawteam task create my-team "Write tests" -o worker2
clawteam board show my-team

ランタイムプロファイルを設定する

# Inspect built-in provider templates
clawteam preset list
clawteam preset show moonshot-cn

# Generate a reusable profile from a preset
clawteam preset generate-profile moonshot-cn claude --name claude-kimi

# Or use the interactive TUI
clawteam profile wizard

# Claude Code on a fresh machine/home may need onboarding repair once
clawteam profile doctor claude

# Smoke-test the profile before using it in a team
MOONSHOT_API_KEY=... clawteam profile test claude-kimi

エージェントを起動して調整する

# Default path: tmux backend, claude command, git worktree isolation, skip-permissions on
clawteam spawn --team my-team --agent-name worker1 --task "Implement the auth module"
clawteam spawn --team my-team --agent-name worker2 --task "Write unit tests"

# Explicit backend and command
clawteam spawn tmux claude --team my-team --agent-name worker3 --task "Build API endpoints"
clawteam spawn subprocess claude --team my-team --agent-name worker4 --task "Run linting"

# Recommended for non-default providers/models
clawteam spawn tmux --profile claude-kimi --team my-team --agent-name worker5 --task "Build API endpoints"
clawteam spawn subprocess --profile gemini-vertex --team my-team --agent-name worker6 --task "Run linting"

clawteam board attach my-team
clawteam inbox send my-team worker1 "Start implementing the auth module"
clawteam board live my-team --interval 3

起動時のデフォルト設定

設定	デフォルト	上書き方法
バックエンド	tmux	clawteam spawn subprocess ...
コマンド	claude	clawteam spawn tmux my-cmd ...
ワークスペース	auto（Git ワークツリー）	--no-workspace または設定の workspace=never
権限	スキップ	--no-skip-permissions または設定の skip_permissions=false
ランタイムプロファイル	なし	--profile <name>

デフォルト以外のプロバイダー、モデル、エンドポイント、認証マッピングが必要な場合は、--profile を使用してください。

タスクのライフサイクル

# Create with dependencies
clawteam task create my-team "Deploy" --blocked-by <impl-task-id>,<test-task-id>

# Create with priority
clawteam task create my-team "Hotfix prod issue" --priority high

# Update status
clawteam task update my-team <task-id> --status in_progress
clawteam task update my-team <task-id> --status completed

# Filter tasks
clawteam task list my-team --status blocked
clawteam task list my-team --owner worker1
clawteam task list my-team --priority high

サブエージェントを待機する

clawteam task wait my-team
clawteam task wait my-team --timeout 300 --poll-interval 10
clawteam task wait my-team --agent coordinator
clawteam --json task wait my-team --timeout 600

ワーカーループのプロトコル

ワーカーは、最初の --task を完了した後も停止しないでください。想定されるループは次のとおりです。

# 1. Check tasks assigned to you
clawteam task list my-team --owner worker1

# 2. Finish any pending work, then check for new instructions
clawteam inbox receive my-team --agent worker1

# 3. If idle, notify the leader and keep monitoring for follow-ups
clawteam lifecycle idle my-team

リーダーがワーカーを明示的に終了するまで、このループを繰り返します。

Git コンテキストと競合チェック

clawteam context log my-team
clawteam context conflicts my-team
clawteam context inject my-team --agent worker1

作業の再割り当て、別のワーカーのタスクの継続、または重複する変更のマージを行う前に、これらを使用してください。

スナップショットと復旧

clawteam team snapshot my-team --tag before-refactor
clawteam team snapshots my-team
clawteam team restore my-team --snapshot before-refactor

アクティビティの可視化

clawteam board gource my-team --log-only
clawteam board gource my-team --live

ヘッドレス環境では --log-only の使用を推奨します。

対応している CLI エージェント

検証済みの一般的な CLI には、次のものがあります。

• claude
• codex
• gemini
• kimi
• nanobot
• openclaw

OpenClaw ワーカーの起動コマンドは自動的に正規化されます。openclaw のみのコマンドはエージェントのエントリーポイントに昇格され、必要に応じて --local、--session-id、--message が設定されます。

デフォルト以外のプロバイダーは、環境変数をプロンプトにハードコードするのではなく、profile と preset を通じて設定してください。

コマンドグループ

グループ	目的	主なコマンド
preset	共有プロバイダーテンプレート	list、show、generate-profile、bootstrap
profile	再利用可能なクライアント／プロバイダー設定	list、show、set、test、wizard、doctor
team	チームのライフサイクル	spawn-team、discover、status、request-join、approve-join、cleanup、snapshot、restore
inbox	メッセージング	send、broadcast、receive、peek、watch
task	タスク管理	create、get、update、list、wait
board	モニタリングと可視化	show、overview、live、attach、serve、gource
context	Git／worktree のコンテキスト	diff、files、conflicts、log、inject
plan	プランの承認	submit、approve、reject
lifecycle	エージェントのライフサイクル	request-shutdown、approve-shutdown、idle
spawn	プロセスの起動	spawn [backend] [command]
identity	ID 管理	show、set

JSON 出力

すべてのコマンドは、機械可読な出力を得るための --json に対応しています。サブコマンドの前にフラグを指定してください：

clawteam --json team discover
clawteam --json board show my-team
clawteam --json task list my-team --status pending

重要な注意事項

• inbox receive はメッセージを消費します。破壊的でない読み取りには inbox peek を使用してください。
• 作成時に --blocked-by を指定すると、タスクのステータスは自動的に blocked に設定されます。
• タスクを完了すると、そのタスクを blockedBy に指定しているタスクのブロックが自動的に解除されます。
• タスクは priority にも対応しています。緊急性の高いブロック解除タスクや本番環境の修正には high を使用してください。
• ワーカーは、最初のタスクの後もすぐに終了せず、タスクと受信トレイをポーリングし続けることが期待されています。
• clawteam spawn は、デフォルトで tmux、Git worktree による分離、権限チェックのスキップを使用します。
• clawteam launch も skip_permissions を尊重するため、テンプレートワーカーが承認プロンプトで停止しなくなります。
• すべてのファイル書き込みで、破損を防ぐために一時ファイルへの書き込みとリネームをアトミックに行います。
• clawteam spawn で起動する場合、ID 環境変数は自動的に設定されます。
• タイル表示の tmux レイアウトで全エージェントを監視するには、board attach <team> を使用してください。
• board show の JSON とブラウザ版ボードには、メンバーごとのエイリアスを含むメッセージ履歴が表示されるようになりました。受信トレイのトリアージや引き継ぎに便利です。
• デフォルト以外のプロバイダー／モデルには、プロバイダー環境変数を手動でエクスポートするのではなく、--profile を使用してください。
• profile は最終的なランタイムオブジェクトであり、preset はプロファイルを生成するための再利用可能なテンプレートです。
• 新しいマシンまたはホームディレクトリで Claude Code を使用する場合は、起動前に一度 clawteam profile doctor claude を実行してください。
• worktree をまたぐタスクを安全に引き継ぐには、context inject と context conflicts の使用を推奨します。

追加リソース

• references/cli-reference.md — コマンド、オプション、データモデルを含む CLI の完全なリファレンス
• references/workflows.md — マルチエージェントのワークフロー：セットアップ、起動の調整、参加プロトコル、プランの承認、正常なシャットダウン、モニタリングのパターン