openclaw configure

交互式向导,用于设置凭据、设备和 Agent 默认值。

提示:模型部分现在包含一个多选项,用于配置 agents.defaults.models 白名单(决定 /model 和模型选择器中显示哪些模型)。

小技巧:不带子命令运行 openclaw config 也会打开同样的向导。用 openclaw config get|set|unset 进行非交互式编辑。

相关文档:

注意事项:

  • 选择 Gateway 运行位置时总会更新 gateway.mode。如果这就是你要改的全部内容,可以直接选 “Continue” 跳过其他部分。
  • 面向频道的服务(Slack/Discord/Matrix/Microsoft Teams)在设置时会提示输入频道/房间白名单。你可以输入名称或 ID;向导会在可能时将名称解析为 ID。
  • 如果你运行了守护进程安装步骤,且 token 认证需要 token,同时 gateway.auth.token 通过 SecretRef 管理,configure 会验证 SecretRef 但不会把解析后的明文 token 值持久化到服务管理器的环境元数据中。
  • 如果 token 认证需要 token 且配置的 token SecretRef 未解析,configure 会阻止守护进程安装并给出可操作的修复指导。
  • 如果 gateway.auth.tokengateway.auth.password 都已配置但 gateway.auth.mode 未设置,configure 会阻止守护进程安装,直到显式设置 mode。

示例

openclaw configure
openclaw configure --section model --section channels