ZeroClaw スキル

ユーザーの ZeroClaw エージェント インスタンスの操作をサポートしています。ZeroClaw は CLI と HTTP/WebSocket ゲートウェイを備えた自律型エージェント ランタイムです。

ユーザーが何をしたいのかを理解し、それを実行するのが仕事です。コマンドをコピー&ペーストするだけでなく、Bash ツール経由で実際に実行して結果を報告してください。唯一の例外は破壊的な操作（メモリ全体のクリア、緊急停止など）で、その場合は先に確認が必要です。

適応的な専門知識

ユーザーの話し方に注目してください。「webhook エンドポイントに POST でリクエストを送ってくれ」と言う人は、自分が何をしているか分かっている可能性が高いため、簡潔に説明を省いて実行してください。一方、「ボットに覚えさせるにはどうするの？」と言う人は、内部で何が起こっているかについてより多くのコンテキストが必要です。

技術的な習熟度の高さを示す兆候：特定のエンドポイント、HTTP メソッド、JSON フィールドを言及している、トークン/認証について話す、CLI フラグを流暢に使う、設定ファイルを直接参照している。

習熟度が低い兆候：「X は何をするのか」と聞く、ボット/エージェントについてカジュアルな言葉を使う、メカニズムではなく目標を説明する（「毎朝何かをチェックしてほしい」）。

デフォルトは中程度にしてください。実行予定の操作について簡潔に説明してから実行します。そこから、信号に基づいて調整してください。

発見 — 行動前に

ZeroClaw オペレーションを実行する前に、場所を把握してください。

1. バイナリを見つける。 以下の順序で検索してください：

   • which zeroclaw（PATH）
   • 現在のプロジェクトのビルド出力：./target/release/zeroclaw または ./target/debug/zeroclaw。ユーザーが ZeroClaw ソース ツリー内で作業していてローカルな変更がある場合、これが正しい選択肢です
   • よくあるインストール場所：~/.cargo/bin/zeroclaw、~/Downloads/zeroclaw-bin/zeroclaw

   バイナリが見つからない場合は、ソースからのビルドを提案してください（下記の「ソースからのビルド」を参照）。ZeroClaw 自体の開発者である場合は、ローカル ビルドを望む可能性が高いため、ソース ファイルを編集している、PR について言及している、プロジェクト ディレクトリにいるといった兆候に注目してください。

2. ゲートウェイが実行中かチェック（REST/WebSocket 操作のみ必要）。簡単な curl -sf http://127.0.0.1:42617/health で確認できます。実行中でなく、ユーザーが REST アクセスを望んでいる場合は、その旨を知らせて起動を提案してください（zeroclaw gateway または zeroclaw daemon）。

3. 認証ステータスをチェック。 ゲートウェイがペアリングを必須としている場合（require_pairing = true がデフォルト）、REST 呼び出しにはベアラー トークンが必要です。zeroclaw status を実行して現在の状態を確認するか、~/.zeroclaw/config.toml の [gateway] で保存されたトークンをチェックしてください。

この情報をこの会話内でキャッシュしてください。毎回再発見する必要はありません。

重要：REPL の制限事項

zeroclaw agent（対話型 REPL）は対話型 stdin が必要で、Bash ツール経由では機能しません。ユーザーがエージェントとチャットしたい場合、シングルメッセージ モードを使用してください：

zeroclaw agent -m "メッセージ"

各 -m 呼び出しは独立しており、呼び出し間の会話履歴はありません。ユーザーが複数ターンの会話が必要な場合は、ターミナルで直接 zeroclaw agent を実行するか、プログラムによるストリーミングに WebSocket エンドポイントを使用できることを知らせてください。

初回セットアップ

ユーザーがまだ ZeroClaw をセットアップしていない場合（~/.zeroclaw/config.toml が存在しない）、オンボーディングをガイドしてください：

zeroclaw onboard                          # クイック モード — OpenRouter へのデフォルト
zeroclaw onboard --provider anthropic     # Anthropic を直接使用
zeroclaw onboard                          # ガイド付きウィザード（デフォルト）

オンボーディング後、すべてが機能していることを確認してください：

zeroclaw status
zeroclaw doctor

既に設定があるが何か問題がある場合は、zeroclaw onboard --channels-only でチャネル設定のみを修復し、他をすべて上書きしないようにしてください。

ソースからのビルド

ユーザーが ZeroClaw をビルドしたい場合（またはバイナリがインストールされていない場合）：

cargo build --release

これにより target/release/zeroclaw が生成されます。開発中の反復が速い場合は、cargo build（デバッグ モード）の方が速いですが、target/debug/zeroclaw に遅いバイナリが生成されます。

別のビルド ステップなしに直接実行することもできます：

cargo run --release -- <サブコマンド> [引数]

ビルド前に、cargo check は完全なビルドなしに簡単なコンパイル検証を行います。

CLI と REST の選択

両方のインターフェースがほとんどのことができます。大まかな選択基準：

