Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

zeroclaw のコマンドラインヘルプ

このドキュメントには、zeroclaw コマンドラインプログラムのヘルプコンテンツが含まれています。

コマンド概要:

zeroclaw

最速で最小のAIアシスタント。

使用方法: zeroclaw [OPTIONS] <COMMAND>

サブコマンド:

  • quickstart — クイックスタート — 動作するエージェントを1つ、エンドツーエンドで作成します。セクションごとのオンボーディングフローを、プリセット駆動の単一パスに置き換えます。インタラクティブ: 以下のフラグはチェックリストのセレクターに事前入力されますが、スキップはされません。ターミナルが必要です
  • onboard — 非推奨です。zeroclaw quickstart を使用してください。すべてのフラグはエラーになります
  • agent — AIエージェントループを開始します
  • gateway — ゲートウェイサーバーを開始/管理します (ウェブフック、ウェブソケット)
  • acp — stdio上でACP (Agent Control Protocol) サーバーを開始します
  • daemon — 長時間実行される自律ランタイムを開始します (ゲートウェイ + チャネル + ハートビート + スケジューラ)
  • service — OSサービスライフサイクルを管理します (launchd/systemd ユーザーサービス)
  • doctor — デーモン/スケジューラ/チャネルの新鮮さについて診断を実行します
  • status — システムステータスを表示します (詳細情報)
  • estop —
  • cron — スケジュールされたタスクを構成および管理します
  • models — モデルプロバイダーのモデルカタログを管理
  • providers — プロバイダーのエイリアス CRUD ([providers.<category>.<family>.<alias>])。category は models、tts、transcription のいずれかです
  • channel — チャネルを管理します (telegram、discord、slack)
  • agents — エージェントエイリアスを管理します（作成/一覧表示/名前変更/削除）。エージェントを実行する agent とは異なります
  • channels — チャンネルエイリアスを管理（作成/一覧/名前変更/削除）
  • integrations — 50以上のインテグレーションを閲覧します
  • skills — スキルを管理します (ユーザー定義機能)
  • browse — 共有ワークスペースをディレクトリごとに 1 つずつ閲覧する
  • sop — 標準運用手順 (SOP) を管理します
  • migrate — 他のエージェントランタイムからデータを移行します
  • auth — model_providerサブスクリプションの認証プロファイルを管理する
  • hardware — USBハードウェアを検出および調査します
  • peripheral — ハードウェアペリフェラルを管理します (STM32、RPi GPIO など)
  • memory — エージェントメモリを管理します (一覧表示、取得、統計、クリア)
  • config — 構成を管理します
  • update — 更新を確認して適用します
  • self-test — 診断自己テストを実行します
  • completions — シェル補完スクリプトを標準出力に生成します
  • desktop — 連携するデスクトップアプリを起動するか、ダウンロードページを開きます
  • locales — アップストリームから翻訳済みロケールファイル（FTL）を取得します

オプション:

  • --config-dir <CONFIG_DIR>

  • --log-level <LOG_LEVEL> — ランタイムトレース（およびキャプチャレイヤー）に記録される最低重大度。プロセス内では不変です。優先順位：このフラグ > RUST_LOG 環境変数 > コマンドごとのデフォルト

    使用可能な値: error、warn、info、debug、trace

  • -v、--verbose — 記録されたログをターミナルに表示します。デフォルトではオフ：ログはトレースファイルにのみ出力され、ターミナルにはコマンドの出力のみが表示されます。オンの場合、ターミナルには記録された下限までのイベントが表示されます。プロセスに対して不変です

zeroclaw quickstart

クイックスタート — 動作するエージェントを1つ、最初から最後まで作成します。セクションごとのオンボーディングフローを、プリセット駆動の単一パスに置き換えます。インタラクティブ: 以下のフラグはチェックリストのセレクターを事前選択しますが、スキップはしません。ターミナルが必要です

使用法: zeroclaw quickstart [OPTIONS]

オプション:

  • --model-provider <MODEL_PROVIDER> — プロバイダーの種類（anthropic / openai / openrouter / ollama）
  • --model <MODEL> — 新しいプロバイダーエントリのモデル ID
  • --api-key <API_KEY> — 新しいプロバイダーエントリの API キー（ollama / ローカルの場合は省略）
  • --agent <AGENT> — 新しいエージェントのエイリアス。デフォルトはサニタイズされたプロバイダー名

zeroclaw onboard

非推奨。zeroclaw quickstart を使用してください。フラグはすべてエラーになります

使用法: zeroclaw onboard [COMMAND]

サブコマンド:

  • providers.models — 設定するモデルプロバイダー（Anthropic、OpenAI、OpenRouter、Ollama、カスタムのOpenAI互換ゲートウェイなど）を選択します。プロバイダーごとに複数のエイリアスがサポートされています。例えば、anthropic.production と anthropic.dev を共存させることができます
  • model_routes — 名前付きのモデルルーティングヒント（例: reasoning、fast、code）。各ルートはヒントを特定のプロバイダー + モデルの組み合わせにマッピングします。ルート経由でディスパッチするには、モデルパラメーターとして hint:<name> を使用します
  • embedding_routes — 名前付き埋め込みルーティングヒント（例: semantic、archive、faq）。各ルートはヒントを埋め込み対応のプロバイダー + モデルの組み合わせにマッピングします。embedding_model パラメーターとして hint:<name> を使用してください
  • risk_profiles — 許可リスト、拒否リスト、承認しきい値を結び付ける名前付きのリスクプロファイル。エージェントは agents.<alias>.risk_profile を介して1つを参照します
  • runtime_profiles — 名前付きのランタイムチューニングプロファイル（トークン上限、リトライポリシー、タイムアウト）。エージェントは agents.<alias>.runtime_profile を通じて1つを参照します
  • storage — SQLite はシングルノードインストールにおける安全な既定値です（ファイルベース、設定不要、追加サービス不要）。共有環境やマルチインスタンスのデプロイには Postgres、ベクトル検索には Qdrant、人間が読みやすいファイルには Markdown または Lucid を選択してください。各バックエンドは複数のエイリアスインスタンスをサポートしており、エージェントは memory.storage_ref を介してそれらを参照します
  • memory — 永続メモリバックエンド。デフォルトは SQLite です。長期的な記憶を完全に無効にするには none を選択してください
  • skills — Skills ツールの設定 — スキルの markdown がディスク上のどこに保存されるか（デフォルトはデータディレクトリ）、およびスキルローダーがコミュニティリポジトリをどのように扱うか。スキルの BUNDLES は以下の skill-bundles に追加してください
  • skill_bundles — スキルファイルの名前付きバンドル。エージェントはバンドルを参照して、起動時に一連の機能を読み込みます
  • mcp — Model Context Protocol の設定。enabled の切り替えと、遅延読み込みまたは事前読み込みを選択できます。個々の MCP サーバーは mcp.servers[] 配下で管理されます
  • mcp.servers — 個々のModel Context Protocolサーバー。各エントリは、トランスポート（stdio、http、sse）、接続先のコマンドまたはURL、オプションのヘッダー、および tool_timeout_secs の上限（≤ 600）をバインドします。各サーバーの name はアドレス指定可能なキーです。フィールドを直接編集するのではなく、セクションページから名前を変更してください。サーバーは以下の mcp_bundles でバンドルにグループ化できます
  • mcp_bundles — MCP サーバーの名前付きバンドルで、mcp_bundles にそのバンドルを列挙したエージェントに付与されます。デフォルトで安全: エージェントは自身のバンドルが付与するサーバーのみを取得し、バンドルがなければ MCP サーバーは取得しません
  • knowledge_bundles — 名前付きのナレッジソースのバンドル（RAGインデックス、ドキュメントフォルダー）。エージェントはバンドルを参照して、推論時に関連するスニペットを表示します
  • providers.tts — テキスト読み上げプロバイダー（OpenAI、ElevenLabs、Google、Edge、Piper）。音声／言語ごとに1つ設定します。エージェントはエイリアスで参照します
  • providers.transcription — 音声テキスト変換プロバイダー（OpenAI Whisper、Groq、Deepgram、AssemblyAI、Google、ローカル Whisper）。パイプラインごとに 1 つ設定し、エージェントはエイリアスで参照します
  • channels — ZeroClaw がリッスンするチャットプラットフォームを選択します。グローバルなチャンネル設定は [channels] に定義されます。設定された各プラットフォームは、引き続き独自のエイリアスを持ちます
  • hardware — オプション: ハードウェア周辺機器（Arduino、STM32、GPIO など）。不要な場合はスキップしてください
  • agents — エージェントは、モデルプロバイダー、プロファイル、バンドル、チャネルを1つのディスパッチ可能なユニットにまとめます。ペルソナごとに1つ追加します。同じエイリアスを複数のチャネルで再利用すると状態を共有できます
  • peer_groups — チャネル、メンバーエージェント、外部ピアを結びつける名前付きグループ。相互オプトイン: 2つのエージェントは、両方が同じグループの agents リストに含まれる場合にのみピアとなります
  • cron — スケジュールされたタスク。各 cron エントリは、スケジュール式をプロンプト、チャンネル、ターゲットに紐付けます
  • tunnel — オプション: Cloudflare または ngrok 経由でゲートウェイをパブリックインターネットに公開します。localhost のみに限定する場合は none を選択してください
  • onboard_state — クイックスタートのライフサイクル状態です。quickstart_completed は、クイックスタートが正常に実行を完了すると true に切り替わります。false の間、Web ゲートウェイと TUI は起動時にクイックスタートを自動起動します。completed_sections は、以前のデータとの後方互換性のために保持されている、セクションごとの従来の記録台帳です。

zeroclaw onboard providers.models

設定するモデルプロバイダーを選択してください（Anthropic、OpenAI、OpenRouter、Ollama、カスタムOpenAI互換ゲートウェイなど）。プロバイダーごとに複数のエイリアスがサポートされています — 例えば anthropic.production と anthropic.dev を共存させることができます

使用法: zeroclaw onboard providers.models

zeroclaw onboard model_routes

名前付きモデルルーティングヒント（例: reasoning、fast、code）。各ルートはヒントを特定のプロバイダー + モデルの組み合わせにマッピングします。ルート経由でディスパッチするには、モデルパラメーターとして hint:<name> を使用します。

使用方法: zeroclaw onboard model_routes

zeroclaw onboard embedding_routes

名前付き埋め込みルーティングヒント（例: semantic、archive、faq）。各ルートはヒントを埋め込み対応のプロバイダー + モデルの組み合わせにマッピングします。embedding_model パラメーターとして hint:<name> を使用します。

使い方: zeroclaw onboard embedding_routes

zeroclaw onboard risk_profiles

許可リスト、拒否リスト、承認しきい値を紐づける名前付きリスクプロファイル。エージェントは agents.<alias>.risk_profile を介して参照します

使用法: zeroclaw onboard risk_profiles

zeroclaw onboard runtime_profiles

名前付きランタイムチューニングプロファイル（トークン上限、リトライポリシー、タイムアウト）。エージェントは agents.<alias>.runtime_profile を介して参照します

使用法: zeroclaw onboard runtime_profiles

zeroclaw onboard storage

