agent-swarm-skill — OpenClaw向けマルチエージェント編成スキル
概要
agent-swarm-skillは、OpenClaw向けに設計されたイベント駆動型のマルチエージェント編成スキルです。複数のAIコードエージェントを同じリポジトリで同時に実行する際の「誰が何をしたか」「どのトークンを使ったか」といった管理や、エージェント間の競合を防ぐための調整を自動化します。tmuxで各エージェントを独立セッションとして管理し、gitフックやOpenClawのイベントに応答してエージェントを起動/停止。トークン使用量の追跡、状態更新、Telegram通知などの運用機能も備えており、実運用を見据えた軽量なスキルとして利用できます(約300字)。
リポジトリの統計情報
- スター数: 2
- フォーク数: 0
- ウォッチャー数: 2
- コミット数: 2
- ファイル数: 10
- メインの言語: Shell
主な特徴
- tmuxを用いたエージェントごとのセッション分離と同時実行管理
- gitフックおよびイベント駆動での自動起動/オーケストレーション
- トークン自動追跡、ステータス更新、Telegram通知で運用性を強化
- CodexやClaude Codeなど複数モデルを混在させる設計に対応
技術的なポイント
本プロジェクトは「軽量な実運用向け」オーケストレーションに重点を置いています。主な技術要素は以下の通りです。
- tmuxベースのプロセス分離: 各AIエージェントはtmuxの個別ウィンドウ/セッションで実行され、ログの切り分けや再接続が容易です。これによりデバッグや長時間実行がしやすく、単一マシン上で複数の対話型エージェントを並列稼働させやすくなっています。
- イベント駆動のトリガー: git hooksやOpenClawからのイベントでエージェントを起動・停止します。これによりCI/CDのようにリポジトリの変更をきっかけに自動でエージェントが動き、手動操作を減らします。
- トークンとステータスの管理: 複数モデルを呼び出す際のAPIトークンやクレジット消費をスクリプトで追跡し、誰がどのトークンを使ってどの作業を行ったかを記録します。運用面では消費上限の検出やアラートの発行が重要で、Telegram通知を組み合わせて即時性のある運用監視を可能にしています。
- シェルスクリプト中心の設計: 依存を抑えたシンプルな実装で、導入が容易です。逆に言えばプロセス間通信や複雑なステート管理は標準化されたIPCやオーケストレーションプラットフォームほど高度ではないため、スケールや堅牢性を求める場面では追加の仕組み(コンテナ化、キュー制御、外部DBなど)の導入が望まれます。
- セキュリティと運用上の配慮: トークン管理やログ出力には注意が必要です。トークン自体はローカルの安全な場所に保管し、通知やログに直接出力しない設計が推奨されます。また、tmuxセッションの管理やプロセス回復に関する運用ルールも重要です。
総じて、agent-swarm-skillは「手軽に複数エージェントを協調させる」ことを主目的にしており、軽量ツール群とイベント駆動を組み合わせた実践的アプローチが取られています。将来的にはコンテナオーケストレーションや永続的ステート管理を組み合わせることで、より大規模なワークフローへ拡張可能です。(約700〜1000字程度)
プロジェクトの構成
主要なファイルとディレクトリ:
- .gitignore: file
- LICENSE: file
- README.md: file
- README.zh.md: file
- SKILL.md: file
…他 5 ファイル
まとめ
OpenClaw上での実用的なマルチエージェント運用を手早く試せる、軽量で運用重視のツール群です。(約50字)
リポジトリ情報:
- 名前: agent-swarm-skill
- 説明: Event-driven multi-agent coding orchestration for OpenClaw — dispatch Codex + Claude Code agents via tmux with automatic token tracking, status updates, and Telegram notifications
- スター数: 2
- 言語: Shell
- URL: https://github.com/ayao99315/agent-swarm-skill
- オーナー: ayao99315
- アバター: https://avatars.githubusercontent.com/u/225226537?v=4
READMEの抜粋:
agent-swarm-skill
Production-grade multi-agent coding orchestration for OpenClaw, powered by tmux, git hooks, and event-driven automation.
What is this?
agent-swarm-skill is an OpenClaw skill for running multiple AI coding agents against the same repository without turning coordination into manual overhea…