Per-agent A2A publication block ([agents.<alias>.a2a]). Gates whether this alias is discoverable as a spec-conforming A2A agent and which resolved skills appear on its card. Default-closed (published = false, no exposed skills). See crate::multi_agent::AgentA2aConfig.

Set it on any surface:

zeroclaw config set agents.<alias>.a2a <value>

export ZEROCLAW_agents__<alias>__a2a=

Initialize this agent’s mcp_bundles tools when it serves an ACP (session/new) session. Off by default: MCP servers are external processes/services that can block startup while they connect, and ACP session/new is expected to return promptly. Enable it when this agent must call its mcp_bundles tools over ACP; session/new then pays the one-time MCP connection cost (bounded and non-fatal per server). Set per agent so each ACP profile opts in independently; when this agent is the ACP default (acp.default_agent, or the sole configured agent), the flag is picked up automatically for sessions that omit agentAlias.

Set it on any surface:

zeroclaw config set agents.<alias>.acp_enable_mcp <value>

export ZEROCLAW_agents__<alias>__acp_enable_mcp=

Channel aliases this agent handles (e.g. ["telegram.<alias>", "discord.<alias>"]). Each entry is a ChannelRef resolving through [channels.<type>.<alias>]; Config::validate() fails loud on dangling references.

Set it on any surface:

zeroclaw config set agents.<alias>.channels <value>

export ZEROCLAW_agents__<alias>__channels=

Optional override for the per-message LLM reply-intent classifier (classify_channel_reply_intent in zeroclaw-channels). When non-empty, the channel orchestrator routes the “should this message be replied to?” classification call to [providers.models.<type>.<alias>] referenced here, instead of reusing the main agent’s model_provider. Source of truth for api_key / uri / model / temperature etc. is the referenced [providers.models.<type>.<alias>] entry. This field is a reference only (NEVER a copy), per AGENTS.md SINGLE SOURCE OF TRUTH. Empty (Default) = inherit the main agent’s resolved provider+model (preserves pre-PR behavior; backward compatible). Use case: classification is a cheap REPLY/NO_REPLY decision, doesn’t need a high-end model. Point this at a fast/free small model (e.g. kimi-k2.5, qwen-turbo) while model_provider stays on the expensive answering model (e.g. qwen3.6-plus). Note: TOML table names cannot contain ., so alias kimi-k2.5 must be written as [providers.models.custom.kimi-k2-5]. The underlying model = "kimi-k2.5" string can still contain dots. ACP channels (IDE-direct) always reply and skip the classifier entirely, so this field has no effect on ACP traffic.

Set it on any surface:

zeroclaw config set agents.<alias>.classifier_provider <value>

export ZEROCLAW_agents__<alias>__classifier_provider=

Cron job aliases. Each entry references cron[key], a declarative scheduled job invoked by the scheduler on its configured trigger. When the cron fires, this agent is the actor that executes the job.

Set it on any surface:

zeroclaw config set agents.<alias>.cron_jobs <value>

export ZEROCLAW_agents__<alias>__cron_jobs=

Auto-allow delegation to every agent sharing this agent’s risk profile. Default true preserves the historical reach where any same-profile peer is a delegation target. Set false to opt this agent out so only the explicit delegates list is reachable. Gating (whether delegation is permitted at all) still lives on the risk profile’s delegation_policy.mode; this only narrows reach.

Set it on any surface:

zeroclaw config set agents.<alias>.delegate_same_risk_profile <value>

export ZEROCLAW_agents__<alias>__delegate_same_risk_profile=

Explicit delegate roster: additional agent aliases this agent may delegate to, beyond same-profile peers. Possibly empty. String entries are accepted for concise manual editing and load as bounded delegates; saved config emits object entries with explicit modes. Entries may name agents on a different risk profile. Config::validate() fails loud on a dangling alias, duplicate alias, or self-reference.

Set it on any surface:

zeroclaw config set agents.<alias>.delegates <value>

export ZEROCLAW_agents__<alias>__delegates=

Per-agent identity format ([agents.<alias>.identity]). Each agent renders its own IDENTITY.md / SOUL.md inside its per-agent workspace; this block selects the format (OpenClaw or AIEOS) and optional inline/file source for the agent’s identity document.