SQLiteは、シングルノードインストールにおける安全なデフォルトです（ファイルベース、設定不要、追加サービス不要）。共有環境やマルチインスタンス環境のデプロイにはPostgres、ベクトル検索にはQdrant、人間が読みやすいファイルにはMarkdownまたはLucidを選択してください。各バックエンドは、エイリアス付きの複数インスタンスをサポートしています。エージェントはmemory.storage_refを介してそれらを参照します

使用方法: zeroclaw onboard storage

zeroclaw onboard memory

永続メモリのバックエンド。デフォルトは SQLite です。長期記憶を完全に無効にするには none を選択してください

使用法: zeroclaw onboard memory

zeroclaw onboard skills

スキルツールの設定 — スキルの Markdown がディスク上のどこに保存されるか（デフォルトはデータディレクトリ）、およびスキルローダーがコミュニティリポジトリをどのように処理するか。スキルバンドルは以下の skill-bundles の下に追加してください

使い方: zeroclaw onboard skills

zeroclaw onboard skill_bundles

スキルファイルの名前付きバンドル。エージェントは起動時にバンドルを参照して一連の機能を読み込みます

使用法: zeroclaw onboard skill_bundles

zeroclaw onboard mcp

Model Context Protocol の設定。enabled を切り替えて、遅延読み込みまたは即時読み込みを選択します。個々の MCP サーバーは mcp.servers[] の配下にあります

使用法: zeroclaw onboard mcp

zeroclaw onboard mcp.servers

個々の Model Context Protocol サーバー。各エントリは、トランスポート（stdio、http、sse）、それに到達するためのコマンドまたは URL、オプションのヘッダー、および tool_timeout_secs の上限（≤ 600）をバインドします。各サーバーの name はそのアドレス指定可能なキーです — フィールドを直接編集するのではなく、セクションページから名前を変更してください。サーバーは、以下の mcp_bundles でバンドルにグループ化します

使用法: zeroclaw onboard mcp.servers

zeroclaw onboard mcp_bundles

MCP サーバーの名前付きバンドル。mcp_bundles にそのバンドルをリストしたエージェントに付与されます。デフォルトでセキュア: エージェントは、そのバンドルが付与するサーバーのみを取得し、バンドルがない場合は MCP サーバーを取得しません

使用方法: zeroclaw onboard mcp_bundles

zeroclaw onboard knowledge_bundles

ナレッジソース（RAG インデックス、ドキュメントフォルダ）の名前付きバンドル。エージェントはバンドルを参照して、推論時に関連するスニペットを表示します

使用法: zeroclaw onboard knowledge_bundles

zeroclaw onboard providers.tts

音声合成プロバイダー（OpenAI、ElevenLabs、Google、Edge、Piper）。音声・言語ごとに1つ設定し、エージェントはエイリアスで参照します

使用方法: zeroclaw onboard providers.tts

zeroclaw onboard providers.transcription

音声テキスト変換プロバイダー (OpenAI Whisper、Groq、Deepgram、AssemblyAI、Google、ローカル Whisper)。パイプラインごとに 1 つ構成し、エージェントはエイリアスで参照します

使用方法: zeroclaw onboard providers.transcription

zeroclaw onboard channels

ZeroClaw がリッスンするチャットプラットフォームを選択します。グローバルなチャンネル設定は [channels] に配置されます。設定された各プラットフォームには、それぞれ独自のエイリアスが割り当てられます

使い方: zeroclaw onboard channels

zeroclaw onboard hardware

任意: ハードウェアペリフェラル（Arduino、STM32、GPIO など）。不要な場合はスキップしてください

使用法: zeroclaw onboard hardware

zeroclaw onboard agents

エージェントは、モデルプロバイダー、プロファイル、バンドル、チャネルを1つのディスパッチ可能なユニットに束ねます。ペルソナごとに1つ追加し、状態を共有するにはチャネル間で同じエイリアスを再利用してください

使用法: zeroclaw onboard agents

zeroclaw onboard peer_groups

チャネル、メンバーエージェント、外部ピアを結び付ける名前付きグループです。相互オプトイン方式：2つのエージェントは、両方が同じグループの agents リストに含まれている場合にのみピアとなります。

使用法: zeroclaw onboard peer_groups

zeroclaw onboard cron

スケジュールされたタスク。各 cron エントリは、スケジュール式をプロンプト、チャンネル、ターゲットに紐付けます

使用方法: zeroclaw onboard cron

zeroclaw onboard tunnel

任意: Cloudflare または ngrok を介してゲートウェイをパブリックインターネットに公開します。localhost のみに制限するには none を選択してください

使用法: zeroclaw onboard tunnel

zeroclaw onboard onboard_state

クイックスタートのライフサイクル状態。quickstart_completed は、クイックスタートが正常に完了すると true に切り替わります。false の間は、Web ゲートウェイと TUI が起動時にクイックスタートを自動的に起動します。completed_sections は、以前のデータとの後方互換性のために保持されているレガシーなセクション単位の台帳です

使用法: zeroclaw onboard onboard_state

zeroclaw agent

AIエージェントループを開始します。

設定された AI model_provider との対話型チャットセッションを開始します。対話モードに入らずに単発のクエリを実行するには --message を使用してください。

Examples: zeroclaw agent -a assistant # interactive session zeroclaw agent -a assistant -m “Summarize today’s logs” # single message zeroclaw agent -a assistant -p anthropic –model claude-sonnet-4-20250514 zeroclaw agent -a assistant –peripheral nucleo-f401re:/dev/ttyACM0

使用法: zeroclaw agent [OPTIONS] --agent <AGENT>

オプション:

  • -a, --agent <AGENT> — 実行するエージェントのエイリアス（[agents.<alias>] と一致する必要があります）。必須 — デフォルトのエージェントはありません
  • -m, --message <MESSAGE> — シングルメッセージモード（インタラクティブモードに入らない）
  • --session-state-file <SESSION_STATE_FILE> — このJSONファイルでインタラクティブセッション状態を読み込んで保存します
  • -p, --model-provider <MODEL_PROVIDER> — 使用するモデルプロバイダー (openrouter, anthropic, openai, openai-codex)
  • --model <MODEL> — 使用するモデル
  • -t, --temperature <TEMPERATURE> — 温度（0.0 - 2.0、デフォルトは providers.models.<type>.<alias>.temperature）
  • --peripheral <PERIPHERAL> — ペリフェラルを接続（board:path、例：nucleo-f401re:/dev/ttyACM0）

zeroclaw gateway

ゲートウェイサーバーを管理します（ウェブフック、ウェブソケット）。

着信ウェブフックイベントとWebSocketコネクションを受け入れるHTTP/WebSocketゲートウェイを開始、再起動、または検査します。

例: zeroclaw gateway start # ゲートウェイを開始 zeroclaw gateway restart # ゲートウェイを再起動 zeroclaw gateway get-paircode # ペアリングコードを表示

使用方法: zeroclaw gateway [COMMAND]

サブコマンド:

  • start — ゲートウェイサーバーを開始（サブコマンドが指定されていない場合はデフォルト）
  • restart — ゲートウェイサーバーを再起動
  • get-paircode — 再起動せずにペアリングコードを表示または生成

zeroclaw gateway start

ゲートウェイサーバーを開始します（ウェブフック、ウェブソケット）。

着信ウェブフックイベントとWebSocketコネクションを受け入れるHTTP/WebSocketゲートウェイを実行します。バインドアドレスはデフォルトでお客様の設定ファイル（gateway.host / gateway.port）の値になります。

例: zeroclaw gateway start # 設定のデフォルトを使用 zeroclaw gateway start -p 8080 # ポート8080でリッスン zeroclaw gateway start –host 0.0.0.0 # [gateway].allow_public_bind=trueが必要、またはトンネルが必要 zeroclaw gateway start -p 0 # ランダムに利用可能なポート

使用方法: zeroclaw gateway start [OPTIONS]

オプション:

  • -p, --port <PORT> — リッスンするポート（ランダムに利用可能なポートの場合は0）。デフォルトはconfig gateway.port
  • --host <HOST> — バインドするホスト。デフォルトはconfig gateway.host 注：0.0.0.0へのバインドにはconfig内のgateway.allow_public_bind = trueが必要です
  • --allow-degraded-security — 読み込み中にセキュリティ上重要な設定セクションが既定値に戻された場合（セキュリティ態勢が弱化した状態）でも起動します。既定では無効です

zeroclaw gateway restart

ゲートウェイサーバーを再起動します。

実行中のゲートウェイを停止し、現在の設定で新しいインスタンスを開始します。

例: zeroclaw gateway restart # 設定のデフォルトで再起動 zeroclaw gateway restart -p 8080 # ポート8080で再起動

使用方法: zeroclaw gateway restart [OPTIONS]

オプション:

  • -p, --port <PORT> — リッスンするポート（ランダムに利用可能なポートの場合は0）。デフォルトはconfig gateway.port
  • --host <HOST> — バインドするホスト。デフォルトはconfig gateway.host 注：0.0.0.0へのバインドにはconfig内のgateway.allow_public_bind = trueが必要です
  • --allow-degraded-security — 読み込み中にセキュリティ上重要な設定セクションが既定値に戻された場合（セキュリティ態勢が弱化した状態）でも起動します。既定では無効です

zeroclaw gateway get-paircode

ゲートウェイペアリングコードを表示または生成します。

ゲートウェイを再起動せずに新しいクライアントを接続するためのペアリングコードを表示します。ゲートウェイが実行中である必要があります。

--new を指定すると、ゲートウェイが以前にペアリング済みであっても新しいペアリングコードを生成します（追加のクライアントを登録する際に便利です）。これは既存のトークンを無効化しません。

--rotate を指定すると、ペアリング済みのベアラートークンをすべて失効させ、デバイスレジストリをクリアし、新しいコードを発行します。トークンの漏洩が疑われるものの、どのトークンが侵害されたか不明な場合にこれを使用します。すべてのクライアントは再ペアリングが必要です。

--rotate-device ID を指定すると、そのデバイスのベアラートークンのみを取り消し、そのデバイスを再ペアリングするための新しいコードを発行します。

例: zeroclaw gateway get-paircode # 現在のペアリングコードを表示 zeroclaw gateway get-paircode –new # 別のクライアントを追加（失効なし） zeroclaw gateway get-paircode –rotate # すべてのトークンを失効させてからコードを発行 zeroclaw gateway get-paircode –rotate-device dash-1 # 1台のデバイスのトークンを失効 zeroclaw gateway get-paircode –new –port 3001 # 別ポートのゲートウェイを対象にする

使用方法: zeroclaw gateway get-paircode [OPTIONS]

オプション:

  • --new — クライアント追加用の新しいペアリングコードを生成します（既存のトークンは無効化されません）
  • --rotate — ペアリング済みのすべてのトークンを失効させ、デバイスレジストリをクリアしてから、新しいコードを発行します
  • --rotate-device <DEVICE_ID> — 指定したIDのデバイスのベアラートークンを失効させ、新しいコードを発行します
  • -p, --port <PORT> — クエリ対象の実行中ゲートウェイのポート。デフォルトは config の gateway.port
  • --host <HOST> — クエリ対象として実行中のゲートウェイのホスト。デフォルトは config gateway.host

zeroclaw acp

ACPサーバーを開始します（標準入出力上のJSON-RPC 2.0）。

IDEとツール統合のためにstdin/stdout上でJSON-RPC 2.0サーバーを起動します。セッション管理とストリーミングエージェント応答の通知をサポートします。

メソッド: initialize、session/new、session/prompt、session/stop。

