核心用法
/provider_sync 是 OpenClaw 生态的配置同步技能，用于将上游 Provider（如 cli-usa、cliplus、newapi）的 /v1/models 接口返回拉取到本地 openclaw.json。默认采用交互式命令流：用户发送 /provider_sync 后，系统返回可直接点击的蓝色命令选项（如 /provider_sync provider=cli-usa），无需依赖 inline button，兼容性极佳。
支持三种模式：
- dry-run（默认）：仅预览差异，不写配置
- check-only：验证配置合法性
- apply：确认后写入，自动备份原配置
显著优点
1. 零摩擦交互：纯文本命令即可完成全部操作，适配所有部署环境
2. 安全闭环：写前强制 dry-run 预览 + 二次确认 + 自动备份，降低误操作风险
3. 智能裁剪（v2）：同步时自动清理 agents.defaults.models 中上游已不存在的条目，避免菜单出现"僵尸模型"
4. 字段规范化：自动补全 contextWindow、maxTokens、reasoning 等模型元数据
5. 权限分层：群聊默认只读，私聊才允许写入，符合最小权限原则
潜在局限
- 重启网关需单独执行
/restart，未内嵌一键闭环 - 新增 provider 的向导模式为文本交互，不如 GUI 直观
- 敏感字段（apiKey/token）虽在缓存前剔除，但仍需用户自行保管传输安全
适合人群
- OpenClaw 网关管理员
- 需要频繁切换/更新上游模型白名单的运维人员
- 多 Provider 环境下的配置标准化需求
常规风险
- 误用
mode=apply可能覆盖有效配置（虽有备份，恢复仍需手动） provider=all批量同步时若某上游异常，可能导致部分模型列表缺失- v2 默认裁剪行为可能与旧有白名单预期冲突，需留意
--no-prune-agent-aliases开关