Set it on any surface:

zeroclaw config set agents.<alias>.identity <value>

export ZEROCLAW_agents__<alias>__identity=

Knowledge bundle aliases. Additive: the agent loads every listed bundle.

Set it on any surface:

zeroclaw config set agents.<alias>.knowledge_bundles <value>

export ZEROCLAW_agents__<alias>__knowledge_bundles=

MCP bundle aliases. Each entry references mcp_bundles[key], a named group of MCP servers. Secure by default: an agent is granted only the servers named by its bundles. An agent with no mcp_bundles receives no MCP servers (omission is not a grant). See Config::mcp_servers_for_agent.

Set it on any surface:

zeroclaw config set agents.<alias>.mcp_bundles <value>

export ZEROCLAW_agents__<alias>__mcp_bundles=

Per-agent memory backend selection ([agents.<alias>.memory]). The backend field is locked at agent creation and immutable on subsequent loads. Defaults to Sqlite. See crate::multi_agent::AgentMemoryConfig.

Set it on any surface:

zeroclaw config set agents.<alias>.memory <value>

export ZEROCLAW_agents__<alias>__memory=

Dotted model-provider alias (e.g. "anthropic.<alias>"). Resolves through model_providers.<type>.<alias> at runtime; Config::validate() fails loud on dangling references.

Set it on any surface:

zeroclaw config set agents.<alias>.model_provider <value>

export ZEROCLAW_agents__<alias>__model_provider=

Per-agent reply-intent precheck controls. The classifier call reads this block at message time; model/provider selection stays on classifier_provider so there is only one routing source of truth.

Set it on any surface:

zeroclaw config set agents.<alias>.precheck <value>

export ZEROCLAW_agents__<alias>__precheck=

Risk profile alias (e.g. "default"). Resolves delegation guardrails at runtime.

Set it on any surface:

zeroclaw config set agents.<alias>.risk_profile <value>

export ZEROCLAW_agents__<alias>__risk_profile=

Runtime profile alias (e.g. "default"). Resolves agentic/iteration settings.

Set it on any surface:

zeroclaw config set agents.<alias>.runtime_profile <value>

export ZEROCLAW_agents__<alias>__runtime_profile=

Skill bundle aliases. Each entry resolves to skill_bundles[key].directory at runtime; the agent loads every listed bundle.

Set it on any surface:

zeroclaw config set agents.<alias>.skill_bundles <value>

export ZEROCLAW_agents__<alias>__skill_bundles=

Per-agent override for the context-compression summarizer provider, as a providers.models.<type>.<alias> reference. Empty (Default) = inherit the runtime profile’s context_compression.summary_provider, else the agent’s own resolved provider+model. Reference only, never a copy; resolved by [Config::effective_summary_provider]. Validated in Config::validate().

Set it on any surface:

zeroclaw config set agents.<alias>.summary_provider <value>

export ZEROCLAW_agents__<alias>__summary_provider=

Transcription / STT provider as a dotted alias reference (<type>.<alias>, e.g. "groq.<alias>"). Resolves through transcription_providers.<type>.<alias>. Empty = agent has no transcription preference; channels that ingest voice still need a resolved provider (there is no global default), so an inbound voice flow into an agent with empty transcription_provider errors loudly at the channel boundary.

Set it on any surface:

zeroclaw config set agents.<alias>.transcription_provider <value>

export ZEROCLAW_agents__<alias>__transcription_provider=

TTS provider as a dotted alias reference (<type>.<alias>, e.g. "openai.<alias>"). Resolves through tts_providers.<type>.<alias>. Empty = no TTS for this agent (there is no global default-provider concept; every agent that wants TTS sets its own tts_provider).

Set it on any surface:

zeroclaw config set agents.<alias>.tts_provider <value>

export ZEROCLAW_agents__<alias>__tts_provider=

Per-agent workspace block ([agents.<alias>.workspace]). Holds the agent’s filesystem path, cross-agent access allowlist, filesystem-escape boolean, and cross-agent memory allowlist. Default is fully jailed (no cross-agent access). See crate::multi_agent::AgentWorkspaceConfig.

Set it on any surface:

zeroclaw config set agents.<alias>.workspace <value>

export ZEROCLAW_agents__<alias>__workspace=