例: zeroclaw acp # ACPサーバーを起動 zeroclaw acp –max-sessions 5 # 同時セッション数を制限

使用方法: zeroclaw acp [OPTIONS]

オプション:

  • --max-sessions <MAX_SESSIONS> — 最大同時実行セッション数（デフォルト：10）
  • --session-timeout <SESSION_TIMEOUT> — セッション無活動タイムアウト秒数（デフォルト：3600）

zeroclaw daemon

長時間実行される自律デーモンを開始します。

完全な ZeroClaw ランタイムを起動します: ゲートウェイサーバー、設定されたすべてのチャネル (Telegram、Discord、Slack など)、ハートビートモニター、および cron スケジューラー。これは本番環境または常時稼働のアシスタントとして ZeroClaw を実行する推奨方法です。

‘zeroclaw service install’ を使用して、デーモンを OS サービス (systemd/launchd) として登録し、ブート時の自動起動を実現します。

例: zeroclaw daemon # デフォルト設定を使用 zeroclaw daemon -p 9090 # ポート 9090 でゲートウェイを起動 zeroclaw daemon –host 127.0.0.1 # ローカルホストのみ

使用方法: zeroclaw daemon [OPTIONS]

オプション:

  • -p, --port <PORT> — リッスンするポート（ランダムに利用可能なポートの場合は0）。デフォルトはconfig gateway.port
  • --host <HOST> — バインドするホスト; デフォルトは config gateway.host
  • --ephemeral — すべてのソケットクライアントが切断された後に自己終了します（猶予期間あり）
  • --allow-degraded-security — 読み込み時にセキュリティ上重要な設定セクションが既定値にフォールバックされた場合でも起動します。このフラグがない場合、デーモンはセキュリティ態勢が弱体化した状態での起動を拒否します。指定すると、オペレーターが修復用インターフェースにアクセスできるようデーモンが起動し、警告を繰り返し出力します

zeroclaw service

OS サービスのライフサイクルを管理 (launchd/systemd ユーザーサービス)

使用方法: zeroclaw service [OPTIONS] <COMMAND>

サブコマンド:

  • install — 自動起動と再起動のためのデーモンサービスユニットをインストール
  • start — デーモンサービスを起動
  • stop — デーモンサービスを停止
  • restart — 最新の設定を適用するためデーモンサービスを再起動
  • status — デーモンサービスの状態を確認
  • uninstall — デーモンサービスユニットをアンインストール
  • logs — デーモンサービスのログを表示

オプション:

  • --service-init <SERVICE_INIT> — 使用する Init システム: auto (検出)、systemd、または openrc

    デフォルト値: auto

    可能な値: auto、systemd、openrc

zeroclaw service install

自動起動と再起動のためのデーモンサービスユニットをインストール

使用方法: zeroclaw service install

zeroclaw service start

デーモンサービスを起動

使用方法: zeroclaw service start

zeroclaw service stop

デーモンサービスを停止

使用方法: zeroclaw service stop

zeroclaw service restart

最新の設定を適用するためデーモンサービスを再起動

使用方法: zeroclaw service restart

zeroclaw service status

デーモンサービスの状態を確認

使用方法: zeroclaw service status

zeroclaw service uninstall

デーモンサービスユニットをアンインストール

使用方法: zeroclaw service uninstall

zeroclaw service logs

デーモンサービスのログを表示

使用方法: zeroclaw service logs [OPTIONS]

オプション:

  • -n、--lines <LINES> — 表示する行数 (デフォルト: 50)

    デフォルト値: 50

  • -f、--follow — ログ出力をフォロー (tail -f のように)

zeroclaw doctor

デーモン/スケジューラー/チャネルの新鮮さの診断を実行

使用方法: zeroclaw doctor [COMMAND]

サブコマンド:

  • models — model_providers 全体でモデルカタログを調査し、可用性をレポートします
  • traces — ランタイムトレースイベント (ツール診断とモデル応答) をクエリ
  • update-context-windows — プロバイダーの /models エンドポイントから config.toml の context_window を更新します

zeroclaw doctor models

model_providers全体でモデルカタログをプローブし、可用性を報告する

使用方法: zeroclaw doctor models [OPTIONS]

オプション:

  • --model-provider <MODEL_PROVIDER> — 特定の model_provider のみをプローブする（デフォルト：既知のすべての model_provider）
  • --use-cache — 利用可能な場合はキャッシュされたカタログを優先します（強制的なライブ更新をスキップ）

zeroclaw doctor traces

ランタイムトレースイベント（ツール診断とモデル応答）をクエリします

使用法: zeroclaw doctor traces [OPTIONS]

オプション:

  • --id <ID> — IDで特定のトレースイベントを表示します

  • --event <EVENT> — イベントタイプでリスト出力をフィルタリングします

  • --contains <CONTAINS> — メッセージ/ペイロード全体での大文字小文字を区別しないテキスト照合

  • --limit <LIMIT> — 表示するイベントの最大数

    デフォルト値: 20

zeroclaw doctor update-context-windows

config.toml内のcontext_windowをプロバイダーの/modelsエンドポイントから更新する

使用法: zeroclaw doctor update-context-windows [OPTIONS]

オプション:

  • --model-provider <MODEL_PROVIDER> — 特定の model_provider のみを更新します（デフォルト: 既知のすべての model_providers）
  • --dry-run — 設定に書き込まずに更新される内容を表示します

zeroclaw status

システムステータスを表示します（詳細情報）

使用法: zeroclaw status [OPTIONS]

オプション:

  • --format <FORMAT> — 出力形式：“exit-code“は健全な場合は0、そうでない場合は1で終了します（Dockerの HEALTHCHECK用）

zeroclaw estop

使用法: zeroclaw estop [OPTIONS] [COMMAND]

サブコマンド:

  • status — 現在のestopステータスを表示します
  • resume — 有効化されたestopレベルから再開します

オプション:

  • --level <LEVEL> — zeroclaw estopからestopを有効化するときに使用するレベル

    可能な値: kill-all、network-kill、domain-block、tool-freeze

  • --domain <DOMAINS> — domain-block用のドメインパターン（繰り返し可能）

  • --tool <TOOLS> — tool-freeze用のツール名（繰り返し可能）

zeroclaw estop status

現在のestopステータスを表示します

使用法: zeroclaw estop status

zeroclaw estop resume

有効化されたestopレベルから再開します

使用法: zeroclaw estop resume [OPTIONS]

オプション:

  • --network — ネットワークキルのみを再開します
  • --domain <DOMAINS> — 1つ以上のブロックされたドメインパターンを再開します
  • --tool <TOOLS> — 1つ以上の凍結されたツールを再開します
  • --otp <OTP> — OTPコード。省略されOTPが必要な場合はプロンプトが表示されます

zeroclaw cron

スケジュール済みタスクを設定および管理します。

cron式、明示的なZまたはオフセットを伴うRFC3339タイムスタンプ、期間、または固定間隔を使用して、繰り返し、ワンショット、または間隔ベースのタスクをスケジュールします。

Cron式は標準の5フィールド形式を使用します: ‘min hour day month weekday’。–tz を省略した場合、cronスケジュールはランタイムのローカルタイムゾーンを使用します。ユーザー向けのスケジュールには、–tz に明示的なIANAタイムゾーンを指定してください。

例: zeroclaw cron list zeroclaw cron add ‘0 9 * * 1-5’ ‘Good morning’ –agent sentinel –prompt –tz America/New_York zeroclaw cron add ‘*/30 * * * ’ ‘Check system health’ –agent sentinel –prompt zeroclaw cron add ‘/5 * * * *’ ‘echo ok’ –agent sentinel zeroclaw cron add-at 2099-01-15T14:00:00Z ‘Send reminder’ –agent sentinel –prompt zeroclaw cron add-every 60000 ‘Ping heartbeat’ –agent sentinel –prompt zeroclaw cron once 30m ‘Run backup in 30 minutes’ –agent sentinel –prompt zeroclaw cron pause TASK_ID zeroclaw cron update TASK_ID –expression ‘0 8 * * *’ –tz Europe/London

使用法: zeroclaw cron <COMMAND>

サブコマンド:

  • list — スケジュール済みのすべてのタスクをリストします
  • add — 新しいスケジュール済みタスクを追加します
  • add-at — RFC3339形式のタイムスタンプ（明示的なZまたはオフセット付き）で1回限りのスケジュールタスクを追加します
  • add-every — 固定間隔のスケジュール済みタスクを追加します
  • once — ワンショット遅延タスクを追加します（例：“30m”、“2h”、“1d”）
  • remove — スケジュール済みタスクを削除します
  • update — スケジュール済みタスクを更新します
  • pause — スケジュール済みタスクを一時停止します
  • resume — 一時停止されたタスクを再開します

zeroclaw cron list

すべてのスケジュール済みタスクをリストする

使用方法: zeroclaw cron list

zeroclaw cron add

新しい定期スケジュールタスクを追加します。

標準の5フィールドcron構文を使用します: ‘min hour day month weekday’。–tz を省略すると、cronスケジュールはランタイムのローカルタイムゾーンを使用します。ユーザー向けのスケジュールでは、明示的なIANAタイムゾーンを指定して –tz を渡してください。

例: zeroclaw cron add ‘0 9 * * 1-5’ ‘Good morning’ –agent sentinel –prompt –tz America/New_York zeroclaw cron add ‘*/30 * * * ’ ‘Check system health’ –agent sentinel –prompt zeroclaw cron add ‘/5 * * * *’ ‘echo ok’ –agent sentinel

使用法: zeroclaw cron add [OPTIONS] --agent <AGENT_ALIAS> <EXPRESSION> <COMMAND>

引数:

  • <EXPRESSION> — Cron式
  • <COMMAND> — 実行するコマンド（シェル）またはプロンプト（--prompt 指定時）

オプション:

  • -a, --agent <AGENT_ALIAS> — cron ジョブが実行する際のエージェントエイリアス（設定済み）。必須 — デフォルトのエージェントはありません

  • --tz <TZ> — オプションのIANAタイムゾーン(例: America/Los_Angeles)

  • --prompt — 引数をシェルコマンドではなくエージェントプロンプトとして扱います

  • --allowed-tool <ALLOWED_TOOLS> — エージェントの cron ジョブを指定したツール名に制限します（繰り返し指定可能、プロンプトのみ）

  • --uses-memory <USES_MEMORY> — false の場合、このエージェント cron ジョブのメモリ想起を無効にします（デフォルト: true）。メモリを蓄積または消費すべきでないステートレスなダイジェスト/レポートジョブでは false に設定してください

    指定可能な値: true、false

  • --channel <DELIVERY_CHANNEL> — ジョブの出力をこのチャンネルに通知します（例: telegram、discord、slack）

  • --to <DELIVERY_TO> — チャネルの対象チャット／受信者 ID（例: Telegram のチャット ID）。

    allow_hyphen_values が必要なのは、サポートされている宛先がハイフンで始まるためです。Telegram のグループ ID とチャンネル ID は負数（-100…）であり、フォーラムトピックの宛先は chat:thread（-100…:42）で、ハイフンで始まりますが数値ではありません。これがないと clap は値をフラグとして扱い、配信の検証が実行される前に終了してしまうため、文書化されていない --to=<value> 形式だけが機能します。

    allow_negative_numbers だけでは不十分です。-100… は受け入れますが、chat:thread 形式は依然として拒否します。より広範な設定だけでは、値の指定を忘れたときに後続のフラグを値として取り込んでしまうため、parse_delivery_recipient は ---で始まる値を拒否し、問題のあるトークンを明示します。

  • --thread <DELIVERY_THREAD> — オプションのスレッド/会話 ID。これに基づいてルーティングするチャネル（webhook）用

  • --no-best-effort — 配信に失敗した場合はジョブを失敗させる（デフォルト: 配信エラーは致命的ではない）

  • --best-effort — 配信に失敗してもジョブを成功扱いにします。以前に --no-best-effort が指定されていた場合は、デフォルトに戻します。

