openclaw configure

通过交互式提示对现有设置进行针对性更改：凭据、设备、智能体默认值、Gateway 网关、渠道、插件、Skills 和健康检查。

使用 openclaw onboard 或 openclaw setup 完成首次运行的完整引导流程；使用 openclaw setup --baseline 仅设置基础配置和工作区；如果只需设置渠道账户，请使用 openclaw channels add。

选项

--section <section>：可重复指定的分区筛选器。可用分区：

workspace、model、web、gateway、daemon、channels、plugins、skills、health

openclaw configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

选择 gateway、daemon 或 health（或不带 --section 运行完整向导）时，系统会询问 Gateway 网关的运行位置并更新 gateway.mode。如果分区筛选器跳过了这三个分区，则会直接进入请求的设置流程，不显示 Gateway 网关模式提示。选择远程 Gateway 网关模式会写入远程配置并立即退出；它不会执行插件安装等仅限本地的步骤。

模型分区

当配置流程从提供商身份验证选项开始时，默认模型和允许列表选择器会自动优先显示该提供商。对于 Volcengine 和 BytePlus 等成对的提供商，同一偏好也会匹配其编程计划变体（volcengine-plan/*、byteplus-plan/*）。如果按首选提供商筛选后列表为空，配置流程会回退到未筛选的目录，而不会显示空白选择器。

Web 分区

openclaw configure --section web 用于选择 Web 搜索提供商并配置其凭据。部分提供商会显示特定于提供商的后续选项：

• Grok 可以选择使用同一个 xAI OAuth 配置文件或 API key 设置可选的 x_search，并允许你选择 x_search 模型。
• Kimi 可以要求选择 Moonshot API 区域（api.moonshot.ai 或 api.moonshot.cn）以及默认的 Kimi Web 搜索模型。

其他说明

• 写入本地配置后，如果所选设置路径需要，配置流程会安装选定的可下载插件。远程 Gateway 网关配置不会安装本地插件包。
• 面向渠道的服务（Slack/Discord/Matrix/Microsoft Teams）会在设置期间提示配置渠道/房间允许列表。你可以输入名称或 ID；向导会尽可能将名称解析为 ID。
• 如果运行守护进程安装步骤，令牌身份验证需要令牌。如果 gateway.auth.token 由 SecretRef 管理，配置流程会验证 SecretRef，但不会将解析后的明文令牌值持久化到监督程序服务的环境元数据中；如果 SecretRef 无法解析，配置流程会阻止安装守护进程，并提供可操作的修复指导。
• 如果同时配置了 gateway.auth.token 和 gateway.auth.password，但未设置 gateway.auth.mode，配置流程会阻止安装守护进程，直到你明确设置该模式。

相关内容

• CLI 参考
• 配置
• 配置 CLI：配置