跳转到内容
OpenClaw Docs

配置

openclaw configure

Section titled “openclaw configure”

用于对现有设置进行针对性更改的交互式提示：凭据、设备、代理默认值、网关、渠道、插件、技能和健康检查。

使用 openclaw onboard 进行完整的首次运行引导旅程，使用 openclaw setup 仅用于基础配置/工作区，以及当您只需要渠道帐户设置时使用 openclaw channels add。

当 configure 从提供程序身份验证选择开始时，默认模型和允许列表选择器会自动首选该提供程序。对于成对的提供程序（如 Volcengine 和 BytePlus），同样的偏好也匹配其编码计划变体（volcengine-plan/*、byteplus-plan/*）。如果首选提供程序过滤器会产生空列表，configure 会回退到未过滤的目录，而不是显示空白的选择器。

对于网络搜索，openclaw configure --section web 允许您选择提供程序 并配置其凭据。某些提供程序还会显示特定于提供程序的 后续提示：

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

相关内容：

选项

Section titled “选项”
  • --section <section>：可重复的部分筛选器

可用部分：

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

注意：

  • 完整的向导和与 Gateway(网关) 相关的部分会询问 Gateway 运行的位置并更新 Gateway(网关)gateway.mode。不包含 gateway、daemon 或 health 的部分筛选器会直接进入请求的设置。
  • 在写入本地配置后，当所选的设置路径需要时，configure 会安装所选的可下载插件。远程 Gateway(网关) 配置不会安装本地插件包。
  • 面向渠道的服务（Slack/Discord/Matrix/Microsoft Teams）会在设置期间提示输入渠道/房间允许列表。您可以输入名称或 ID；向导会在可能的情况下将名称解析为 ID。
  • 如果您运行守护进程安装步骤，令牌认证需要一个令牌，并且 gateway.auth.token 由 SecretRef 管理，configure 会验证 SecretRef 但不会将解析后的明文令牌值持久化到主管服务环境元数据中。
  • 如果令牌认证需要一个令牌，且配置的令牌 SecretRef 未解析，configure 会阻止守护进程安装，并提供可操作的修复指导。
  • 如果配置了 gateway.auth.token 和 gateway.auth.password 并且未设置 gateway.auth.mode，configure 将阻止守护进程安装，直到显式设置模式。

示例

Section titled “示例”
Terminal window
openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon

相关

Section titled “相关”