zeroclaw cron add-at

明示的なZまたはオフセットを指定した特定のRFC3339タイムスタンプで実行されるワンショットタスクを追加します。

タイムスタンプには、明示的な Z または数値オフセットを含める必要があります（例: 2099-01-15T14:00:00Z または 2099-01-15T09:00:00-05:00）。

例: zeroclaw cron add-at –agent morning-shift –prompt 2099-01-15T14:00:00Z ‘Send reminder’ zeroclaw cron add-at –agent morning-shift –prompt 2099-12-31T23:59:00Z ‘Happy New Year!’

使用法: zeroclaw cron add-at [OPTIONS] --agent <AGENT_ALIAS> <AT> <COMMAND>

引数:

  • <AT> — 明示的な Z またはオフセットを持つ単発の RFC3339 タイムスタンプ
  • <COMMAND> — 実行するコマンド（シェル）またはプロンプト（--prompt 指定時）

オプション:

  • -a, --agent <AGENT_ALIAS> — cron ジョブが実行するエージェントとして設定されたエージェントエイリアス

  • --prompt — 引数をシェルコマンドではなくエージェントプロンプトとして扱います

  • --allowed-tool <ALLOWED_TOOLS> — エージェントの cron ジョブを指定したツール名に制限します（繰り返し指定可能、プロンプトのみ）

  • --uses-memory <USES_MEMORY> — false の場合、このエージェント cron ジョブのメモリ呼び出しを無効にします（デフォルト: true）

    指定可能な値: true、false

  • --channel <DELIVERY_CHANNEL> — ジョブの出力をこのチャンネルに通知します（例: telegram、discord、slack）

  • --to <DELIVERY_TO> — チャネルの対象チャット／受信者 ID（例: Telegram のチャット ID）。

    allow_hyphen_values が必要なのは、サポートされている宛先がハイフンで始まるためです。Telegram のグループ ID とチャンネル ID は負数（-100…）であり、フォーラムトピックの宛先は chat:thread（-100…:42）で、ハイフンで始まりますが数値ではありません。これがないと clap は値をフラグとして扱い、配信の検証が実行される前に終了してしまうため、文書化されていない --to=<value> 形式だけが機能します。

    allow_negative_numbers だけでは不十分です。-100… は受け入れますが、chat:thread 形式は依然として拒否します。より広範な設定だけでは、値の指定を忘れたときに後続のフラグを値として取り込んでしまうため、parse_delivery_recipient は ---で始まる値を拒否し、問題のあるトークンを明示します。

  • --thread <DELIVERY_THREAD> — オプションのスレッド/会話 ID。これに基づいてルーティングするチャネル（webhook）用

  • --no-best-effort — 配信に失敗した場合はジョブを失敗させる（デフォルト: 配信エラーは致命的ではない）

  • --best-effort — 配信に失敗してもジョブを成功扱いにします。以前に --no-best-effort が指定されていた場合は、デフォルトに戻します。

zeroclaw cron add-every

固定間隔で繰り返されるタスクを追加します。

間隔はミリ秒で指定されます。例えば、60000 = 1分です。

例: zeroclaw cron add-every –agent triage –prompt 60000 ‘Ping heartbeat’ zeroclaw cron add-every –agent triage –prompt 3600000 ‘Hourly report’

使用法: zeroclaw cron add-every [OPTIONS] --agent <AGENT_ALIAS> <EVERY_MS> <COMMAND>

引数:

  • <EVERY_MS> — ミリ秒単位の間隔
  • <COMMAND> — 実行するコマンド（シェル）またはプロンプト（--prompt 指定時）

オプション:

  • -a, --agent <AGENT_ALIAS> — cron ジョブが実行するエージェントとして設定されたエージェントエイリアス

  • --prompt — 引数をシェルコマンドではなくエージェントプロンプトとして扱います

  • --allowed-tool <ALLOWED_TOOLS> — エージェントの cron ジョブを指定したツール名に制限します（繰り返し指定可能、プロンプトのみ）

  • --uses-memory <USES_MEMORY> — false の場合、このエージェント cron ジョブのメモリ呼び出しを無効にします（デフォルト: true）

    指定可能な値: true、false

  • --channel <DELIVERY_CHANNEL> — ジョブの出力をこのチャンネルに通知します（例: telegram、discord、slack）

  • --to <DELIVERY_TO> — チャネルの対象チャット／受信者 ID（例: Telegram のチャット ID）。

    allow_hyphen_values が必要なのは、サポートされている宛先がハイフンで始まるためです。Telegram のグループ ID とチャンネル ID は負数（-100…）であり、フォーラムトピックの宛先は chat:thread（-100…:42）で、ハイフンで始まりますが数値ではありません。これがないと clap は値をフラグとして扱い、配信の検証が実行される前に終了してしまうため、文書化されていない --to=<value> 形式だけが機能します。

    allow_negative_numbers だけでは不十分です。-100… は受け入れますが、chat:thread 形式は依然として拒否します。より広範な設定だけでは、値の指定を忘れたときに後続のフラグを値として取り込んでしまうため、parse_delivery_recipient は ---で始まる値を拒否し、問題のあるトークンを明示します。

  • --thread <DELIVERY_THREAD> — オプションのスレッド/会話 ID。これに基づいてルーティングするチャネル（webhook）用

  • --no-best-effort — 配信に失敗した場合はジョブを失敗させる（デフォルト: 配信エラーは致命的ではない）

  • --best-effort — 配信に失敗してもジョブを成功扱いにします。以前に --no-best-effort が指定されていた場合は、デフォルトに戻します。

zeroclaw cron once

今からの遅延後に発火するワンショットタスクを追加します。

人間が読める期間を受け入れます: s(秒)、m(分)、h(時間)、d(日)。

例: zeroclaw cron once –agent ops-bot –prompt 30m ‘Run backup in 30 minutes’ zeroclaw cron once –agent researcher –prompt 2h ‘Follow up on deployment’

使用法: zeroclaw cron once [OPTIONS] --agent <AGENT_ALIAS> <DELAY> <COMMAND>

引数:

  • <DELAY> — 遅延期間
  • <COMMAND> — 実行するコマンド（シェル）またはプロンプト（--prompt 指定時）

オプション:

  • -a, --agent <AGENT_ALIAS> — cron ジョブが実行するエージェントとして設定されたエージェントエイリアス

  • --prompt — 引数をシェルコマンドではなくエージェントプロンプトとして扱います

  • --allowed-tool <ALLOWED_TOOLS> — エージェントの cron ジョブを指定したツール名に制限します（繰り返し指定可能、プロンプトのみ）

  • --uses-memory <USES_MEMORY> — false の場合、このエージェント cron ジョブのメモリ呼び出しを無効にします（デフォルト: true）

    指定可能な値: true、false

  • --channel <DELIVERY_CHANNEL> — ジョブの出力をこのチャンネルに通知します（例: telegram、discord、slack）

  • --to <DELIVERY_TO> — チャネルの対象チャット／受信者 ID（例: Telegram のチャット ID）。

    allow_hyphen_values が必要なのは、サポートされている宛先がハイフンで始まるためです。Telegram のグループ ID とチャンネル ID は負数（-100…）であり、フォーラムトピックの宛先は chat:thread（-100…:42）で、ハイフンで始まりますが数値ではありません。これがないと clap は値をフラグとして扱い、配信の検証が実行される前に終了してしまうため、文書化されていない --to=<value> 形式だけが機能します。

    allow_negative_numbers だけでは不十分です。-100… は受け入れますが、chat:thread 形式は依然として拒否します。より広範な設定だけでは、値の指定を忘れたときに後続のフラグを値として取り込んでしまうため、parse_delivery_recipient は ---で始まる値を拒否し、問題のあるトークンを明示します。

  • --thread <DELIVERY_THREAD> — オプションのスレッド/会話 ID。これに基づいてルーティングするチャネル（webhook）用

  • --no-best-effort — 配信に失敗した場合はジョブを失敗させる（デフォルト: 配信エラーは致命的ではない）

  • --best-effort — 配信に失敗してもジョブを成功扱いにします。以前に --no-best-effort が指定されていた場合は、デフォルトに戻します。

zeroclaw cron remove

スケジュール済みタスクを削除します

使用方法: zeroclaw cron remove <ID>

引数:

  • <ID> — タスクID

zeroclaw cron update

既存のスケジュール済みタスクの1つ以上のフィールドを更新します。

指定したフィールドのみが変更されます。その他は変わりません。

例: zeroclaw cron update TASK_ID –expression ‘0 8 * * *’ zeroclaw cron update TASK_ID –tz Europe/London –name ‘Morning check’ zeroclaw cron update TASK_ID –command ‘Updated message’

使用法: zeroclaw cron update [OPTIONS] --agent <AGENT_ALIAS> <ID>

引数:

  • <ID> — タスクID

オプション:

  • -a, --agent <AGENT_ALIAS> — 設定済みのエージェントエイリアス。必須。エイリアスのリスクプロファイルによって、シェルジョブのシェルコマンドが制御されます

  • --expression <EXPRESSION> — 新しいcron式

  • --tz <TZ> — 新しいIANAタイムゾーン

  • --command <COMMAND> — 新しいシェルコマンド、またはジョブがエージェントジョブの場合は新しいエージェントプロンプト

  • --name <NAME> — 新しいジョブ名

  • --allowed-tool <ALLOWED_TOOLS> — エージェントジョブの許可リストを指定されたツール名に置き換えます(繰り返し可能)

  • --uses-memory <USES_MEMORY> — false の場合、このエージェント cron ジョブのメモリ呼び出しを無効にします（デフォルト: true）

    指定可能な値: true、false

  • --channel <DELIVERY_CHANNEL> — ジョブの出力をこのチャンネルに通知します（例: telegram、discord、slack）

  • --to <DELIVERY_TO> — チャネルの対象チャット／受信者 ID（例: Telegram のチャット ID）。

    allow_hyphen_values が必要なのは、サポートされている宛先がハイフンで始まるためです。Telegram のグループ ID とチャンネル ID は負数（-100…）であり、フォーラムトピックの宛先は chat:thread（-100…:42）で、ハイフンで始まりますが数値ではありません。これがないと clap は値をフラグとして扱い、配信の検証が実行される前に終了してしまうため、文書化されていない --to=<value> 形式だけが機能します。

    allow_negative_numbers だけでは不十分です。-100… は受け入れますが、chat:thread 形式は依然として拒否します。より広範な設定だけでは、値の指定を忘れたときに後続のフラグを値として取り込んでしまうため、parse_delivery_recipient は ---で始まる値を拒否し、問題のあるトークンを明示します。

  • --thread <DELIVERY_THREAD> — オプションのスレッド/会話 ID。これに基づいてルーティングするチャネル（webhook）用

  • --no-best-effort — 配信に失敗した場合はジョブを失敗させる（デフォルト: 配信エラーは致命的ではない）

  • --best-effort — 配信に失敗してもジョブを成功扱いにします。以前に --no-best-effort が指定されていた場合は、デフォルトに戻します。

