openclaw configure
用于对现有设置进行定向更改的交互式提示：凭证、设备、智能体默认值、Gateway 网关、渠道、插件、技能和健康检查。
完整的首次运行引导流程请使用 openclaw onboard 或 openclaw setup，仅创建基线配置/工作区请使用 openclaw setup --baseline，只需要设置渠道账号时请使用 openclaw channels add。
选项
--section <section>：可重复的部分筛选器。可用部分：
workspace, model, web, gateway, daemon, channels, plugins, skills, health
gateway、daemon 或 health（或不带 --section 运行完整向导）时，会提示 Gateway 网关运行位置并更新 gateway.mode。跳过这三者的部分筛选器会直接进入请求的设置，不显示 Gateway 网关模式提示。选择远程 Gateway 网关模式会写入远程配置并立即退出；它不会运行插件安装等仅限本地的步骤。
openclaw configure 需要交互式终端（stdin 和 stdout 都必须是 TTY）。如果没有交互式终端，它会打印等效的非交互式 openclaw config get|set|patch|validate 命令并以错误退出，而不是部分运行。模型部分
模型 包含一个用于
agents.defaults.models 允许列表的多选项（即 /model 和模型选择器中显示的内容）。按提供商范围进行的设置选择会把所选模型合并到现有允许列表中，而不是替换配置中已有的其他无关提供商。从 configure 重新运行提供商身份验证会保留现有的 agents.defaults.model.primary，即使该提供商的身份验证步骤返回了包含其推荐默认模型的配置补丁也是如此。添加提供商或重新验证提供商会让其模型可用，但不会接管你当前的主模型。若要有意更改默认模型，请使用 openclaw models auth login --provider <id> --set-default 或 openclaw models set <model>。volcengine-plan/*、byteplus-plan/*）。如果首选提供商筛选器会产生空列表，configure 会回退到未筛选的目录，而不是显示空白选择器。
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 搜索模型。
其他说明
- 写入本地配置后，如果所选设置路径需要，configure 会安装所选的可下载插件。远程 Gateway 网关配置不会安装本地插件包。
- 面向渠道的服务（Slack/Discord/Matrix/Microsoft Teams）会在设置期间提示输入渠道/房间允许列表。你可以输入名称或 ID；向导会在可能时将名称解析为 ID。
- 如果运行守护进程安装步骤，令牌身份验证需要令牌。如果
gateway.auth.token由 SecretRef 管理，configure 会验证 SecretRef，但不会把解析出的明文令牌值持久化到 supervisor 服务环境元数据中；如果 SecretRef 未解析，configure 会阻止守护进程安装，并给出可操作的修复指导。 - 如果同时配置了
gateway.auth.token和gateway.auth.password，且gateway.auth.mode未设置，configure 会阻止守护进程安装，直到你显式设置该模式。