エージェントの構造
エージェントは単一の [agents.<alias>] ブロックとして構成されます。各フィールドは、他の場所で構成された何かへの参照か、エージェントごとのオーバーライドのいずれかです。以下の表は構成スキーマから生成されるため、常に実行中のビルドと一致します。フィールドをクリックすると展開され、もう一度クリックすると設定方法が表示されます。
a2a
エージェントごとの A2A 公開ブロック([agents.<alias>.a2a])。このエイリアスが仕様準拠の A2A エージェントとして検出可能かどうか、およびそのカードにどの解決済みスキルが表示されるかを制御します。デフォルトは非公開(published = false、公開スキルなし)です。crate::multi_agent::AgentA2aConfig を参照してください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.a2a フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.a2a フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.a2a <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__a2a=
acp_enable_mcp
このエージェントが ACP (session/new) セッションを提供するときに、その mcp_bundles ツールを初期化します。デフォルトではオフ: MCP サーバーは外部のプロセス/サービスであり、接続中に起動をブロックする可能性があり、ACP の session/new は迅速に返すことが期待されています。このエージェントが ACP 経由でその mcp_bundles ツールを呼び出す必要がある場合に有効にしてください。その場合、session/new は一度きりの MCP 接続コストを負担します(サーバーごとに有界で、致命的ではありません)。エージェントごとに設定するため、各 ACP プロファイルが独立してオプトインします。このエージェントが ACP のデフォルト(acp.default_agent、または設定済みの唯一のエージェント)である場合、agentAlias を省略したセッションではフラグが自動的に適用されます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.acp_enable_mcp フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.acp_enable_mcp フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.acp_enable_mcp <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__acp_enable_mcp=
channels
このエージェントが処理するチャネルエイリアス(例: ["telegram.<alias>", "discord.<alias>"])。各エントリは [channels.<type>.<alias>] を介して解決される ChannelRef です。Config::validate() は未解決の参照に対して明示的に失敗します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.channels フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.channels フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.channels <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__channels=
classifier_provider
メッセージごとのLLM返信意図分類器(zeroclaw-channels内のclassify_channel_reply_intent)の任意のオーバーライド。空でない場合、チャネルオーケストレーターは「このメッセージに返信すべきか?」という分類呼び出しを、メインエージェントのmodel_providerを再利用する代わりに、ここで参照される[providers.models.<type>.<alias>]にルーティングします。api_key / uri / model / temperature などの信頼できる情報源は、参照される[providers.models.<type>.<alias>]エントリです。このフィールドは参照のみ(決してコピーではない)であり、AGENTS.mdのSINGLE SOURCE OF TRUTHに従います。空(Default)の場合は、メインエージェントの解決済みプロバイダー+モデルを継承します(PR前の動作を保持し、後方互換性があります)。ユースケース: 分類は安価なREPLY/NO_REPLYの判断であり、高性能なモデルを必要としません。model_providerを高価な回答用モデル(例: qwen3.6-plus)に維持したまま、これを高速/無料の小型モデル(例: kimi-k2.5、qwen-turbo)に向けてください。注意: TOMLのテーブル名には.を含めることができないため、エイリアスkimi-k2.5は[providers.models.custom.kimi-k2-5]として記述する必要があります。基になるmodel = "kimi-k2.5"文字列にはドットを含めることができます。ACPチャネル(IDE直結)は常に返信し、分類器を完全にスキップするため、このフィールドはACPトラフィックに影響しません。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて、agents.<alias>.classifier_provider フィールドを設定してください。
zerocode
Config ペインで、agents.<alias>.classifier_provider フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.classifier_provider <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__classifier_provider=
cron_jobs
Cron ジョブのエイリアス。各エントリは cron[key] を参照します。これは、設定されたトリガーに基づいてスケジューラーによって呼び出される宣言的なスケジュール済みジョブです。cron が発火すると、このエージェントがジョブを実行するアクターとなります。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて agents.<alias>.cron_jobs フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.cron_jobs フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.cron_jobs <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__cron_jobs=
delegate_same_risk_profile
このエージェントのリスクプロファイルを共有するすべてのエージェントへの委任を自動的に許可します。デフォルトの true は、同一プロファイルのピアであれば委任先となる従来の到達範囲を維持します。false に設定するとこのエージェントを除外し、明示的な delegates リストのみが到達可能になります。ゲーティング(委任が許可されるかどうか)は引き続きリスクプロファイルの delegation_policy.mode で管理されます。この設定は到達範囲を狭めるだけです。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて、agents.<alias>.delegate_same_risk_profile フィールドを設定してください。
zerocode
Config ペインで、agents.<alias>.delegate_same_risk_profile フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.delegate_same_risk_profile <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__delegate_same_risk_profile=
delegates
明示的なデリゲート名簿: 同一プロファイルのピア以外に、このエージェントが委譲できる追加のエージェントエイリアス。空の場合もある。文字列エントリは簡潔な手動編集のために受け入れられ、制限付きデリゲートとして読み込まれる。保存された設定は明示的なモード付きのオブジェクトエントリを出力する。エントリは異なるリスクプロファイルのエージェントを指定できる。Config::validate() はダングリングエイリアス、重複エイリアス、または自己参照で明確に失敗する。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて、agents.<alias>.delegates フィールドを設定してください。
zerocode
Config ペインで、agents.<alias>.delegates フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.delegates <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__delegates=
identity
エージェントごとのアイデンティティ形式 ([agents.<alias>.identity])。各エージェントは、エージェントごとのワークスペース内に独自の IDENTITY.md / SOUL.md をレンダリングします。このブロックでは、形式 (OpenClaw または AIEOS) と、エージェントのアイデンティティドキュメントのオプションのインライン/ファイルソースを選択します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて、agents.<alias>.identity フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.identity フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.identity <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__identity=
knowledge_bundles
ナレッジバンドルのエイリアス。追加方式: エージェントは列挙されたすべてのバンドルを読み込みます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.knowledge_bundles フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.knowledge_bundles フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.knowledge_bundles <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__knowledge_bundles=
mcp_bundles
MCP バンドルエイリアス。各エントリは mcp_bundles[key] を参照し、MCP サーバーの名前付きグループです。デフォルトでセキュア: エージェントには、そのバンドルで指定されたサーバーのみが付与されます。mcp_bundles のないエージェントは MCP サーバーを受け取りません(省略は付与ではありません)。Config::mcp_servers_for_agent を参照してください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.mcp_bundles フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.mcp_bundles フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.mcp_bundles <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__mcp_bundles=
memory
エージェントごとのメモリバックエンド選択([agents.<alias>.memory])。backend フィールドはエージェント作成時に固定され、以降の読み込みでは変更できません。デフォルトは Sqlite です。crate::multi_agent::AgentMemoryConfig を参照してください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.memory フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.memory フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.memory <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__memory=
model_provider
ドット区切りのモデルプロバイダーエイリアス(例: "anthropic.<alias>")。実行時に model_providers.<type>.<alias> を通じて解決されます。Config::validate() は無効な参照に対して明示的にエラーを発生させます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.model_provider フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.model_provider フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.model_provider <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__model_provider=
precheck
エージェントごとの返信意図の事前チェック制御。分類器の呼び出しはメッセージ処理時にこのブロックを読み取ります。モデル/プロバイダーの選択は classifier_provider に集約されているため、ルーティングの信頼できる唯一の情報源が保たれます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.precheck フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.precheck フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.precheck <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__precheck=
risk_profile
リスクプロファイルのエイリアス(例: "default")。実行時に委任のガードレールを解決します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて、agents.<alias>.risk_profile フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.risk_profile フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.risk_profile <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__risk_profile=
runtime_profile
ランタイムプロファイルのエイリアス(例: "default")。エージェント/イテレーション設定を解決します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて agents.<alias>.runtime_profile フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.runtime_profile フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.runtime_profile <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__runtime_profile=
skill_bundles
スキルバンドルのエイリアス。各エントリは実行時に skill_bundles[key].directory に解決され、エージェントはリストされたすべてのバンドルを読み込みます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて agents.<alias>.skill_bundles フィールドを設定してください。
zerocode
Config ペインで、agents.<alias>.skill_bundles フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.skill_bundles <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__skill_bundles=
summary_provider
コンテキスト圧縮のサマライザープロバイダーに対するエージェント単位のオーバーライド。providers.models.<type>.<alias> 参照として指定します。空 (Default) = ランタイムプロファイルの context_compression.summary_provider を継承し、それ以外の場合はエージェント自身の解決済みプロバイダー+モデルを使用します。参照のみで、コピーは行われません。[Config::effective_summary_provider] によって解決されます。Config::validate() で検証されます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.summary_provider フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.summary_provider フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.summary_provider <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__summary_provider=
transcription_provider
文字起こし / STT プロバイダーをドット付きエイリアス参照(<type>.<alias>、例: "groq.<alias>")として指定します。transcription_providers.<type>.<alias> を通じて解決されます。空の場合 = エージェントは文字起こしの設定を持ちません。音声を取り込むチャンネルには依然として解決済みのプロバイダーが必要であり(グローバルなデフォルトは存在しません)、そのため transcription_provider が空のエージェントへの受信音声フローは、チャンネル境界で明示的にエラーになります。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開き、agents.<alias>.transcription_provider フィールドを設定します。
zerocode
Config ペインで、agents.<alias>.transcription_provider フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.transcription_provider <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__transcription_provider=
tts_provider
ドット区切りのエイリアス参照(<type>.<alias>、例: "openai.<alias>")としてのTTSプロバイダー。tts_providers.<type>.<alias> を通じて解決されます。空 = このエージェントではTTSを使用しません(グローバルなデフォルトプロバイダーという概念は存在しません。TTSを使用したいエージェントはそれぞれ独自の tts_provider を設定します)。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて、agents.<alias>.tts_provider フィールドを設定してください。
zerocode
Configペインで、agents.<alias>.tts_providerフィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.tts_provider <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__tts_provider=
workspace
エージェントごとのワークスペースブロック([agents.<alias>.workspace])。エージェントのファイルシステムパス、エージェント間アクセス許可リスト、ファイルシステムエスケープのブール値、エージェント間メモリ許可リストを保持します。デフォルトは完全に隔離された状態(エージェント間アクセスなし)です。crate::multi_agent::AgentWorkspaceConfig を参照してください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/agents を開いて agents.<alias>.workspace フィールドを設定してください。
zerocode
Config ペインで、agents.<alias>.workspace フィールドを設定します。
zeroclaw config
zeroclaw config set agents.<alias>.workspace <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_agents__<alias>__workspace=
参照先
エージェントの設定の大部分は、それぞれ独自のセクションで設定されたものを指すドット区切りのエイリアスです。エージェントはそれらのいずれも所有せず、ただ参照するだけであり、同じターゲットを複数のエージェントで共有できます。上記のフィールド表が正式な一覧です。以下は、各種類の参照がどこへつながるかを示します:
- プロバイダー (Model Providers): エージェントのチャットモデルと、それに付随するテキスト読み上げ、文字起こし、分類器の各プロバイダーは、それぞれ
[providers.models.<type>.<alias>]エントリを指定します。 - プロファイル(セキュリティと自律性): リスクプロファイルは自律性とサンドボックスの姿勢を設定し、ランタイムプロファイルは運用上のチューニング(ツール反復の上限、予算、タイムアウト、コンテキスト制限)を設定します。
- チャネル (Channels): エージェントが応答するメッセージングサーフェスです。2つのエージェントがチャネルを共有する場合、ピアグループが互いに通信できるかどうかを決定します。
- バンドル (ツール): エイリアスで関連付けられる、スキル・ナレッジ・MCP サーバーの再利用可能なグループ。
- Cron: エージェントにバインドされた名前付きスケジュールジョブ。
エージェントごとのオーバーライド
エージェントの設定の一部は参照ではなく、グローバルなデフォルトを上書きするエージェントごとのブロックです。具体的には、ワークスペース、メモリ、アイデンティティです。これらは結合のディスク上の側面であり、Filesystemコンポーネントで説明しています。
検証
Config::validate() は、model_provider が設定済みのプロバイダーエントリに解決されない場合、または risk_profile が設定済みのリスクプロファイルに解決されない場合、起動時に明示的なエラーで失敗します。不正な参照は、エージェントの実行前に検出され、暗黙的に無視されることはありません。