zeroclaw cron pause

スケジュール済みタスクを一時停止します

使用方法: zeroclaw cron pause <ID>

引数:

  • <ID> — タスクID

zeroclaw cron resume

一時停止されたタスクを再開します

使用方法: zeroclaw cron resume <ID>

引数:

  • <ID> — タスクID

zeroclaw models

model_provider モデルカタログを管理する

使用方法: zeroclaw models <COMMAND>

サブコマンド:

  • refresh — model_provider モデルを更新してキャッシュする
  • list — config.toml で設定されているモデルを一覧表示する
  • set — 設定でデフォルトモデルを設定
  • status — 現在のモデル設定とキャッシュステータスを表示

zeroclaw models refresh

model_provider モデルを更新してキャッシュする

使用方法: zeroclaw models refresh [OPTIONS]

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider 名（既定では設定済みの default model_provider）
  • --all — ライブモデル検出をサポートするすべての model_providers を更新します
  • --force — ライブ更新を強制し、フレッシュキャッシュを無視

zeroclaw models list

config.toml で設定されているモデルを一覧表示します

使用方法: zeroclaw models list [OPTIONS]

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider 名（デフォルトは設定済みのすべてのエントリ）
  • --check — 設定された各モデルをプロバイダーのライブカタログと照合して検証する

zeroclaw models set

設定でデフォルトモデルを設定

使用方法: zeroclaw models set <MODEL>

引数:

  • <MODEL> — デフォルトとして設定するモデル名

zeroclaw models status

現在のモデル設定とキャッシュステータスを表示

使用方法: zeroclaw models status

zeroclaw providers

プロバイダーのエイリアス CRUD（[providers.<category>.<family>.<alias>]）。category は models、tts、transcription のいずれかです

使い方: zeroclaw providers [COMMAND]

サブコマンド:

  • list — プロバイダーのエイリアスを一覧表示（カテゴリでフィルタリング可能）
  • create — デフォルト設定で新しいプロバイダーエイリアスを作成します
  • rename — プロバイダーのエイリアスをリネームし、すべての参照を書き換えます
  • delete — プロバイダーのエイリアスを削除し、参照をクリーンアップします

zeroclaw providers list

プロバイダーのエイリアスを一覧表示します（カテゴリでフィルタリング可能）

使用法: zeroclaw providers list [OPTIONS]

オプション:

  • --category <CATEGORY> — カテゴリ: models | tts | transcription

zeroclaw providers create

デフォルト設定で新しいプロバイダーエイリアスを作成します

使用方法: zeroclaw providers create <CATEGORY> <FAMILY> <ALIAS>

引数:

  • <CATEGORY> — カテゴリー: models | tts | transcription
  • <FAMILY> — プロバイダーファミリー（例: anthropic、openai、elevenlabs）
  • <ALIAS> — 新しいエイリアス

zeroclaw providers rename

プロバイダーのエイリアスをリネームし、すべての参照を書き換えます

使用方法: zeroclaw providers rename <CATEGORY> <FAMILY> <FROM> <TO>

引数:

  • <CATEGORY>
  • <FAMILY>
  • <FROM>
  • <TO>

zeroclaw providers delete

プロバイダーエイリアスを削除し、参照をクリーンアップします

使用法: zeroclaw providers delete [OPTIONS] <CATEGORY> <FAMILY> <ALIAS>

引数:

  • <CATEGORY>
  • <FAMILY>
  • <ALIAS>

オプション:

  • --dry-run
  • --yes

zeroclaw channel

通信チャネルを管理する。

ZeroClaw をメッセージングプラットフォームに接続するチャネルを追加、削除、リストアップ、送信、ヘルスチェックします。サポートされているチャネルタイプ: telegram, discord, slack, whatsapp, matrix, imessage, email。

例: zeroclaw channel list zeroclaw channel doctor zeroclaw channel add telegram ‘{“bot_token”:“…”,“name”:“my-bot”}’ zeroclaw channel remove my-bot zeroclaw channel bind-telegram zeroclaw_user zeroclaw channel send ‘Alert!’ –channel-id telegram –recipient 123456789

使用方法: zeroclaw channel <COMMAND>

サブコマンド:

  • list — 設定されたすべてのチャネルをリストアップ
  • start — 設定されたすべてのチャネルを開始（main.rs で非同期で処理）
  • doctor — 設定されたチャネルのヘルスチェックを実行（main.rs で非同期で処理）
  • add — 新しいチャネル設定を追加
  • remove — チャネル設定を削除
  • bind-telegram — Telegram ID（ユーザー名または数値ユーザーID）をホワイトリストにバインド
  • send — 設定されたチャネルにメッセージを送信

zeroclaw channel list

設定されたすべてのチャネルをリストアップ

使用方法: zeroclaw channel list

zeroclaw channel start

設定されたすべてのチャネルを開始（main.rs で非同期で処理）

使用方法: zeroclaw channel start

zeroclaw channel doctor

設定されたチャネルのヘルスチェックを実行（main.rs で非同期で処理）

使用方法: zeroclaw channel doctor

zeroclaw channel add

新しいチャネル設定を追加する。

チャネルタイプとそのチャネルタイプに必要な設定キーを含むJSONオブジェクトを提供します。

サポートされているタイプ: telegram、discord、slack、whatsapp、matrix、imessage、email。

例: zeroclaw channel add telegram ‘{“bot_token”:“…”,“name”:“my-bot”}’ zeroclaw channel add discord ‘{“bot_token”:“…”,“name”:“my-discord”}’

使用方法: zeroclaw channel add <CHANNEL_TYPE> <CONFIG>

引数:

  • <CHANNEL_TYPE> — チャネルタイプ (telegram、discord、slack、whatsapp、matrix、imessage、email)
  • <CONFIG> — JSONとしてのオプション設定

zeroclaw channel remove

チャネル設定を削除します

使用方法: zeroclaw channel remove <NAME>

引数:

  • <NAME> — 削除するチャネル名

zeroclaw channel bind-telegram

Telegramアイデンティティを許可リストにバインドします。

Telegramユーザー名 (’@’プレフィックスなし) または数値ユーザーIDをチャネル許可リストに追加して、エージェントがそのアイデンティティからのメッセージに応答するようにします。

--alias を使用して、デフォルト以外の Telegram チャンネルを対象にします — これは、エージェントが使用する channels.telegram.<alias> セクション内のエイリアスと一致している必要があります。指定しない場合、ID は default エイリアスに紐付けられ、デフォルト以外のエージェントは承認を求め続けます。

例: zeroclaw channel bind-telegram zeroclaw_user zeroclaw channel bind-telegram 123456789 zeroclaw channel bind-telegram 123456789 –alias alerts

使用法: zeroclaw channel bind-telegram [OPTIONS] <IDENTITY>

引数:

  • <IDENTITY> — 許可するTelegramアイデンティティ (’@’なしのユーザー名または数値ユーザーID)

オプション:

  • --alias <ALIAS> — バインドする Telegram チャンネルのエイリアス（channels.telegram.<alias> 内の <alias>）。デフォルトは default

    デフォルト値: default

zeroclaw channel send

設定されたチャネルに1回限りのメッセージを送信します。

フルエージェントループを開始せずに、指定されたチャネルを通じてテキストメッセージを送信します。スクリプト化された通知、ハードウェアセンサーアラート、自動化パイプラインに役立ちます。

--channel-idは設定セクション名 (例: ‘telegram’、‘discord’、‘slack’) でチャネルを選択します。–recipientはプラットフォーム固有の宛先 (例: TelegramチャットID) です。

例: zeroclaw channel send ‘Someone is near your device.’ –channel-id telegram –recipient 123456789 zeroclaw channel send ‘Build succeeded!’ –channel-id discord –recipient 987654321

使用方法: zeroclaw channel send --channel-id <CHANNEL_ID> --recipient <RECIPIENT> <MESSAGE>

引数:

  • <MESSAGE> — 送信するメッセージテキスト

オプション:

  • --channel-id <CHANNEL_ID> — チャネル設定名 (例: telegram、discord、slack)
  • --recipient <RECIPIENT> — 受信者識別子 (プラットフォーム固有、例: TelegramチャットID)

zeroclaw agents

エージェントのエイリアスを管理します（作成/一覧表示/名前変更/削除）。エージェントを実行する agent とは異なります

使用法: zeroclaw agents <COMMAND>

サブコマンド:

  • list — 設定済みのエージェントエイリアスを一覧表示
  • create — デフォルト設定で新しいエージェントエイリアスを作成する
  • rename — エージェントのエイリアスを変更し、それを参照するすべての箇所を書き換えます
  • delete — エージェントエイリアスを削除し、参照を除去して所有状態を連鎖的に削除します

zeroclaw agents list

設定済みのエージェントエイリアスを一覧表示する

使用法: zeroclaw agents list

zeroclaw agents create

デフォルト設定で新しいエージェントエイリアスを作成します

使用法: zeroclaw agents create <ALIAS>

引数:

  • <ALIAS> — 新しいエージェントのエイリアス（小文字英数字 + 単一のアンダースコア）

zeroclaw agents rename

エイリアスへのすべての参照を書き換えて、エージェントのエイリアス名を変更します

使用法: zeroclaw agents rename <FROM> <TO>

引数:

  • <FROM> — 現在のエイリアス
  • <TO> — 新しいエイリアス

zeroclaw agents delete

エージェントエイリアスを削除し、参照をクリーンアップして所有状態をカスケード削除します

使用法: zeroclaw agents delete [OPTIONS] <ALIAS>

引数:

  • <ALIAS> — 削除するエイリアス

オプション:

  • --dry-run — 削除せずに影響（スクラブされる参照）を表示
  • --yes — 確認プロンプトをスキップする

zeroclaw channels

チャンネルエイリアスを管理（作成/一覧/名前変更/削除）

使用法: zeroclaw channels <COMMAND>

サブコマンド:

  • list — チャンネルエイリアスの一覧を表示（必要に応じてタイプでフィルタリング）
  • create — デフォルト設定で新しいチャンネルエイリアスを作成します
  • rename — チャネルエイリアスの名前を変更し、すべての参照を書き換えます
  • delete — チャンネルエイリアスを削除し、参照をクリーンアップします

zeroclaw channels list

チャンネルエイリアスを一覧表示します（タイプでフィルタリング可能）

使用法: zeroclaw channels list [OPTIONS]

オプション:

  • --channel-type <CHANNEL_TYPE> — チャンネルタイプ（例: discord、telegram）

zeroclaw channels create

デフォルト設定で新しいチャンネルエイリアスを作成します

使用法: zeroclaw channels create <CHANNEL_TYPE> <ALIAS>

引数:

  • <CHANNEL_TYPE> — チャンネルタイプ (discord, telegram, slack, …)
  • <ALIAS> — 新しいエイリアス

zeroclaw channels rename

チャンネルエイリアスの名前を変更し、すべての参照を書き換える

使用法: zeroclaw channels rename <CHANNEL_TYPE> <FROM> <TO>

