Skip to content

openclaw configure

交互式提示,用于设置凭证、设备和 agent 默认参数。

提示Model 部分现在新增了 agents.defaults.models 允许列表的多选(决定 /model 和模型选择器中显示哪些模型)。

小技巧:不带子命令直接运行 openclaw config 会打开同一个向导。若需要非交互式修改,请使用 openclaw config get|set|unset

相关文档:

注意事项

  • "Gateway 运行位置"选项始终会更新 gateway.mode。如果只需要改这一项,选择"继续"即可跳过其他部分。
  • 面向频道的服务(Slack/Discord/Matrix/Microsoft Teams)在设置时会提示填写频道/房间允许列表。可以输入名称或 ID,向导会尽可能将名称解析为 ID。
  • 如果你运行了 daemon 安装步骤,且 token 认证需要 token,并且 gateway.auth.token 由 SecretRef 管理,configure 会验证 SecretRef 但不会将解析后的明文 token 写入 supervisor 服务的环境元数据。
  • 如果 token 认证需要 token 而配置的 token SecretRef 无法解析,configure 会阻止 daemon 安装,并给出可操作的修复指引。
  • 如果同时配置了 gateway.auth.tokengateway.auth.password,且 gateway.auth.mode 未设置,configure 会阻止 daemon 安装,直到你明确设置 mode。

示例

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

初次"养龙虾"时,直接运行 openclaw configure 是最省事的起点——向导会一步步引导你完成所有必要配置。