Providers 导读

用 Synthetic 接入开源模型,先拿 API Key 再跑 onboard

Synthetic 提供兼容 Anthropic 的端点,OpenClaw 通过 `synthetic` provider 调用。最容易踩的坑是 base URL 末尾不要加 `/v1`,OpenClaw 会自动补上。配置时记得在 `agents.defaults.models` 里放行你要用的模型,否则会被隐藏。

先讲这一页到底在解决什么

用 Synthetic 接入开源模型,先拿 API Key 再跑 onboard

Synthetic 提供兼容 Anthropic 的端点,OpenClaw 通过 `synthetic` provider 调用。最容易踩的坑是 base URL 末尾不要加 `/v1`,OpenClaw 会自动补上。配置时记得在 `agents.defaults.models` 里放行你要用的模型,否则会被隐藏。

原文共 5 节,先看 Start Here 路径:/providers/synthetic 查看官方原文

第一步

🔑 接法很简单:给 SYNTHETIC_API_KEY,默认先拿 MiniMax 那个货架

主路非常短。你给 key,跑 onboarding,默认模型就先落到 synthetic/hf:MiniMaxAI/MiniMax-M2.5

这条默认模型名字看起来怪,是因为它像在写“Synthetic 商场 / Hugging Face 样式货号 / 具体模型”。不是故意绕,而是在写完整路径。

第二步

🧺 这页真正特别的地方,是一个货架里摆了很多别家模型

官方给了一长串模型目录。你别逐条背,把它看成“同一个外壳下可以挑很多货”。

MiniMax / Kimi / GLM / DeepSeek / Llama / Qwen

像一个混合品牌大货架,不是只有一家自营。

全部成本先写 0

像货架价格牌先没细填,侧重的是“可接入”,不是精确计费展示。

📌 真正要记住的

如果你启用了 allowlist,别忘了把你真想用的每个模型都加进去。不然货在架上,你也拿不到。

第三步

🧱 baseUrl 那句提醒,像“门牌号不要多写一层楼”

官方专门提醒不要把 /v1 再手动写进去,因为 Anthropic 客户端自己会补。

所以这里最像“门牌号别写重复楼层”。写多一层,车就会开错门口。

最后总结

🎈 把 Synthetic 这页压成一句最好记的话

Synthetic 是披着 Anthropic 外套的模型货架。主路很短,但货架很杂,真正要小心的是模型 allowlist 和 baseUrl 门牌别写重。