引数:

  • <CHANNEL_TYPE>
  • <FROM>
  • <TO>

zeroclaw channels delete

チャンネルエイリアスを削除し、参照をクリーンアップします

使用法: zeroclaw channels delete [OPTIONS] <CHANNEL_TYPE> <ALIAS>

引数:

  • <CHANNEL_TYPE>
  • <ALIAS>

オプション:

  • --dry-run
  • --yes

zeroclaw integrations

50以上のインテグレーションを参照します

使用方法: zeroclaw integrations <COMMAND>

サブコマンド:

  • info — 特定のインテグレーションの詳細を表示

zeroclaw integrations info

特定のインテグレーションの詳細を表示します

使用方法: zeroclaw integrations info <NAME>

引数:

  • <NAME> — インテグレーション名

zeroclaw skills

スキル (ユーザー定義機能) を管理します

使用方法: zeroclaw skills <COMMAND>

サブコマンド:

  • list — インストール済みのすべてのスキルをリストします
  • add — 新しいスキルをゼロからスキャフォールドする（標準的な SKILL.md + オプションのサブディレクトリ）
  • edit — スキルの SKILL.md（または同じディレクトリのファイル）を $EDITOR で開く
  • bundle — スキルバンドル（スキルが配置される名前付きディレクトリ）を管理します
  • audit — スキルソースディレクトリまたはインストール済みスキル名を監査します
  • install — URLまたはローカルパスから新しいスキルをインストールします
  • remove — インストール済みのスキルを削除します
  • test — スキル (またはすべてのスキル) のTEST.sh検証を実行します

zeroclaw skills list

インストール済みのすべてのスキルをリストします

使用法: zeroclaw skills list [OPTIONS]

オプション:

  • --agent <AGENT> — このエージェントが実行時に読み込む内容（ワークスペース + open-skills + プラグイン + 割り当てられたバンドル）を正確に表示します。両方が指定された場合は –bundle が優先されます
  • --bundle <BUNDLE> — 単一のバンドルに制限します。すべてのバンドルにわたって一覧表示するには省略します

zeroclaw skills add

スキルバンドル内に新しいスキルをスキャフォールドします。<bundle.directory>/<name>/SKILL.md と標準のオプションサブディレクトリ（scripts/、references/、assets/）を作成します。名前は小文字とハイフンのみ使用可能です。説明は必須です（省略した場合は TTY 上で入力を求められます）。

例: zeroclaw skills add code-review –bundle official –description “Review PRs.” zeroclaw skills add ops-runbook –description “Triage prod incidents.” –edit

使用法: zeroclaw skills add [OPTIONS] <NAME>

引数:

  • <NAME> — スキル名（小文字とハイフンのみ）

オプション:

  • --bundle <BUNDLE> — 対象のバンドルエイリアス。バンドルが1つだけ構成されている場合は省略可能
  • --description <DESCRIPTION> — スキルの機能と使用するタイミング（フロントマターの description）。必須。未指定の場合は TTY 上でプロンプト表示されます
  • --license <LICENSE> — SPDXライセンス識別子（例: MIT）
  • --author <AUTHOR> — Skill 作成者ハンドル
  • --version <VERSION> — SemVer バージョン（デフォルトは 0.1.0）
  • --category <CATEGORY> — レジストリのグループ化に使用するスキルカテゴリ
  • --no-scaffold — scripts/、references/、assets/ のスキャフォールディングをスキップします
  • --edit — スキャフォールド後に $EDITOR で SKILL.md を開く

zeroclaw skills edit

$EDITOR でスキルの SKILL.md（または同階層のファイル）を開きます

使用法: zeroclaw skills edit [OPTIONS] <NAME>

引数:

  • <NAME> — スキル名

オプション:

  • --bundle <BUNDLE> — 対象のバンドルエイリアス。名前がバンドル全体で一意である場合は省略可能です
  • --file <FILE> — SKILL.md の代わりに同階層のファイルを編集する（例: scripts/runner.sh）

zeroclaw skills bundle

スキルバンドル（スキルが格納される名前付きディレクトリ）を管理する

使用法: zeroclaw skills bundle <COMMAND>

サブコマンド:

  • list — 設定済みのスキルバンドルとその解決済みディレクトリを一覧表示する
  • add — 新しいスキルバンドルを追加します。ディレクトリのデフォルトは shared/skills/<alias>/ です
  • remove — 設定済みのスキルバンドルを削除します（そのディレクトリをアーカイブし、すべてのエージェントの skill_bundles リストから除外します）
  • rename — スキルバンドルの名前を変更します（ディレクトリの移動 + エージェント参照の書き換え）
  • show — バンドルのメタデータとスキル一覧を表示

zeroclaw skills bundle list

設定済みのスキルバンドルと解決済みのディレクトリを一覧表示します

使用法: zeroclaw skills bundle list

zeroclaw skills bundle add

新しいスキルバンドルを追加します。ディレクトリのデフォルトは shared/skills/<alias>/ です。

使用法: zeroclaw skills bundle add [OPTIONS] <ALIAS>

引数:

  • <ALIAS> — バンドルエイリアス（小文字＋ハイフン。エージェント／チャンネルと同じ規則）

オプション:

  • --directory <DIRECTORY> — ディレクトリを上書きします（インストールルートからの相対パスまたは絶対パス）。<install>/shared/ 内に解決される必要があります

zeroclaw skills bundle remove

設定済みのスキルバンドルを削除します（ディレクトリをアーカイブし、すべてのエージェントの skill_bundles リストから除去します）

使用法: zeroclaw skills bundle remove [OPTIONS] <ALIAS>

引数:

  • <ALIAS> — バンドルのエイリアス

オプション:

  • --yes — 確認プロンプトをスキップする

zeroclaw skills bundle rename

スキルバンドルの名前を変更（ディレクトリの移動 + エージェント参照の書き換えを行います）

使用法: zeroclaw skills bundle rename <FROM> <TO>

引数:

  • <FROM> — 現在のエイリアス
  • <TO> — 新しいエイリアス

zeroclaw skills bundle show

バンドルのメタデータとスキル一覧を表示

使用法: zeroclaw skills bundle show <ALIAS>

引数:

  • <ALIAS> — バンドルのエイリアス

zeroclaw skills audit

スキルソースディレクトリまたはインストール済みスキル名を監査します

使用方法: zeroclaw skills audit <SOURCE>

引数:

  • <SOURCE> — スキルパスまたはインストール済みスキル名

zeroclaw skills install

URLまたはローカルパスから新しいスキルをインストールします

使用法: zeroclaw skills install [OPTIONS] <SOURCE>

引数:

  • <SOURCE> — ソースURL またはローカルパス

オプション:

  • --agent <AGENT> — このエージェントに割り当てられたバンドルにインストールします（デフォルトはアクティブなエージェント）。エージェントにバンドルがない場合は、グローバルディレクトリにフォールバックします
  • --bundle <BUNDLE> — このバンドルに直接インストールします。–agent よりも優先されます
  • --no-tier-banner — インストール時のティアバナーのみを抑制します。その他のインストール進捗出力（resolving、installed、audited）には影響しません
  • --skill <SKILL> — git カタログリポジトリから指定した名前のスキルを 1 つインストールします（その skills/<name>/ ディレクトリ）

zeroclaw skills remove

インストールされたスキルを削除

使用法: zeroclaw skills remove [OPTIONS] <NAME>

引数:

  • <NAME> — 削除するスキル名

オプション:

  • --agent <AGENT> — 検索をこのエージェントに割り当てられたバンドルに限定します
  • --bundle <BUNDLE> — このバンドルから直接削除する（重複を明確化する）

zeroclaw skills test

スキルのTEST.sh検証を実行（またはすべてのスキル）

使用方法: zeroclaw skills test [OPTIONS] [NAME]

引数:

  • <NAME> — テストするスキル名。すべてのスキルの場合は省略

オプション:

  • --verbose — 詳細出力を表示

zeroclaw browse

<install>/shared/ 配下のディレクトリの子要素を一覧表示します。パスは共有ワークスペースのルートからの相対パスであり、ルートを抜け出す .. によるトラバーサルは拒否されます。ダッシュボードのスキルバンドル用ディレクトリピッカーや、インストール済みの内容を確認したいオペレーターによって使用されます。

例: zeroclaw browse # shared/ ルートを一覧表示 zeroclaw browse skills # shared/skills/ を一覧表示 zeroclaw browse skills/coding # shared/skills/coding/ を一覧表示

使用法: zeroclaw browse [PATH]

引数:

  • <PATH> — <install>/shared/ からの相対パス。空の場合 = ルート

    デフォルト値: ``

zeroclaw sop

標準操作手順（SOP）を管理

使用方法: zeroclaw sop <COMMAND>

サブコマンド:

  • list — ロードされたSOPをリスト表示
  • validate — SOP定義を検証
  • show — SOPの詳細を表示
  • approve — アウトオブバンド承認を待機している SOP 実行を承認する（実行中のデーモンと通信します）
  • deny — 承認待ちの SOP 実行を拒否（キャンセル）します（実行中のデーモンと通信します）
  • pending — 現在承認待ちの SOP 実行を一覧表示します（実行中のデーモンと通信します）
  • graph — SOPのノードグラフをテキストとして描画
  • delete — SOP定義をディスクから削除する

zeroclaw sop list

ロードされたSOPをリスト表示

使用方法: zeroclaw sop list

zeroclaw sop validate

SOP定義を検証

使用方法: zeroclaw sop validate [NAME]

引数:

  • <NAME> — 検証するSOP名（省略時はすべて）

zeroclaw sop show

SOPの詳細を表示

使用方法: zeroclaw sop show <NAME>

引数:

  • <NAME> — 表示するSOPの名前

zeroclaw sop approve

アウトオブバンド承認を待機している SOP 実行を承認する（実行中のデーモンと通信する）

使用法: zeroclaw sop approve <RUN_ID>

引数:

  • <RUN_ID> — 承認する実行 ID

zeroclaw sop deny

承認待ちの SOP 実行を拒否（キャンセル）する（実行中のデーモンと通信する）

使用法: zeroclaw sop deny <RUN_ID> [REASON]

引数:

  • <RUN_ID> — 拒否する実行ID
  • <REASON> — 承認台帳に記録される任意の理由

zeroclaw sop pending

現在承認待ちの SOP 実行を一覧表示する（実行中のデーモンと通信する）

使用法: zeroclaw sop pending

zeroclaw sop graph

SOP のノードグラフをテキストとして表示する

使用法: zeroclaw sop graph [OPTIONS] <NAME>

引数:

  • <NAME> — レンダリングする SOP の名前

オプション:

  • --format <FORMAT> — 出力形式

    デフォルト値: outline

    指定可能な値:

    • outline: ノードごとに1行で、その送信フローエッジを表示
    • adjacency: from -> to [role] の隣接関係、1行につき1エッジ
    • json: プロジェクション全体を整形した JSON

zeroclaw sop delete

ディスクからSOP定義を削除する

使用法: zeroclaw sop delete <NAME>

引数:

  • <NAME> — 削除する SOP の名前

zeroclaw migrate

他のエージェントランタイムからデータを移行

使用方法: zeroclaw migrate <COMMAND>

サブコマンド:

  • openclaw — OpenClawワークスペースからこのZeroClawワークスペースにメモリをインポート

zeroclaw migrate openclaw

