Provider Sync

---

name: provider-sync

description: "Sync provider model lists into OpenClaw config (dry-run preview → confirm → apply). Trigger: /provider_sync"

user-invocable: true

license: MIT

spdx: MIT

---

# Provider Sync

触发方式：在聊天里输入 `/provider_sync`。

交互式用法（默认，无按钮）

当你只发送 `/provider_sync`（不带任何参数）时，我会回复一组**蓝色命令选项**（可直接点击/复制发送）：

选 provider（默认 dry-run，不写配置）：

/provider_sync provider=cli-usa

/provider_sync provider=cliplus

/provider_sync provider=newapi

/provider_sync provider=all

新增 provider（向导）：

/provider_sync add

> 说明：这是“无 inline button 也能点选”的默认方案，任何环境都可用。

>

> 你也可以一步到位直接写：/provider_sync provider=<cli-usa|cliplus|newapi|all>（默认 dry-run）。

适用场景

v2 Breaking（重要）

使用方法（推荐）

方式 A：交互式（默认）

- /provider_sync provider=cli-usa

- /provider_sync provider=cliplus

- /provider_sync provider=newapi

- /provider_sync provider=all

方式 B：直接带参数（一步到位）

把下面任意一行发出去即可（默认 dry-run）：

方式 C：新增 provider（一步到位，非交互）

如果你不想走向导，也可以直接提供信息（私聊使用）：

- 注意：真正写入前仍会先 dry-run 验证，并二次确认

应用（会备份；仍建议先预览）：

如需让变更尽快生效，可再单独执行一次网关重启（会短暂断线）：

指定 provider

- `/provider_sync provider=cli-usa`

- `/provider_sync provider=cliplus`

- `/provider_sync provider=newapi`

权限/安全口径（默认建议）

生效方式

参数（与脚本对应）

- `config=<path>`（默认 `/root/.openclaw/openclaw.json`）

- `mapping=<path>`（默认 `references/mapping.openai-models.json`）

- `profile=generic|gemini`

- `probe=openai-responses,openai-completions`

备注（实现边界）

Main script