核心用法
Provider Sync 是 OpenClaw 生态的配置同步中枢，通过 /provider_sync 命令将上游 OpenAI 兼容接口（/v1/models）的模型列表拉取并规范化写入本地 openclaw.json。交互设计遵循"预览 → 确认 → 应用"的安全闭环：默认 dry-run 模式展示差异，用户二次确认后才写入配置，且自动备份原文件。
三种操作模式
- 交互式（推荐）：发送裸命令
/provider_sync，系统返回可点击的蓝色命令选项，降低记忆成本 - 直达式：携带参数一步到位，如
/provider_sync provider=cli-usa - 向导式：
/provider_sync add引导新增 provider，含有效性验证
v2 关键改进
- 自动裁剪 agent 别名：同步时删除
agents.defaults.models中上游已不存在的条目，解决"/models 菜单冗长但不可用"痛点 - 安全缓存：落盘前自动剔除认证敏感字段，防止异常响应泄露密钥
显著优点
1. 零误触设计：dry-run 优先、应用需二次确认、写前自动备份，三重保险
2. 环境兼容：纯文本命令 fallback 设计，无 inline button 的实例也能完整使用
3. 权限分级：群聊强制只读（dry-run/check-only），私聊开放应用权限
4. 多 provider 批量：provider=all 遍历全量上游，适合统一维护
潜在局限
- 非原子操作：网关重启需单独执行
/restart，存在"配置已写但服务未重启"的中间态 - 上游依赖：完全依赖
/v1/models返回质量，若上游返回异常字段可能需人工干预 - 无冲突解决：同名模型以最后一次同步为准，缺乏合并策略配置
适合人群
- OpenClaw 节点管理员：需定期维护多上游模型列表的运维者
- 多 provider 用户：同时使用 cli-usa/cliplus/newapi 等商业 API 的进阶玩家
- 自动化运维：可将 dry-run 输出接入 CI 流程做配置漂移检测
常规风险
| 场景 | 风险 | 缓释措施 |
|------|------|---------|
| 群聊误操作 apply | 配置被篡改 | 代码级强制 dry-run，群聊拒绝 apply |
| 上游返回恶意字段 | 敏感信息入配置 | 自动剔除 auth 相关字段 |
| 同步后未重启 | 新模型不可用 | 命令输出明确提示需 `/restart` |
| 备份文件累积 | 磁盘占用 | 建议定期清理 `~/.openclaw/backups/` |