OpenClawワークスペースからこのZeroClawワークスペースにメモリをインポート

使用方法: zeroclaw migrate openclaw [OPTIONS]

オプション:

  • --source <SOURCE> — OpenClawワークスペースへのオプションパス（デフォルトは ~/.openclaw/workspace）
  • --dry-run — データを書き込まずに移行を検証およびプレビュー
  • --reindex — エントリのインポート後にバックエンドインデックスを再構築します

zeroclaw auth

model_provider サブスクリプションの認証プロファイルを管理します

使用方法: zeroclaw auth <COMMAND>

サブコマンド:

  • login — OAuth でログイン（OpenAI Codex、Gemini、または xAI）
  • paste-redirect — リダイレクトURL または認証コードを貼り付けてOAuthを完了
  • paste-token — セットアップトークン / 認証トークンを貼り付け（Anthropic購読認証の場合）
  • setup-token — paste-tokenのエイリアス（デフォルトではインタラクティブ）
  • refresh — リフレッシュトークンを使用してOAuthアクセストークンを更新する
  • logout — 認証プロファイルを削除
  • use — model_provider のアクティブなプロファイルを設定
  • list — 認証プロファイルをリスト表示
  • status — アクティブプロファイルとトークン有効期限情報を含む認証ステータスを表示
  • email-login — OAuth2 デバイスコードフローでメールチャネルを認証する

zeroclaw auth login

OAuth でログイン (OpenAI Codex、Gemini、または xAI)

使用法: zeroclaw auth login [OPTIONS] --model-provider <MODEL_PROVIDER>

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider（openai-codex、gemini、または xai）

  • --profile <PROFILE> — プロファイル名 (デフォルト: default)

    デフォルト値: default

  • --device-code — OAuth デバイスコードフローを使用

  • --import <PATH> — 新しいログインフローを開始する代わりに、既存の auth.json ファイルをインポートします。openai-codex（~/.codex/auth.json）と xai（~/.grok/auth.json）をサポートしています

zeroclaw auth paste-redirect

リダイレクト URL または認証コードを貼り付けて OAuth を完了

使用法: zeroclaw auth paste-redirect [OPTIONS] --model-provider <MODEL_PROVIDER>

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider（openai-codex、gemini、または xai）

  • --profile <PROFILE> — プロファイル名 (デフォルト: default)

    デフォルト値: default

  • --input <INPUT> — 完全なリダイレクト URL または未処理の OAuth コード

zeroclaw auth paste-token

セットアップトークン / 認証トークンを貼り付け (Anthropic サブスクリプション認証用)

使用法: zeroclaw auth paste-token [OPTIONS] --model-provider <MODEL_PROVIDER>

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider (anthropic)

  • --profile <PROFILE> — プロファイル名 (デフォルト: default)

    デフォルト値: default

  • --token <TOKEN> — トークン値 (省略した場合、対話的に読み込む)

  • --auth-kind <AUTH_KIND> — 認証種別オーバーライド (authorization または api-key)

zeroclaw auth setup-token

paste-token のエイリアス (デフォルトで対話的)

使用法: zeroclaw auth setup-token [OPTIONS] --model-provider <MODEL_PROVIDER>

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider (anthropic)

  • --profile <PROFILE> — プロファイル名 (デフォルト: default)

    デフォルト値: default

zeroclaw auth refresh

リフレッシュトークンを使用してOAuthアクセストークンを更新する

使用法: zeroclaw auth refresh [OPTIONS] --model-provider <MODEL_PROVIDER>

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider（openai-codex、gemini、または xai）
  • --profile <PROFILE> — プロファイル名またはプロファイル ID

zeroclaw auth logout

認証プロファイルを削除

使用法: zeroclaw auth logout [OPTIONS] --model-provider <MODEL_PROVIDER>

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider

  • --profile <PROFILE> — プロファイル名 (デフォルト: default)

    デフォルト値: default

zeroclaw auth use

モデルプロバイダーのアクティブなプロファイルを設定する

使用法: zeroclaw auth use --model-provider <MODEL_PROVIDER> --profile <PROFILE>

オプション:

  • --model-provider <MODEL_PROVIDER> — ModelProvider
  • --profile <PROFILE> — プロファイル名または完全なプロファイル ID

zeroclaw auth list

認証プロファイルを一覧表示

使用法: zeroclaw auth list

zeroclaw auth status

アクティブプロファイルとトークン有効期限情報を含む認証ステータスを表示

使用法: zeroclaw auth status

zeroclaw auth email-login

OAuth2 デバイスコードフローでメールチャネルを認証する

使用法: zeroclaw auth email-login [OPTIONS] --channel <CHANNEL>

オプション:

  • --channel <CHANNEL> — [channels.email.<alias>] のメールチャネルエイリアス（例: ‘hotmail’）

  • --profile <PROFILE> — プロファイル名 (デフォルト: default)

    デフォルト値: default

zeroclaw hardware

USB ハードウェアを検出して調査します。

接続されている USB デバイスを列挙し、既知の開発ボード (STM32 Nucleo、Arduino、ESP32) を識別し、probe-rs / ST-Link を介してチップ情報を取得します。

例: zeroclaw hardware discover zeroclaw hardware introspect /dev/ttyACM0 zeroclaw hardware info –chip STM32F401RETx

使用法: zeroclaw hardware <COMMAND>

サブコマンド:

  • discover — USB デバイス (VID/PID) を列挙し、既知のボードを表示
  • introspect — パス別にデバイスを調査 (例: /dev/ttyACM0)
  • info — USB 経由でチップ情報を取得 (ST-Link 上の probe-rs)。ターゲットにファームウェアは不要

zeroclaw hardware discover

USB デバイスを列挙して、既知のボードを表示します。

接続されている USB デバイスを VID/PID でスキャンし、既知の開発ボード (STM32 Nucleo、Arduino、ESP32) と照合します。

例: zeroclaw hardware discover

使用方法: zeroclaw hardware discover

zeroclaw hardware introspect

シリアル番号またはデバイスパスでデバイスを検査します。

指定されたデバイスパスを開き、ボード情報、ファームウェアバージョン、およびサポートされている機能を照会します。

例: zeroclaw hardware introspect /dev/ttyACM0 zeroclaw hardware introspect COM3

使用方法: zeroclaw hardware introspect <PATH>

引数:

  • <PATH> — シリアルまたはデバイスパス

zeroclaw hardware info

ST-Linkを経由したprobe-rsを使用してUSB経由でチップ情報を取得します。

ターゲットボードにファームウェアを必要とせず、デバッグプローブを通じてターゲットMCUに直接クエリを実行します。

例: zeroclaw hardware info zeroclaw hardware info –chip STM32F401RETx

使用方法: zeroclaw hardware info [OPTIONS]

オプション:

  • --chip <CHIP> — チップ名 (例: STM32F401RETx)。デフォルト: Nucleo-F401REの場合はSTM32F401RETx

    デフォルト値: STM32F401RETx

zeroclaw peripheral

ハードウェア周辺機器を管理します。

エージェントにツール(GPIO、センサー、アクチュエーター)を公開するハードウェアボードを追加、リスト表示、フラッシュ、設定します。サポートされているボード: nucleo-f401re、rpi-gpio、esp32、arduino-uno。

例: zeroclaw peripheral list zeroclaw peripheral add nucleo-f401re /dev/ttyACM0 zeroclaw peripheral add rpi-gpio native zeroclaw peripheral flash –port /dev/cu.usbmodem12345 zeroclaw peripheral flash-nucleo

使用方法: zeroclaw peripheral <COMMAND>

サブコマンド:

  • list — 設定済みの周辺機器をリストします
  • add — 周辺機器を追加します (ボードパス、例: nucleo-f401re /dev/ttyACM0)
  • flash — ZeroClawファームウェアをArduinoにフラッシュします (.inoを作成し、必要に応じてarduino-cliをインストールしてアップロードします)
  • setup-uno-q — Arduino Uno Q Bridgeアプリをセットアップします (エージェント制御用のGPIOブリッジをデプロイします)
  • flash-nucleo — ZeroClawファームウェアをNucleo-F401REにフラッシュします (ビルド + probe-rs実行)

zeroclaw peripheral list

設定済みの周辺機器をリストします

使用方法: zeroclaw peripheral list

zeroclaw peripheral add

ボードタイプとトランスポートパスで周辺機器を追加します。

ハードウェアボードを登録して、エージェントがそのツール(GPIO、センサー、アクチュエーター)を使用できるようにします。Raspberry PiなどのシングルボードコンピューターのローカルGPIOの場合はパスとして’native’を使用します。

サポートされているボード: nucleo-f401re、rpi-gpio、esp32、arduino-uno。

例: zeroclaw peripheral add nucleo-f401re /dev/ttyACM0 zeroclaw peripheral add rpi-gpio native zeroclaw peripheral add esp32 /dev/ttyUSB0

使用方法: zeroclaw peripheral add <BOARD> <PATH>

引数:

  • <BOARD> — ボードタイプ (nucleo-f401re、rpi-gpio、esp32)
  • <PATH> — シリアルトランスポート用パス (/dev/ttyACM0) またはローカルGPIO用の“native“

zeroclaw peripheral flash

ZeroClawファームウェアをArduinoボードにフラッシュします。

.inoスケッチを生成し、arduino-cliがまだ利用できない場合はインストールして、コンパイルし、ファームウェアをアップロードします。

例: zeroclaw peripheral flash zeroclaw peripheral flash –port /dev/cu.usbmodem12345 zeroclaw peripheral flash -p COM3

使用方法: zeroclaw peripheral flash [OPTIONS]

オプション:

  • -p, --port <PORT> — シリアルポート (例: /dev/cu.usbmodem12345)。省略した場合、設定からの最初のarduino-unoを使用します

zeroclaw peripheral setup-uno-q

Arduino Uno Q Bridgeアプリをセットアップします (エージェント制御用のGPIOブリッジをデプロイします)

使用方法: zeroclaw peripheral setup-uno-q [OPTIONS]

オプション:

  • --host <HOST> — Uno Q IP (例: 192.168.0.48)。省略した場合、Uno Q上で実行していることを想定します

zeroclaw peripheral flash-nucleo

ZeroClawファームウェアをNucleo-F401REにフラッシュします (ビルド + probe-rs実行)

使用方法: zeroclaw peripheral flash-nucleo

zeroclaw memory

エージェントメモリエントリを管理します。

エージェントによって保存されたメモリエントリをリスト表示、検査、クリアします。カテゴリとセッション、ページネーション、確認付きバッチクリアによるフィルタリングをサポートします。

例: zeroclaw memory stats zeroclaw memory list zeroclaw memory list –category core –limit 10 zeroclaw memory get KEY zeroclaw memory clear –category conversation –yes

使用方法: zeroclaw memory <COMMAND>

サブコマンド:

  • list — オプションのフィルタでメモリエントリをリスト表示
  • get — キーで特定のメモリエントリを取得
  • stats — メモリバックエンドの統計情報とヘルスを表示
  • clear — カテゴリ、キー、またはすべてのメモリをクリア
  • reindex —

zeroclaw memory list

オプションのフィルタでメモリエントリをリスト表示

使用方法: zeroclaw memory list [OPTIONS]

オプション:

  • --category <CATEGORY>

  • --session <SESSION>

  • --limit <LIMIT>

    デフォルト値: 50

  • --offset <OFFSET>

    デフォルト値: 0

