資料一覧 / claw-code

Claw Code

ultraworkers/claw-code で公開されている claw CLI の Rust 実装。正規のソースは rust/ ワークスペース。Python の src/ は参照・監査用のコンパニオン。

1 — 概要
What is Claw Code

公開 Rust CLI エージェントハーネス

Claw Code は claw CLI エージェントハーネスの公開 Rust 実装です。最初の手順は公式 USAGE.md。ビルド後は claw doctor を健診の起点にします。

設計思想や運用の枠組みは PHILOSOPHY.md、移植状況は PARITY.md、コンテナ運用は docs/container.md を参照してください。

🦀
Rust ワークスペース
rust/ 配下に CLI と複数クレート
🔧
バイナリ名: claw
デフォルトモデル: claude-opus-4-6
🚀
UltraWorkers エコシステム
Discord チャンネルから操作可
リポジトリ構成
パス役割
rust/正規 Rust ワークスペースと claw CLI バイナリ
USAGE.mdタスク指向の使い方ガイド（最初に読む）
PARITY.mdRust 移植のパリティ状況とマイグレーションノート
ROADMAP.mdアクティブなロードマップとバックログ
PHILOSOPHY.mdプロジェクトの意図とシステム設計の考え方
src/ + tests/Python/参照ワークスペース（メイン実行面ではない）
docs/container.mdコンテナファーストの build/run ワークフロー
2 — インストールの注意
crates.io とビルド方針
避ける: cargo install claw-code は使わない。crates.io の claw-code クレートは非推奨のスタブで、claw-code-deprecated 相当のバイナリしか置かず、本リポジトリの claw ではありません。

代わりに、このリポジトリからソースビルドするか、上流の cargo install agent-code（インストール名は agent / Windows は agent.exe）を公式 README の案内に従ってください。

ACP / Zed: 現時点で ACP/Zed デーモン用のエントリポイントは同梱されていません。状態確認は claw acp（または claw --acp）。claw acp serve は発見用エイリアスに留まる点は ROADMAP.md 側の記述に従ってください。
3 — 哲学
人間が方向を示し、claws が実行する
"The real thing worth studying is the system that produced them: a clawhip-based coordination loop where humans give direction and autonomous claws execute the work."

ボトルネックの変化

エージェントシステムがコードベースを数時間で再構築できる今、希少資源はタイピング速度ではなくなった。

  • アーキテクチャの明確さ
  • タスク分解
  • 判断力・審美眼
  • 何を作る価値があるかの確信

ヒューマンインターフェースは Discord

tmux・Vim・SSH ではなく Discord チャンネルが本当のヒューマンインターフェース。

人はスマートフォンから一文を送り、その場を離れられる。claws がタスクを分解し、ロールを割り当て、コードを書き、テストし、完成すれば push する。

4 — 3層システム
アーキテクチャ概要

エコシステム上の位置づけの概略図。詳細は公式の PHILOSOPHY.md および各リポジトリの README を参照。

graph LR Human["👤 Human\n(Discord / chat)"] -->|directive| OmX subgraph Coord ["調整・実行レイヤー"] OmX["OmX\noh-my-codex\nワークフローレイヤー"] -->|task execution| Claw["🦞 claw\nCLI エージェント"] OmO["OmO\noh-my-openagent\nマルチエージェント調整"] -->|handoff| Claw Claw -->|events| clawhip["clawhip\nイベント & 通知ルーター"] end clawhip -->|channel delivery| Discord["Discord\n結果通知"] clawhip -->|git / PR events| GitHub["GitHub"]
⚙️

OmX oh-my-codex

ワークフローレイヤー。短い指示を構造化実行に変換する。

  • 計画キーワード
  • 実行モード
  • 永続的な検証ループ
  • 並行マルチエージェントワークフロー
🔔

clawhip

イベント & 通知ルーター。監視・配信をエージェントのコンテキストウィンドウの外に置く。

  • git コミット
  • tmux セッション
  • GitHub issues / PR
  • エージェントライフサイクルイベント
🤝

OmO oh-my-openagent

マルチエージェント調整。計画・ハンドオフ・不一致の解消・検証ループを担う。

  • Architect / Executor / Reviewer 間の調整
  • ループが収束する構造を提供
5 — Rust ワークスペース
クイックスタート（README 準拠） 
# 1. クローンしてビルド
git clone https://github.com/ultraworkers/claw-code
cd claw-code/rust
cargo build --workspace

# 2. API キー（Anthropic の API キー。Claude サブスクのログインではない）
export ANTHROPIC_API_KEY="sk-ant-..."

# 3. 健診
./target/debug/claw doctor

# 4. ワンショットプロンプト
./target/debug/claw prompt "say hello"

Windows PowerShell では .\target\debug\claw.exe を使う。詳細は公式 USAGE.md の Windows 節を参照。

