diff --git a/docs/gateway/config-agents.md b/docs/gateway/config-agents.md index 3932c29acd0f..094acb5086a2 100644 --- a/docs/gateway/config-agents.md +++ b/docs/gateway/config-agents.md @@ -588,7 +588,7 @@ Selects the agent whose model and credentials own ambient OpenClaw system work: } ``` -An explicit request `agentId` always wins. Delegated consults with a requesting agent keep that requester as their owner. Surfaces that enumerate or narrow across agents deliberately do not adopt this owner, because silently picking one agent would hide the others: session-store selection (`openclaw sessions`) and `openclaw hooks` status still require `--agent ` (or `--all-agents`). When `systemAgent.agentId` is absent, a sole configured agent resolves implicitly; ambient work in a multi-agent fleet then fails with an actionable error, except queued-delivery recovery, which records the failing delivery and keeps draining the rest of the queue. Upgrade-only ownership lives at `agents.defaults.authInheritance.agentId` for inherited credentials and `agents.defaults.sessionStore.agentId` for retired `main` session rows or unscoped rows in a fixed `session.store`. +An explicit request `agentId` always wins. Delegated consults with a requesting agent keep that requester as their owner. The four reads above opt in individually; other agent-scoped Gateway methods, such as `tools.*`, `commands.*`, chat history, and session-catalog reads, do not use this setting as a general default. Surfaces that pick one agent's view also keep requiring an explicit choice, because silently adopting this owner would hide the other agents: `openclaw sessions` (add `--agent ` or `--all-agents`), `openclaw hooks` status, `openclaw models`, stored session lookup by id, and TUI startup. When `systemAgent.agentId` is absent, a sole configured agent resolves implicitly; ambient work in a multi-agent fleet then fails with an actionable error, except queued-delivery recovery, which records the failing delivery and keeps draining the rest of the queue. Upgrade-only ownership lives at `agents.defaults.authInheritance.agentId` for inherited credentials and `agents.defaults.sessionStore.agentId` for retired `main` session rows or unscoped rows in a fixed `session.store`. ### `agents.defaults.compaction`