zeroclaw memory get

キーで特定のメモリエントリを取得

使用方法: zeroclaw memory get <KEY>

引数:

  • <KEY>

zeroclaw memory stats

メモリバックエンドの統計情報とヘルスを表示

使用方法: zeroclaw memory stats

zeroclaw memory clear

カテゴリ、キー、またはすべてのメモリをクリア

使用方法: zeroclaw memory clear [OPTIONS]

オプション:

  • --key <KEY> — キーで単一のエントリを削除（プレフィックスマッチをサポート）
  • --category <CATEGORY>
  • --yes — 確認プロンプトをスキップ

zeroclaw memory reindex

使用法: zeroclaw memory reindex

zeroclaw config

ZeroClaw設定を管理します。

ドット記法でのプロパティの表示、設定、初期化を行います。’schema’を使用して設定ファイルの完全なJSONスキーマをダンプします。

プロパティはドット記法でアドレス指定されます（例：channels.matrix.mention-only）。シークレットフィールド（APIキー、トークン）は自動的にマスクされた入力を使用します。列挙型フィールドは値が省略されたときにインタラクティブな選択を提供します。

例: zeroclaw config list # すべてのプロパティを一覧表示 zeroclaw config list –secrets # シークレットのみ一覧表示 zeroclaw config list –filter channels.matrix # プレフィックスでフィルタリング zeroclaw config get channels.matrix.mention-only # 値を取得 zeroclaw config set channels.matrix.mention-only true # 値を設定 zeroclaw config set channels.matrix.access-token # シークレット: マスク入力 zeroclaw config set channels.matrix.stream-mode # 列挙型: インタラクティブ選択 zeroclaw config init channels.matrix # デフォルト値でセクションを初期化 zeroclaw config init risk_profiles.strict # 新しいダイナミックマップエイリアスを作成 zeroclaw config schema # JSON Schema を stdout に出力 zeroclaw config schema > schema.json

プロパティパスのタブ補完はzeroclaw completions <shell>に自動的に含まれます。

使用方法: zeroclaw config <COMMAND>

サブコマンド:

  • schema — 完全な設定 JSON Schema を stdout にダンプします。--path を指定すると、そのプロパティのみのスキーマフラグメントを返します。これは HTTP 経由で OPTIONS /api/config/prop?path=... が返すペイロードと同じです
  • list — すべての設定プロパティを現在の値でリスト表示
  • get — 設定プロパティ値を取得
  • set — 設定プロパティを設定（シークレットフィールドはマスクされた入力を自動プロンプト）
  • init — 未設定セクションをデフォルト値で初期化（enabled=false）
  • migrate — ディスク上の設定を現在のスキーマバージョンに移行します（コメントは保持されます）
  • patch — JSON Patch (RFC 6902) ドキュメントをアトミックに適用します。PATCH /api/config と同等です。指定されたファイルから操作を読み取ります。パスが - の場合、または省略された場合は stdin から読み取ります。サポートされている操作: add, replace, remove, test。move と copy は拒否されます
  • docs — API エクスプローラーの URL を表示（デーモンが実行されていない場合はヒントも表示）
  • generate —

zeroclaw config schema

完全な設定 JSON Schema を標準出力にダンプします。--path を指定すると、そのプロパティのスキーマフラグメントのみを返します。これは HTTP 経由で OPTIONS /api/config/prop?path=... が返すペイロードと同じです。

使用法: zeroclaw config schema [OPTIONS]

オプション:

  • --path <PATH> — スキーマダンプの範囲を限定するプロパティパス（例: agents.researcher.model_provider）。指定しない場合は設定全体のスキーマをダンプします

zeroclaw config list

すべての設定プロパティを現在の値でリスト表示

使用方法: zeroclaw config list [OPTIONS]

オプション:

  • -f, --filter <FILTER> — パスプレフィックスでフィルタ（例：“channels.telegram”）
  • --secrets — シークレット（暗号化）フィールドのみを表示

zeroclaw config get

設定プロパティ値を取得

使用法: zeroclaw config get [OPTIONS] <PATH>

引数:

  • <PATH> — プロパティパス (例: channels.telegram.mention-only)

オプション:

  • --json — プレーンテキストの代わりに、構造化された JSON エンベロープ（{path, value} または {path, populated}）を出力します

zeroclaw config set

設定プロパティを設定します (シークレットフィールドは自動的にマスク入力を求めます)

使用方法: zeroclaw config set [OPTIONS] <PATH> [VALUE]

引数:

  • <PATH> — プロパティパス
  • <VALUE> — 新しい値 (シークレットフィールドの場合は省略してマスク入力を取得)

オプション:

  • --no-interactive — インタラクティブプロンプトをスキップ — コマンドラインで値を要求し、列挙型の場合は生文字列を受け入れます
  • --comment <COMMENT> — TOML 内で値とともに記述するオプションのコメント（今後の編集でも保持されます）
  • --json — 成功時に構造化された JSON エンベロープを出力する

zeroclaw config init

未設定のセクションをデフォルト値で初期化します (enabled=false)

使用法: zeroclaw config init [OPTIONS] [SECTION]

引数:

  • <SECTION> — セクションのプレフィックス（例: channels.matrix）、または新しい動的マップのエイリアスを作成する場合は <section>.<alias>（例: risk_profiles.strict）。すべてを初期化する場合は省略します

オプション:

  • --json — プレーンテキストの代わりに、構造化された JSON エンベロープ（{initialized: [...]}）を出力します

zeroclaw config migrate

ディスク上の設定を現在のスキーマバージョンに移行します（コメントは保持されます）

使用法: zeroclaw config migrate [OPTIONS]

オプション:

  • --json — プレーンテキストの代わりに、構造化された JSON エンベロープ（{migrated, backup_path?, schema_version, valid?, error?}）を出力します

zeroclaw config patch

JSON Patch (RFC 6902) ドキュメントをアトミックに適用します。PATCH /api/config を反映します。指定されたファイル、またはパスが - もしくは省略された場合は stdin から操作を読み込みます。サポートされている ops: add、replace、remove、test。move と copy は拒否されます

使用方法: zeroclaw config patch [OPTIONS] [INPUT]

引数:

  • <INPUT> — JSON Patch ドキュメントへのパス、または標準入力の場合は -（デフォルト）

オプション:

  • --json — 結果を人間が読めるテキストではなく JSON 形式（適用された操作ごとに 1 オブジェクト）で出力します

zeroclaw config docs

API エクスプローラーの URL を表示します（デーモンが実行されていない場合はヒントも表示します）

使用法: zeroclaw config docs

zeroclaw config generate

使用法: zeroclaw config generate [OPTIONS] [VERSION]

引数:

  • <VERSION> — 対象のスキーマバージョン（例: 1, 2, 3）。デフォルトは現在のバージョン

オプション:

  • --encrypt — 出力内のシークレットを含む文字列値（api_key、bot_token、access_token、password、refresh_token など）を暗号化します。キー名ベースのウォーカーにより、すべてのスキーマバージョンで動作します。解決された config-dir の .secret_key を使用します（存在しない場合は作成します）

zeroclaw update

ZeroClaw の更新をチェックして適用します。

デフォルトでは、最新リリースを 6 段階のパイプライン (プリフライト、ダウンロード、バックアップ、検証、スワップ、スモークテスト) でダウンロードしてインストールします。失敗時には自動ロールバックします。

--check を使用して更新をチェックするだけでインストールしません。--force を使用して確認プロンプトをスキップします。--version を使用して最新ではなく特定のリリースをターゲットにします。

例: zeroclaw update # 最新の zeroclaw 更新をダウンロードしてインストール zeroclaw update –check # チェックのみ、インストールしない zeroclaw update –force # 確認なしでインストール zeroclaw update –version 0.6.0 # 特定のバージョンをインストール

使用方法: zeroclaw update [OPTIONS]

オプション:

  • --check — 更新をチェックするだけで、インストールしない
  • --force — ターゲットが新しくない場合でもインストールする（再インストール、または –version へのダウングレード/ピン留め）
  • --version <VERSION> — ターゲットバージョン (デフォルト: 最新)
  • --json — –check と併用すると、人間向けテキストの代わりに機械可読な JSON を出力します

zeroclaw self-test

診断自己テストを実行して ZeroClaw インストールを検証します。

デフォルトでは、ネットワークチェック (ゲートウェイヘルスチェック、メモリ往復) を含むフルテストスイートを実行します。--quick を使用してネットワークチェックをスキップし、より高速なオフライン検証を実行します。

例: zeroclaw self-test # フルスイート zeroclaw self-test –quick # クイックチェックのみ (ネットワークなし)

使用方法: zeroclaw self-test [OPTIONS]

オプション:

  • --quick — クイックチェックのみを実行 (ネットワークなし)

zeroclaw completions

zeroclaw のシェル補完スクリプトを生成します。

スクリプトは stdout に出力されるため、直接ソースすることができます:

例（Unix シェル）：source <(zeroclaw completions bash) zeroclaw completions zsh > ~/.zfunc/_zeroclaw zeroclaw completions fish > ~/.config/fish/completions/zeroclaw.fish

例 (Windows PowerShell): zeroclaw completions powershell | Out-String | Invoke-Expression zeroclaw completions powershell > $PROFILE.CurrentUserAllHosts

使用方法: zeroclaw completions <SHELL>

引数:

  • <SHELL> — ターゲットシェル

    可能な値: bash, fish, zsh, powershell, elvish

zeroclaw desktop

ZeroClaw コンパニオンデスクトップアプリを起動します。

コンパニオンアプリは、CLI と同じゲートウェイに接続する軽量なメニューバー / システムトレイアプリケーションです。ダッシュボードへのクイックアクセス、ステータスモニタリング、デバイスペアリングを提供します。

--install を使用すると、お使いのプラットフォームのダウンロードページが開きます。これはそれ自体では何もインストールしません。

例: zeroclaw desktop # コンパニオンアプリを起動 zeroclaw desktop –install # ダウンロードページを開く

使用方法: zeroclaw desktop [OPTIONS]

オプション:

  • --install — コンパニオンアプリのダウンロードページを開く

zeroclaw locales

アップストリームのリポジトリからロケール用の翻訳済み Fluent (.ftl) カタログを取得し、<config-dir>/data/ftl/<locale>/ 配下にインストールします。ここはランタイムおよび zerocode ローダーが読み込む場所です。

単一のロケールを渡します。デフォルトではすべてのカタログが取得されます。–catalog（カンマ区切り）で制限できます: cli, tools, zerocode。

例: zeroclaw locales fetch ja zeroclaw locales fetch fr –catalog cli,tools zeroclaw locales fetch zh-CN –catalog zerocode

使用方法: zeroclaw locales <COMMAND>

サブコマンド:

  • fetch — アップストリームからロケールの翻訳済み FTL ファイルをダウンロードする

zeroclaw locales fetch

アップストリームからロケールの翻訳済みFTLファイルをダウンロードする

使用法: zeroclaw locales fetch [OPTIONS] <LOCALE>

引数:

  • <LOCALE> — 取得するロケールコード（例: ja、fr、zh-CN）

オプション:

  • --catalog <CATALOG> — 取得するカタログをカンマ区切りで指定します: cli, tools, zerocode。省略するとすべてを取得します

このドキュメントは clap-markdown によって自動生成されました。