認証: claw は API キー（ANTHROPIC_API_KEY や OPENAI_API_KEY など）を想定。Claude のサブスクリプションログインだけでは動かない旨は公式 README に記載があります。
9クレートの構成
クレート責務
apiプロバイダクライアント・SSE ストリーミング・認証（API キー / OAuth）・コンテキストウィンドウプリフライト
commandsスラッシュコマンド定義・パース・ヘルプテキスト生成・JSON/テキストレンダリング
compat-harness上流 TS ソースからツール/プロンプトマニフェストを抽出するハーネス
mock-anthropic-service決定論的な /v1/messages モック（CLI パリティテスト用）
pluginsプラグインメタデータ・install/enable/disable/update フロー・フック統合
runtimeConversationRuntime・設定読み込み・セッション永続化・権限ポリシー・MCP クライアント
rusty-claude-cliREPL・ワンショットプロンプト・直接 CLI サブコマンド・ストリーミング表示・引数パース
telemetryセッショントレースイベントとテレメトリペイロード
toolsツール仕様 & 実行（Bash, Read/Write/Edit File, Glob, Grep, WebSearch, WebFetch, Agent, Todo...）
実装済み機能マトリクス
機能状態
Anthropic / OpenAI 互換プロバイダ + ストリーミング✅ 完了
OAuth ログイン/ログアウト✅ 完了
インタラクティブ REPL (rustyline)✅ 完了
ツールシステム (bash, read, write, edit, grep, glob)✅ 完了
Web ツール (search, fetch)✅ 完了
サブエージェント / エージェントサーフェス✅ 完了
セッション永続化 + レジューム✅ 完了
MCP サーバーライフサイクル + 検査✅ 完了
権限システム (read-only / workspace-write / danger-full-access)✅ 完了
プラグイン管理サーフェス✅ 完了
スキルインベントリ / インストール✅ 完了
機械可読 JSON 出力 (全 CLI サーフェス)✅ 完了
6 — CLI / REPL
モデルエイリアスと権限モード

モデルエイリアス

エイリアス解決先
opusclaude-opus-4-6
sonnetclaude-sonnet-4-6
haikuclaude-haiku-4-5-20251213

権限モード

read-only — 読み取りのみ
workspace-write — ワークスペース書き込み可
danger-full-access — フルアクセス（デフォルト）
トップレベルコマンド
prompt
status
sandbox
doctor
agents
mcp
skills
system-prompt
login / logout
init
bootstrap-plan
dump-manifests
REPL スラッシュコマンド（主要）

セッション / 可視性

/help
/status
/cost
/session
/doctor
/context

Git / ワークスペース

/diff
/commit
/pr
/branch
/memory
/hooks

エージェント / プラグイン

/agents
/subagent
/skills
/plugin
/mcp
/team

分析 / レビュー

/review
/insights
/security-review
/telemetry
/cron
セッション管理 & 設定ファイル

セッション操作

# セッション再開
./target/debug/claw --resume latest
./target/debug/claw --resume latest /status /diff

# セッション保存先
.claw/sessions/

設定ファイルの解決順序

  1. ~/.claw.json
  2. ~/.config/claw/settings.json
  3. <repo>/.claw.json
  4. <repo>/.claw/settings.json
  5. <repo>/.claw/settings.local.json

後のエントリが前のエントリを上書きします。

7 — ロードマップ
"Clawable" な実行ランタイムへ

主要ユーザーはフック・プラグイン・セッション・チャンネルイベント経由で接続されたclaws。人間ファーストの端末の仮定を排除し、機械可読性を向上させる。

1

Reliable Worker Boot

ワーカーの ready-handshake ライフサイクル、trust プロンプト自動解決、構造化セッション制御 API

2

Event-Native Clawhip Integration

型付きレーンイベントスキーマ（lane.started 〜 lane.failed）、失敗タクソノミー、アクショナブルサマリー圧縮

3

Branch/Test Awareness & Auto-Recovery

ステールブランチ検出、一般的な失敗からの自動回復レシピ、グリーンレベルコントラクト

4

Claws-First Task Execution

構造化タスクパケット形式、自律コーディング用ポリシーエンジン、claw ネイティブダッシュボード / レーンボード

5

Plugin & MCP Lifecycle Maturity

ファーストクラスのプラグイン/MCP ライフサイクルコントラクト、degraded-startup 構造化レポート、エンドツーエンドパリティ

MVP 成功基準
  • claw がワーカーを起動し、準備完了を確実に知れる
  • claws がタスクを誤ってシェルに入力しなくなる
  • ステールブランチの失敗がデバッグ時間を無駄にする前に特定される
  • clawhip が機械的状態を報告する（tmux prose ではなく）
  • MCP/プラグインの起動失敗が分類・表面化される
  • コーディングレーンが人間の監視なしに一般的な起動・ブランチ問題から自己回復できる
GitHub: ultraworkers/claw-code → UltraWorkers Discord

本リポジトリは Claude Code の元ソースの所有を主張せず、Anthropic との非提携・非推奨である旨は公式 README に明記されています。