• CLI がシンプルなのは、ターミナルからのワンオフ操作用です。認証を内部で処理し、出力をきれいにフォーマットします。ユーザーがローカルで作業している場合は CLI を使用してください。
• REST が必要なのは、別の言語からの統合やスクリプト作成、またはリモート ZeroClaw インスタンスへのアクセスです。ストリーミング（WebSocket、SSE）にも必要です。
• 不明な場合は、CLI をデフォルトとしてください。セットアップが少ないです。

コア操作

メッセージの送信

CLI: zeroclaw agent -m "ここにメッセージを入力" — 素の zeroclaw agent ではなく、常に -m モードを使用することを忘れないでください。

REST:

curl -X POST http://127.0.0.1:42617/webhook \
  -H "Authorization: Bearer <トークン>" \
  -H "Content-Type: application/json" \
  -d '{"message": "ここにメッセージを入力"}'

レスポンス：{"response": "...", "model": "..."}

WebSocket（ストリーミング用）：ws://127.0.0.1:42617/ws/chat?token=<トークン> に接続し、{"type": "message", "content": "..."} を送信し、{"type": "done", "full_response": "..."} を受け取ります。

システム ステータス

zeroclaw status を実行してプロバイダー、モデル、アップタイム、チャネル、メモリ バックエンドを確認します。より詳しい診断：zeroclaw doctor。

REST: GET /api/status（zeroclaw status と同じ情報を JSON で）、GET /health（認証不要、簡単に OK/NG を確認）。

メモリ

CLI はメモリをリスト、取得、クリアできますが、直接保存することはできません。メモリを保存するには：

• エージェント経由：zeroclaw agent -m "私の好きな色は青だと覚えておいて"
• REST 経由：POST /api/memory で {"key": "...", "content": "...", "category": "core"}

CLI（読み取り/削除）：

• zeroclaw memory list — すべてのエントリをリスト
• zeroclaw memory list --category core --limit 10 — フィルター済み
• zeroclaw memory get "キー名" — 特定のエントリを取得
• zeroclaw memory stats — 使用統計
• zeroclaw memory clear --key "プレフィックス" --yes — エントリを削除（先にユーザーに確認）

REST（完全な CRUD）：

• GET /api/memory — すべてをリスト（オプション：?query=検索+テキスト&category=core）
• POST /api/memory — 保存：{"key": "...", "content": "...", "category": "core"}
• DELETE /api/memory/{key} — エントリを削除

カテゴリー：core、daily、conversation、またはカスタム文字列。

Cron / スケジューリング

CLI:

• zeroclaw cron list — すべてのジョブを表示
• zeroclaw cron add '0 9 * * 1-5' 'おはよう' --tz America/New_York — 繰り返し
• zeroclaw cron add-at '2026-03-11T10:00:00Z' 'リマインド' — 特定の時刻に 1 回
• zeroclaw cron add-every 3600000 'ヘルスチェック' — ミリ秒単位の間隔
• zeroclaw cron once 30m 'フォローアップ' — 今から何秒後
• zeroclaw cron pause <id> / zeroclaw cron resume <id> / zeroclaw cron remove <id>

REST:

• GET /api/cron — ジョブをリスト
• POST /api/cron — 追加：{"name": "...", "schedule": "0 9 * * *", "command": "..."}
• DELETE /api/cron/{id} — ジョブを削除

ツール

ツールは会話中にエージェントによって自動的に使用されます（シェル、ファイル操作、メモリ、ブラウザ、HTTP、Web 検索、git など — 30 以上のツールがセキュリティ ポリシーで制御）。

利用可能なもの確認：GET /api/tools（REST）はすべての登録済みツールと説明、パラメーター スキーマをリスト。

設定

~/.zeroclaw/config.toml を直接編集するか、zeroclaw onboard を再実行して再設定してください。

REST:

• GET /api/config — 現在の設定を取得（秘密は ***MASKED*** でマスク）
• PUT /api/config — 設定を更新（ボディとして raw TOML を送信、1MB 上限）

プロバイダーとモデル

• zeroclaw providers — サポートされているすべてのプロバイダーをリスト
• zeroclaw models list — キャッシュされたモデル カタログ
• zeroclaw models refresh --all — プロバイダーから更新
• zeroclaw models set anthropic/claude-sonnet-4-6 — デフォルト モデルを設定

メッセージごとにオーバーライド：zeroclaw agent -p anthropic --model claude-sonnet-4-6 -m "こんにちは"

リアルタイム イベント（SSE）

REST のみ — ダッシュボードやモニタリングの構築に便利：

curl -N -H "Authorization: Bearer <トークン>" http://127.0.0.1:42617/api/events

JSON イベントをストリーム：llm_request、tool_call_start、tool_call、agent_start、agent_end、error。

コスト追跡

GET /api/cost — セッション/日次/月次コスト、トークン数、モデル別の内訳を返します。

緊急停止

緊急停止コマンドを実行する前に必ずユーザーに確認してください。これは中断を伴います。

• zeroclaw estop --level kill-all — すべてを停止
• zeroclaw estop --level network-kill — すべてのネットワークをブロック
• zeroclaw estop --level tool-freeze --tool shell — 特定のツールをフリーズ
• zeroclaw estop status — 現在の緊急停止状態をチェック
• zeroclaw estop resume --network — 再開

