CLI configure 命令

openclaw configure

对已有配置进行交互式修改：凭证、设备、agent 默认值、gateway、channel、插件、skill 和健康检查。

openclaw config（不带子命令）打开同一向导。非交互式编辑使用 openclaw config get|set|unset。

用法

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

可用 section

Section	说明
workspace	Workspace 路径
model	模型选择与 allowlist
web	Web 搜索 provider 及凭证
gateway	Gateway 运行模式
daemon	系统服务安装
channels	Channel 账户配置
plugins	插件管理
skills	Skill 配置
health	健康检查

模型配置行为

• model section 包含 agents.defaults.models allowlist 多选（影响 /model 和模型选择器）
• Provider 级别的 auth 步骤会将选中模型合并到现有 allowlist，不会替换其他 provider 的模型
• 重新认证某 provider 不会改变当前 agents.defaults.model.primary
• 若要切换默认模型，使用 openclaw models set <model> 或 openclaw models auth login --provider <id> --set-default

Web 搜索特殊提示

• Grok：可选配 x_search，复用同一 XAI_API_KEY
• Kimi：可选 Moonshot API 区域（api.moonshot.ai vs api.moonshot.cn）

服务安装注意

• 若 gateway.auth.token 由 SecretRef 管理，daemon install 步骤只做可解析性校验，不写入明文 token
• SecretRef 不可解析时，daemon install 被阻止并给出修复指引
• gateway.auth.token 和 gateway.auth.password 同时配置且 gateway.auth.mode 未设置时，daemon install 被阻止

相关链接

• cli-config
• gateway-configuration