OpenClaw

OpenClaw 是一个自托管的个人 AI，运行在你的机器上，并通过你已经在使用的渠道（WhatsApp、Telegram、Slack、Discord、iMessage 等众多渠道）进行回应。它支持多个模型提供方——将 Synthorai 添加为其中之一后，你工作空间中的任意 chat 模型即可通过 OpenClaw 的 agent 配置访问。

开始之前

你需要：(1) 一个在本地运行的 OpenClaw 安装；(2) 一个来自以下位置的 Synthorai API key Console → API Keys.

第 1 步 — 编辑 ~/.openclaw/openclaw.json

在以下位置添加 Synthorai providers. 现有的 openai/anthropic 条目可以保留——OpenClaw 会使用被以下项引用的那一个 agent.model.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai/gpt-5.4-mini"
  }
}

ℹ

type: openai 告诉 OpenClaw 使用 OpenAI Chat Completions 协议。Synthorai 在以下端点上完全兼容 OpenAI /v1/chat/completions，因此它适用于你工作空间中的任意 chat 模型——不仅限于 OpenAI 托管的模型。

第 2 步 —（可选）再添加一个 Claude 原生 provider

如果你特别想使用 Anthropic 的原生 message 格式（仅限 Claude 系列模型），请添加第二个面向 Anthropic 协议的 provider。请注意 base_url 不包含 /v1.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    },
    "synthorai-claude": {
      "type": "anthropic",
      "base_url": "https://synthorai.io",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai-claude/claude-sonnet-4-6"
  }
}

第 3 步 — 重启 OpenClaw

OpenClaw 会重新读取 openclaw.json 于启动时。重启后，从 OpenClaw 绑定的任意渠道（如 Slack、Telegram）发送你的第一条消息——agent 将使用你配置的 Synthorai 模型进行响应。

参数	类型	说明
`gpt-5.4-mini`	`fast`	OpenAI；快速且低成本。良好的默认选择。
`qwen3.5-flash`	`fast`	阿里 Qwen；在中文 + 代码 + 多语言场景下价格有竞争力。
`claude-sonnet-4-6`	`balanced`	Anthropic；最适合更长上下文的对话。需要上述 claude provider 形态。
`gemini-2.5-flash`	`fast`	Google；上下文窗口长，适合大量文件的工作流。

故障排查

OpenClaw 各版本之间的字段名不一致 — 上面所示的字段 (type / base_url / api_key) 是常见的写法。如果某个特定的 OpenClaw 版本将它们重命名 (e.g. provider_type / baseUrl)，请查阅官方配置参考，并替换为相同的值。

401 / 403 — API key 错误、已停用或配额不足。请检查 /console/keys 和 /console/billing.

「未知模型」 — 模型 slug 必须与以下位置的 id 列匹配 /console/pricing. 如果你通过以下方式引用它 agent.model = "synthorai/MODEL_ID" 请确保 MODEL_ID 可由你提供的 key 路由。

私有 / 隔离网络部署 — 相同的 JSON 格式同样适用；只需替换公开的 https://synthorai.io 为你的内部网关主机名。

想知道常驻助手场景下每个选项的花费?把你的预期用量放进 LLM API cost calculator 算一算。