# openclaw configure

用于设置凭据、设备和智能体默认值的交互式提示。

当配置流程从某个提供商认证选择开始时，默认模型和允许列表选择器会自动优先使用该提供商。对于 Volcengine 和 BytePlus 这样的成对提供商，相同的偏好也会匹配它们的编码计划变体（volcengine-plan/*、byteplus-plan/*）。如果首选提供商筛选会产生空列表，配置流程会回退到未筛选的目录，而不是显示空白选择器。

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

• Grok 可以提供可选的 x_search 设置，使用相同的 XAI_API_KEY，并让你选择一个 x_search 模型。
• Kimi 可以询问 Moonshot API 区域（api.moonshot.ai 与 api.moonshot.cn）以及默认的 Kimi Web 搜索模型。

相关：

• Gateway 网关配置参考：配置
• 配置 CLI：配置

# 选项

• --section <section>：可重复的部分筛选器

可用部分：

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

注意：

• 选择 Gateway 网关运行位置始终会更新 gateway.mode。如果这就是你需要的全部内容，可以选择“继续”而不选择其他部分。
• 写入本地配置后，如果所选设置路径需要可下载插件，配置流程会安装所选插件。远程 Gateway 网关配置不会安装本地插件包。
• 面向渠道的服务（Slack/Discord/Matrix/Microsoft Teams）会在设置期间提示输入渠道/房间允许列表。你可以输入名称或 ID；向导会在可能时将名称解析为 ID。
• 如果你运行 daemon 安装步骤，令牌认证需要令牌，并且 gateway.auth.token 由 SecretRef 管理，配置流程会验证 SecretRef，但不会把解析后的明文令牌值持久化到 supervisor 服务环境元数据中。
• 如果令牌认证需要令牌且配置的令牌 SecretRef 未解析，配置流程会阻止 daemon 安装，并给出可执行的修复指引。
• 如果同时配置了 gateway.auth.token 和 gateway.auth.password，并且 gateway.auth.mode 未设置，配置流程会阻止 daemon 安装，直到显式设置模式。

# 示例

openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon

# 相关

• CLI 参考
• 配置