openclaw configure
交互式向导,用于设置凭据、设备和 Agent 默认值。
提示:模型部分现在包含一个多选项,用于配置 agents.defaults.models 白名单(决定 /model 和模型选择器中显示哪些模型)。
小技巧:不带子命令运行 openclaw config 也会打开同样的向导。用 openclaw config get|set|unset 进行非交互式编辑。
相关文档:
- Gateway 配置参考:Configuration
- Config CLI:Config
注意事项:
- 选择 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.token和gateway.auth.password都已配置但gateway.auth.mode未设置,configure 会阻止守护进程安装,直到显式设置 mode。
示例
openclaw configure
openclaw configure --section model --section channels