組み込みツールインベントリ
エージェントが呼び出し可能なツールを、コアバイナリに残すか、機能ゲート化するか、WASMプラグインに移すか、スキルパッケージとして提供するか、あるいはMCPまたはCLIバックエンドの統合を使用するかを判断する際に、このページを参照してください。
これは分類マップであり、削除計画ではありません。置き換えによってオペレーター契約（設定、セキュリティポリシー、ツールレシート、監査可視性、互換性、ロールバック）が維持されるまで、ツールを削除または外部化しないでください。
ランタイムレジストリの信頼できる情報源は crates/zeroclaw-runtime/src/tools/mod.rs で、特に default_tools、all_tools_with_runtime、register_skill_tools_with_context_and_runtime です。共有ツールの実装は主に crates/zeroclaw-tools/ 配下にあります。
分類バケット
| バケット | 意味 | 次のアクション |
|---|---|---|
| 組み込みを保持 | ベースラインエージェント契約の一部、またはランタイムポリシー、レシート、メモリ、セッション、デリゲーションに密接に結合している。 | エージェント契約が RFC を通じて変更されない限り、コアに保持する。 |
| フィーチャーゲート候補 | ファーストパーティの動作は引き続き ZeroClaw に属しますが、依存関係、プラットフォーム、バイナリサイズ、またはオペレーターリスクのコストは最小ビルドに影響を与えるべきではありません。 | 削除を検討する前に、機能/設定ゲートを追加または厳格化する。 |
| 後で外部化する | 有用な機能ですが、その動作の大部分は製品、ベンダーAPI、またはオプションのワークフローをラップするものであるため、長期的な所有者はプラグイン、スキルパッケージ、MCPサーバー、または外部CLIであるべきです。 | 外部サーフェスが実際のものとなり、ドキュメント化されるまで互換性を維持する。 |
| まだアクションはありません | 現在の証拠は、別のホームを選択するには不十分です。 | そのまま残し、ソース、使用状況、および置き換えの証拠とともに再検討する。 |
組み込みを保持
これらのツールは、ローカルエージェントの最小限の作業領域を構成します。これらは default_tools によって登録され、さらに完全なレジストリによっても登録されます。
| ツール | なぜ彼らは留まるのか |
|---|---|
shell | ZeroClaw のシェルポリシー、サンドボックス、ランタイムアダプター、パスガード、およびレシートの下でローカルコマンドを実行します。 |
file_read、file_write、file_edit | ワークスペースファイル契約、永続化の振る舞い、パスガード、および監査サーフェスを所有する。 |
glob_search、content_search | シェル固有のコマンド構文を必要とせずにローカル検出を提供します。 |
これらのフルレジストリツールも、オプションのプロダクト統合ではなく、ランタイム、メモリ、協調、またはオペレーター制御のプリミティブであるため、組み込みのままにしておく必要があります。
| ツール | なぜ彼らは留まるのか |
|---|---|
memory_store、memory_recall、memory_forget、memory_export、memory_purge | 長期記憶はファーストパーティのランタイムコントラクトであり、共有メモリの所有権ルールを使用します。 |
cron_add、cron_list、cron_remove、cron_update、cron_run、cron_runs、schedule | スケジューリングは自律実行、所有権、実行履歴に影響するため、コア内でポリシーとして可視化しておく。 |
spawn_subagent、delegate、send_message_to_peer | 委譲はエージェント実行モデルの一部であり、リスクプロファイル、ツール、メモリ、および親/子の制約を共有する必要があります。 |
ask_user、escalate_to_human、reaction、poll、channel_room | これらは、遅延バインドされたチャネルハンドルとレシートを備えた、チャネルブリッジング演算子の相互作用プリミティブです。 |
sessions_current, sessions_list, sessions_history, sessions_send | セッションの可視性とメッセージ送信は、デーモン/ゲートウェイのセッションバックエンドとエージェントの所有権境界を共有する必要があります。 |
model_routing_config、model_switch、proxy_config | これらは現在のモデル/プロキシのルーティング制御プレーンを公開するものであり、config-source の動作から逸脱すべきではありません。 |
TodoWrite | ランタイムツールサーフェス内でエージェントの構造化タスクリストを管理します。安定したツール名とライフサイクル動作をコアに維持してください。 |
read_skill と、kind = "shell"、kind = "http"、または kind = "builtin" を持つスキル定義ツール | スキルは意図された拡張ポイントですが、インストールされたスキルをツールに変換するランタイムブリッジはコアです。 |
フィーチャーゲート候補
これらのツールは現在ファーストパーティですが、プラットフォーム、依存関係、ネットワーク、UI の対象範囲を拡張するため、明示的な機能/設定の境界を設けるべきです。
| ツール | 境界 | 分類 |
|---|---|---|
browser、browser_open、browser_delegate、text_browser | 設定でゲートされ、ランタイムに依存する。 | ファーストパーティを維持するが、ブラウザ自動化は大きな信頼サーフェスであるため、機能/設定ゲートの締め付けを継続する。 |
http_request, web_fetch, web_search_tool | 設定でゲートされたネットワークアクセス。 | SSRF、許可リスト、プロバイダー ルーティング、およびレシートの動作が ZeroClaw 所有のままである間は first-party を維持する。MCP/プラグインの代替が同じネットワーク ポリシーを表現できるようになった後でのみ再検討する。 |
SOPツール（sop_list、sop_execute、sop_advance、sop_approve、sop_status、および条件付き sop_workshop） | ランタイムハンドルでゲート制御され、sop_workshop には手続き記憶も必要です。 | ファーストパーティに保つこと。SOP のライフサイクル、承認、手続き記憶、監査記録はランタイムの状態であり、汎用的な外部連携ではありません。 |
| WASMプラグインツール | コンパイルフィーチャーおよび設定でゲートされたホストブリッジ。 | ホストブリッジはファーストパーティのままにし、個々のプラグイン機能はコアの外に置く。 |
execute_pipeline | 設定ゲート付きツール チェイニング。 | ツールチェイニングポリシー、ステップごとのレシート、および呼び出し元の許可リストがコアかどうかを判断できるほど安定するまで、ゲート付きのままにする。 |
knowledge | 設定でゲートされたナレッジサーフェス。 | リレーションシップメモリとグラフワークフローがユーザー向けドキュメントとスキルにまだプロモートされている間は、ゲートされたままにしてください。 |
file_upload、file_upload_bundle、file_download | 設定でゲートされたデータ移動。 | ゲートされたままにする; これらはポリシーに敏感なデータ移動ツールであり、外部化前に明示的な置き換えが必要です。 |
backup, data_management | ローカル状態のミューテーションサーフェス | 通常のファイル編集フローの外で両方がローカル状態を変更するため、より明確な機能/設定の境界を検討してください。 |
screenshot, image_info, canvas | ビジュアル/UI ツールサーフェス。 | 当面は保持する。プラグインとダッシュボードの境界が落ち着いたら、ビジュアル/UIツールサーフェスで分類する。 |
llm_task | プロバイダー依存のサブタスク実行。 | プロバイダースコープのサブタスク実行が委譲とは別の契約を持つまで保持する。 |
security_ops | 設定でゲートされたセキュリティ操作。 | ゲートされたままにする。セキュリティ運用には、プラグインが同等のパーミッション、レシート、ロールバックをアドバタイズできるようになるまで、ファーストパーティのポリシー可視性が必要です。 |
verifiable_intent | 設定で制御される信頼ポリシー。 vi_verify ツールはモデルから見えるレジストリから一時的に除外されています。 | ゲート制御を維持し、ファーストパーティに限定してください。インテントの発行と検証は信頼ポリシーに影響するため、認証情報の境界が安定するまではファーストパーティのままにする必要があります。チェーン検証器はまだ存在しないため、vi_verify は verifiable_intent.enabled = true の場合でも登録されません。現時点でこのセクションを有効にしても、その不足を示す警告がプロセス起動時に記録され、各デーモンの再読み込み時に再度記録され、さらに zeroclaw config patch によってセクションが無効から有効に切り替えられたときにもう一度記録されるだけです。この警告は、zeroclaw doctor と設定 API によって verifiable_intent_tool_withheld バリデーション警告として報告されるため、observability.log_persistence = "none" でも保持されます。ツールを保留しても、発行および検証のライブラリパスは削除されず、埋め込み側では引き続き利用できます。検証済みチェーン結果を消費する検証・評価パスの背後でのみ登録を復元し、同じ変更で両方の経路を廃止してください。 |
ハードウェアプローブ (hardware_board_info、hardware_memory_map、hardware_memory_read) | 周辺機器で制御されるハードウェアアクセス。 | ファーストパーティを維持しつつ、ハードウェアツールはペリフェラルレジストリパス経由で追加され、ZeroClaw の権限ルールの下で物理デバイスにアクセスします。 |
後で外部化
これらは、代替となる仕組みが用意された時点でコアバイナリから切り離す最有力候補です。それまでは、互換性を保ち、ポリシー上も可視な状態を維持してください。
| ツール | おそらく長期的なホーム | なぜ |
|---|---|---|
notion、jira、microsoft365、google_workspace、linkedin、composio | プラグイン、MCPサーバー、またはCLIベースの統合。 | これらは主に、コアランタイムとは独立して進化しうるサードパーティ製品や認証モデルをラップしています。 |
claude_code, claude_code_runner, codex_cli, gemini_cli, opencode_cli | CLI ベースの統合またはスキルパッケージ。 | 外部CLIは認証、コマンドの動作、リリースの周期をすでに管理しています。ZeroClawがそれらを呼び出す場合は、レシートとポリシーを保持すべきです。 |
email_search, email_read | Channel コンパニオンプラグインまたは MCP サーバー。 | メールの検索/読み取りは有用ですが、ベースラインのエージェント契約ではなく、外部アカウント認証とチャネル設定に結びついています。 |
discord_search | Channel コンパニオンプラグインまたは archive-query スキル。 | チャンネルによって生成されたDiscordアーカイブデータベースに依存します。アーカイブAPIが明示されるまで、そのチャンネルの近くに置いておいてください。 |
image_gen、cloud_ops、cloud_patterns、project_intel、report_template | スキルパッケージ、プラグイン、または MCP サーバー。 | これらは、コア実行プリミティブというよりも、オプションのワークフローやベンダー/データサービスのラッパーです。 |
weather | スキルパッケージまたは HTTP ベースのスキル。カスタムフォーマットやポリシーの同等性が必要な場合は、後でプラグインまたは MCP サーバーを検討します。 | 現在の組み込み機能は、キー不要の wttr.in ラッパーです。最小限のルックアップは HTTP スキルの形態に適合しますが、完全な外部化には、フォーマット済み出力、tool.weather プロキシポリシー、および組み込みツール名／自動承認の動作に関する同等性が依然として必要です。 |
pushover | system.notify を経由する共通の通知パスと、狭くスコープされたサービスプラグイン。 | そのコアの形状はデバイス通知であり、標準のノード機能と重複しています。Pushover固有の認証、配信、障害モード、およびアダプター互換性は、コアランタイムの外に移す前にまだ証明が必要です。 |
git_operations | CLI ベースの統合または狭いスコープのプラグイン。 | ローカルおよびリモートリポジトリの副作用があるため、外部の置き換えはすべてポリシーチェック、レシート、および明示的なオペレーター可視性を保持しなければなりません。 |
まだアクションはありません
これらのサーフェスは、別のデザインスライスがより良い証拠を生み出すまでそのままにしておいてください：
calculator: 小さく、依存関係が少なく、無害であるため、外部に移動すると節約される以上に複雑さが増す可能性があります。tool_searchと遅延MCPアクティベーション：現在のMCPディスカバリーフローの一部ですが、正確な長期的な境界はv0.8.2のプラグイン/MCP作業に依存します。- セッションのリセット/削除ツール: 実装は存在しますが、エージェントレジストリはデフォルトでは破壊的なスコープ外のバリアントを登録しません。オペレーター/管理者向けのインターフェイスで明示的に必要とされない限り、その境界を維持してください。
マイグレーションルール
コアからツールを移動する前に、代替は次に答える必要があります：
- どの設定がファーストパーティのまま残り、どの設定がプラグイン、スキル、MCP サーバー、または CLI に移動しますか？
- 置換は、自律性チェック、許可/拒否リスト、ツールレシート、監査ログ、およびアトリビューションをどのように保持しますか？
- 組み込みツールが消えた場合、既存の設定はどのように失敗または移行しますか？
- オペレーターは、機能がインストール済み、有効、無効、ブロック済み、または欠落していることを確認できますか？
- 外部パッケージが壊れた場合のロールバック手順は何ですか？
将来のスライスでコードによる証明が必要な場合は、Externalize later テーブルから影響範囲の小さい候補を1つ選び、同じ PR で組み込みツールを削除することなく置き換えパスを証明する。