ゲートウェイ ライフサイクル

• zeroclaw gateway — HTTP ゲートウェイを起動（フォアグラウンド）
• zeroclaw gateway -p 8080 --host 127.0.0.1 — カスタム バインド
• zeroclaw daemon — ゲートウェイ + チャネル + スケジューラー + ハートビートを起動
• zeroclaw service install/start/stop/status/uninstall — OS サービス管理

チャネル

ZeroClaw は 21 のメッセージ チャネルをサポートしています。追加するには ~/.zeroclaw/config.toml を編集する必要があります。たとえば、Telegram をセットアップするには：

[channels]
telegram = true

[channels_config.telegram]
bot_token = "BotFather から取得したボット トークン"
allowed_users = [123456789]

その後、デーモンを再起動します。zeroclaw channels doctor でチャネルのヘルスをチェックしてください。

チャネルの完全なリストと設定フィールドについては、references/cli-reference.md（チャネル セクション）を読んでください。

ペアリング（認証セットアップ）

require_pairing = true（デフォルト）の場合、REST クライアントにはベアラー トークンが必要です：

curl -X POST http://127.0.0.1:42617/pair -H "X-Pairing-Code: <コード>"

レスポンスは {"token": "..."} を含みます。後続のリクエストのために保存してください。

一般的なワークフロー

多段階シーケンスが必要になる可能性が高い例を示します：

「エージェントは正常に機能していますか？」

1. zeroclaw status を実行。プロバイダー、モデル、チャネルをチェック
2. zeroclaw doctor を実行。接続をチェック、問題を診断
3. ゲートウェイが必要な場合：curl -sf http://127.0.0.1:42617/health

「新しいチャネルをセットアップする」

1. 現在の設定を読む：cat ~/.zeroclaw/config.toml
2. チャネル設定を追加（TOML を編集）
3. 再起動：zeroclaw service restart（またはデーモンを手動で再起動）
4. 確認：zeroclaw channels doctor

「別のモデルに切り替える」

1. 利用可能な確認：zeroclaw models list
2. 設定：zeroclaw models set <プロバイダー/モデル>
3. 確認：zeroclaw status
4. テスト：zeroclaw agent -m "こんにちは、あなたはどのモデルですか？"

ゲートウェイ デフォルト

• ポート： 42617
• ホスト： 127.0.0.1
• 認証： ペアリング必須（ベアラー トークン）
• レート制限： 60 webhook リクエスト/分、10 ペアリング試行/分
• ボディ制限： 64KB（設定更新時 1MB）
• タイムアウト： 30 秒
• べき等性： /webhook 上のオプション X-Idempotency-Key ヘッダー（300 秒 TTL）
• 設定場所： ~/.zeroclaw/config.toml

リファレンス ファイル

すべてのエンドポイント、フィールド、エッジ ケースを含む完全な API 仕様については、references/rest-api.md を読んでください。

すべてのフラグとオプションを含む完全な CLI コマンド ツリーについては、references/cli-reference.md を読んでください。

このファイル内の情報を超えた正確な詳細が必要な場合にのみ読み込んでください。ほとんどのオペレーションでは、上記のクイック リファレンスで十分です。

トラブルシューティング

「zeroclaw: command not found」 — バイナリが PATH にありません。./target/release/zeroclaw、~/.cargo/bin/zeroclaw をチェックするか、cargo build --release でソースからビルドしてください。

REST 呼び出しで「Connection refused」 — ゲートウェイが実行されていません。zeroclaw gateway または zeroclaw daemon で起動してください。

「Unauthorized」（401/403） — ベアラー トークンが見つからないか無効です。ペアリング コードで POST /pair 経由で再ペアリングするか、~/.zeroclaw/config.toml で保存されたトークンをチェックしてください。

「LLM request failed」（500） — プロバイダーの問題。zeroclaw doctor を実行して接続をチェックしてください。一般的な原因：API キーの有効期限切れ、プロバイダーの障害、プロバイダー側のレート制限。

「Too many requests」（429） — ZeroClaw のレート制限に達しています。バックオフしてください。レスポンスには retry_after が含まれ、待機する秒数が示されます。

エージェントがツールを使用しない/制限付きで動作 — config.toml の [autonomy] 下の自律性設定をチェックしてください。level = "read_only" はほとんどのツールを無効にします。level = "supervised" または level = "full" を試してください。

メモリが永続化されない — [memory] の設定をチェックしてください。backend = "none" の場合、何も保存されません。"sqlite" または "markdown" に切り替えてください。auto_save = true も確認してください。

チャネルが応答しない — 特定のチャネルに対して zeroclaw channels doctor を実行してください。一般的な問題：ボット トークンの有効期限切れ、間違った allowed_users リスト、チャネルが [channels] で有効になっていない。

ユーザーの専門知識レベルに適切なコンテキストでエラーを報告してください。初心者の場合は、何が間違っていたのか、修正方法を説明してください。エキスパートの場合、エラーと修正方法だけを表示してください。