配置 — 智能体

agents.*、multiAgent.*、session.*、messages.* 和 talk.* 下的智能体级配置键。有关渠道、工具、网关运行时及其他顶级键，请参阅配置参考。

OpenClaw 在创建多智能体集群时会标记 agents.ownership: "explicit"。此类集群没有默认目标：渠道和常驻服务需要绑定或特定界面的 agentId 目标。Doctor 会在升级期间物化旧版所有者；单智能体配置无需标记。

全新安装时，交互式引导会询问第一个智能体的名称，并以 main 作为建议值。自动引导沿用历史 main 默认值，除非你传入 openclaw onboard --non-interactive --agent-name <name> ...。唯一命名智能体与 main 使用相同的默认工作区和共享认证存储；引导在完成前还会将旧版 agent:main:* 会话历史迁移到该唯一所有者名下。

main 是一个普通智能体 ID。在命名智能体拥有该安装后，复用 main 会受到保护，从而确保旧数据不会被静默采用：legacy-session-migration-required 表示 openclaw doctor --fix 必须完成或隔离旧版 agent:main:* 声明，而 shared-auth-store-owned-by-main 表示 Doctor 必须先将共享认证存储迁移到 state/openclaw.sqlite。两项修复完成后，新的 main 会像其他任何智能体一样获得全新的智能体级会话和认证存储。

每页涵盖的内容¶

• 配置 — 智能体工作区与引导 — 工作区、cwd、仓库根目录、技能、引导注入、上下文预算、图像和时区。
• 配置 — 智能体模型 — agents.defaults.model、回退链、按用途的模型槽位及模型选择范围。
• 配置 — 智能体运行时与 CLI 后端 — 提供商和模型的运行时策略、CLI 后端选择及 GPT-5 个性。
• 配置 — 智能体心跳、压缩与流式传输 — 心跳运行、系统智能体、压缩、上下文剪枝、块流式传输和输入指示器。
• 配置 — 智能体沙箱 — agents.defaults.sandbox 块：镜像、工作区模式、挂载和网络策略。
• 配置 — 智能体级条目与多智能体路由 — agents.entries 覆盖、multiAgent 绑定、绑定匹配字段和访问配置文件。
• 配置 — 智能体会话 — session.* 范围、身份关联、重置策略、共享和保留。
• 配置 — 消息与 talk — messages.* 传递、前缀、确认反应、排队、TTS 和 talk.* 默认值。

各章节迁移位置¶

本页面此前发布的每个标题都在此保留锚点，因此诸如 /gateway/config-agents#agents.defaults.model 之类的现有链接仍然有效。每个条目都指向现在承载相应内容的页面。

• 智能体默认值
• agents.defaults.workspace
• agents.defaults.cwd
• agents.defaults.repoRoot
• agents.defaults.skills
• agents.defaults.skipBootstrap
• agents.defaults.skipOptionalBootstrapFiles
• agents.defaults.contextInjection
• agents.defaults.bootstrapMaxChars
• agents.defaults.bootstrapTotalMaxChars
• 智能体级引导配置文件覆盖
• 引导截断通知
• 上下文预算所有权映射
• agents.defaults.startupContext
• agents.defaults.contextLimits
• agents.entries.*.contextLimits
• skills.limits.maxSkillsPromptChars
• agents.entries.*.skillsLimits.maxSkillsPromptChars
• agents.defaults.imageMaxDimensionPx
• agents.defaults.imageQuality
• agents.defaults.userTimezone
• agents.defaults.model
• agents.defaults.modelSelectionScope
• agents.defaults.modelSelectionScope
• 运行时策略
• CLI 后端选择
• OpenAI GPT-5 个性
• agents.defaults.heartbeat
• agents.defaults.systemAgent
• agents.defaults.compaction
• agents.defaults.contextPruning
• cache-ttl 模式行为
• 块流式传输
• 输入指示器
• agents.defaults.sandbox
• agents.defaults.sandbox
• 沙箱详情
• agents.entries（智能体级覆盖）
• agents.entries（智能体级覆盖）
• 多智能体路由
• 绑定匹配字段
• 智能体级访问配置文件
• 完全访问（无沙箱）
• 只读工具 + 工作区
• 无文件系统访问（仅消息）
• 会话
• 会话字段详情
• 消息
• 响应前缀
• 确认反应
• 队列
• 入站防抖
• 其他消息键
• TTS（文本转语音）

• Talk

• 配置参考 — 所有其他配置键

• 配置 — 常见任务与快速设置
• 配置示例
• 模型提供商 — 提供商设置与模型目录
• 智能体绑定 — 频道账户和用户如何选择智能体
• 配置 — 频道 — 对应的 channels.* 参考