OpenClaw

OpenClaw 是一个开源的个人 AI 助手网关，配置文件位于 ~/.openclaw/openclaw.json。OpenClaw 支持自定义 OpenAI 兼容模型提供商；只要后端实现 /v1/chat/completions，就可以通过 models.providers 接入。Sakrylle API 兼容 OpenAI Chat Completions，因此推荐以 openai-completions 方式接入。

仓库：https://github.com/openclaw/openclaw
配置文档：https://documentation.openclaw.ai/gateway/config-tools
模型提供商文档：https://documentation.openclaw.ai/concepts/model-providers

前置准备

已按 OpenClaw 官方说明完成安装和 openclaw onboard 初始化。
在 Sakrylle 控制台创建 API Key。
这把 Key 所属分组包含你要使用的模型；聊天示例使用 gpt-5.6-sol。

推荐配置

1. 设置环境变量

bash

export SAKRYLLE_API_KEY="sk-xxxxxxxxxxxxxxxx"

把这行写入你的 shell 配置（例如 ~/.zshrc 或 ~/.bashrc）可长期生效。

2. 编辑配置

如果文件已存在，只需要合并下面的 agents.defaults 和 models.providers.sakrylle 部分：

json5

{
  agents: {
    defaults: {
      model: {
        primary: "sakrylle/gpt-5.6-sol"
      },
      models: {
        "sakrylle/gpt-5.6-sol": {
          alias: "Sakrylle GPT-5.6 Sol"
        }
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      sakrylle: {
        baseUrl: "https://api.sakrylle.com/v1",
        apiKey: "${SAKRYLLE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.6-sol",
            name: "GPT-5.6 Sol"
          }
        ]
      }
    }
  }
}

字段说明：

baseUrl：Sakrylle 的 OpenAI 兼容入口，带 /v1。
apiKey：建议使用 ${SAKRYLLE_API_KEY} 环境变量引用，不要把真实 Key 直接写进可同步的配置文件。
api：openai-completions 表示走 /v1/chat/completions；OpenClaw 对带 baseUrl 的自定义提供商默认也会使用这个适配器，显式写出更清晰。
models.providers.sakrylle.models[].id：只写模型名本身；OpenClaw 运行时用 provider/model 形式引用，所以完整引用是 sakrylle/gpt-5.6-sol。
models.mode: "merge"：保留 OpenClaw 已有模型列表，同时追加 Sakrylle 提供商。

3. 验证

重新启动 OpenClaw，确认模型选择器中出现 Sakrylle GPT-5.6 Sol 或 sakrylle/gpt-5.6-sol，然后发送一条简单消息。如果返回正常，配置就已生效。

选择其他模型

如需改用其他 Sakrylle 聊天模型：

在 models.providers.sakrylle.models 中追加模型。
在 agents.defaults.models 中追加同名的 sakrylle/<模型名> 条目。
把 agents.defaults.model.primary 改为目标模型引用。

例如：

json5

{
  agents: {
    defaults: {
      model: {
        primary: "sakrylle/claude-haiku-4-5-20251001"
      },
      models: {
        "sakrylle/gpt-5.6-sol": {
          alias: "Sakrylle GPT-5.6 Sol"
        },
        "sakrylle/claude-haiku-4-5-20251001": {
          alias: "Sakrylle Claude Haiku 4.5"
        }
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      sakrylle: {
        baseUrl: "https://api.sakrylle.com/v1",
        apiKey: "${SAKRYLLE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.6-sol",
            name: "GPT-5.6 Sol"
          },
          {
            id: "claude-haiku-4-5-20251001",
            name: "Claude Haiku 4.5"
          }
        ]
      }
    }
  }
}

可用模型列表见模型与计费。

图片模型说明

OpenClaw 的官方 OpenAI 插件支持图片生成，并使用 openai/gpt-image-2 作为图片生成 / 编辑模型引用。Sakrylle 的图片模型是 gpt-image-2（GPT-Image 分组，￥0.15/次）。由于一个 Sakrylle API Key 只能绑定一个分组，如果你同时需要聊天和图片能力，请在控制台分别创建聊天分组 Key 与图片分组 Key。

如果只配置上面的 sakrylle 聊天提供商，OpenClaw 的聊天请求会走 Sakrylle，图片工具仍取决于你在 OpenClaw 里对 OpenAI 图片插件的单独配置。

常见问题

401 / 鉴权失败：检查 SAKRYLLE_API_KEY 是否已导出，且 apiKey 字段确实写成 ${SAKRYLLE_API_KEY} 或有效 Key。
404 / model not found：确认 models[].id 和 agents.defaults.model.primary 使用的是模型与计费中列出的模型名。
OpenClaw 找不到模型：确认模型引用使用 sakrylle/gpt-5.6-sol 这种 provider/model 形式，而不是只写 gpt-5.6-sol。
请求体兼容性问题：OpenClaw 官方文档提供 compat.requiresStringContent 和 compat.strictMessageKeys 等兼容开关；只有在后端明确返回消息格式相关错误时再添加。
402 余额不足：到控制台充值。

OpenClaw ​

前置准备 ​

推荐配置 ​

1. 设置环境变量 ​

2. 编辑配置 ​

3. 验证 ​

选择其他模型 ​

图片模型说明 ​

常见问题 ​