ClaudeStore/文档
⚠ 文档仍在完善中。部分内容可能不准确或为临时由 AI 生成。

OpenClaw 配置指南

通过 ~/.openclaw/openclaw.json 中的自定义 anthropic-messages provider，把 ClaudeStore API key 接入 OpenClaw。包含完整配置、验证步骤与排错。

🇬🇧 Read in English🇷🇺 Читать на русском

配置文件: ~/.openclaw/openclaw.json. Provider id: claudestore. API 模式: anthropic-messages. baseUrl: https://api3.claudestore.store. 环境变量: CLAUDESTORE_API_KEY. Primary 模型: claudestore/claude-sonnet-4-6.

为什么这样配

OpenClaw 通过 models.providers 注册额外的模型 provider。对于 ClaudeStore 上的 Claude 模型，最干净的接入方式是把 ClaudeStore 配为 anthropic-messages 自定义 provider。

  • OpenClaw 把它视作一等公民的 Anthropic 兼容 provider。
  • system 块、tool use、content blocks、reasoning 全程保留。
  • 沿用 OpenClaw 的标准模型引用：claudestore/claude-sonnet-4-6。
OpenClaw 也支持 openai-completions，但对 ClaudeStore 上的 Claude 模型，请优先用 Anthropic Messages 路径，不要默认选 OpenAI 兼容模式。

配置文件路径

OpenClaw 从 home 目录读取单个 JSON 文件：

~/.openclaw/openclaw.json

虽然有 openclaw config、openclaw configure 命令，但对这种特定 provider， 直接编辑 JSON 更快、更直观。下面的片段可以直接复制粘贴。

环境变量

导出 ClaudeStore key，让配置通过 placeholder 引用它：

~/.zshrc 或 ~/.bashrcbash
export CLAUDESTORE_API_KEY="YOUR_SK_CS2_KEY"

这样 key 不会写进 openclaw.json，也不会进入 dotfile 备份/Git。

最小可用配置

把下面内容写入 ~/.openclaw/openclaw.json（按 JSON5 解析，可以有注释和尾随逗号）：

~/.openclaw/openclaw.jsonjson
{
  env: {
    CLAUDESTORE_API_KEY: "YOUR_SK_CS2_KEY",
  },
  agents: {
    defaults: {
      model: { primary: "claudestore/claude-sonnet-4-6" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      claudestore: {
        baseUrl: "https://api3.claudestore.store",
        apiKey: "${CLAUDESTORE_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "claude-sonnet-4-6",
            name: "Claude Sonnet 4.6",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 64000,
          },
          {
            id: "claude-opus-4-7",
            name: "Claude Opus 4.7",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 128000,
          },
          {
            id: "claude-haiku-4-5",
            name: "Claude Haiku 4.5",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 200000,
            maxTokens: 64000,
          },
        ],
      },
    },
  },
}

严格按命名来

provider id 必须是 claudestore，primary 模型必须是 claudestore/claude-sonnet-4-6。不要把 anthropic/... 当 primary — 那会走 OpenClaw 内置的 Anthropic provider，而不是 ClaudeStore。

为什么 baseUrl 不带 /v1

OpenClaw 的 Anthropic 兼容 provider 中，baseUrl 是 provider 根地址， Anthropic Messages 路径由 OpenClaw 自动追加。

  • ✅ 正确：https://api3.claudestore.store
  • ❌ 错误：https://api3.claudestore.store/v1

加 /v1 会让路径重复，每个请求都 404。

验证

保存配置后按顺序跑：

1. provider 状态bash
openclaw gateway status
2. 列出模型bash
openclaw models list

应能看到 claudestore/claude-sonnet-4-6、claudestore/claude-opus-4-7、claudestore/claude-haiku-4-5。

3. 显式锁定 primarybash
openclaw models set claudestore/claude-sonnet-4-6
4. 打开 dashboard 实测bash
openclaw dashboard

发一条小请求，确认调用挂在 claudestore provider 下。

进阶：1M 上下文

在 Sonnet 4.6 / Opus 4.7 上按模型开启 1M 上下文：

agents.defaults.models[...]json
{
  agents: {
    defaults: {
      models: {
        "claudestore/claude-sonnet-4-6": { params: { context1m: true } },
        "claudestore/claude-opus-4-7":   { params: { context1m: true } },
      },
    },
  },
}

仅 Sonnet/Opus

Haiku 不要开 context1m，保持默认上下文窗口即可。

重要限制：/fast

走网关时 /fast 不是 1:1

OpenClaw 的 /fast 是按直连 Anthropic 传输设计的。走自定义 provider 时，OpenClaw 不会 自动注入 Anthropic 的 service-tier 行为。请把 /fast 当作提示，而不是传输层保证。

排错

provider 返回 404

几乎都是 baseUrl 里多了 /v1。改回 https://api3.claudestore.store。

api 模式选错

写成 api: "openai-completions" 时，OpenClaw 会用 OpenAI Chat Completions 协议去打 Anthropic 端点。请改回 api: "anthropic-messages"。

primary 模型找不到

primary 必须带 provider 前缀：claudestore/claude-sonnet-4-6。 裸 claude-sonnet-4-6 或 anthropic/claude-sonnet-4-6 不会解析到 ClaudeStore。

没导出 API key

确认启动 OpenClaw 的 shell 里能看到环境变量：

echo $CLAUDESTORE_API_KEY

为空就重新 export 并重启 shell。配置中的 placeholder 在进程启动时解析。

OpenClaw 启动了但模型不存在

通常是命名错位：providers.claudestore.models 里的 id 与 agents.defaults.model.primary 不一致。完整引用是 <providerId>/<modelId>。

Windows 配置

1. 安装 OpenClaw

OpenClaw 提供 npm 包和独立 Windows 二进制：

npm install -g openclaw
openclaw --version

或从 GitHub Releases 下载 openclaw-windows-x64.exe 加入 PATH。

2. Windows 上的配置路径

OpenClaw 读取 %USERPROFILE%\.openclaw\openclaw.json（例如 C:\Users\<you>\.openclaw\openclaw.json）：

mkdir $env:USERPROFILE\.openclaw -ErrorAction SilentlyContinue
notepad $env:USERPROFILE\.openclaw\openclaw.json

把上面「最小可用配置」的内容粘贴进去，保存为 UTF-8（无 BOM）。

3. 持久化 CLAUDESTORE_API_KEY

setx CLAUDESTORE_API_KEY "YOUR_SK_CS2_KEY"
setx 只在新终端生效。关闭当前 PowerShell，开新窗口，验证 echo $env:CLAUDESTORE_API_KEY。

GUI：Win+R → sysdm.cpl → 环境变量 → 用户变量 → 新建。

4. 验证

openclaw gateway status
openclaw models list
openclaw models set claudestore/claude-sonnet-4-6

5. WSL

WSL 内使用 Linux 路径 ~/.openclaw/openclaw.json，并在 ~/.bashrc 重新 export：

export CLAUDESTORE_API_KEY="YOUR_SK_CS2_KEY"

6. 排错

  • "openclaw 不是命令" — 打开新 PowerShell 或把 %APPDATA%\npm 加入 PATH。
  • Placeholder ${CLAUDESTORE_API_KEY} 未替换 — 启动 openclaw 的 shell 没设这个变量。用 setx 设置后打开新终端。
  • JSON 解析报错 — Notepad 保存了 BOM。请用 VS Code / Notepad++ 保存为 UTF-8（无 BOM）。
  • PowerShell 引号 — 全部用双引号包裹；cmd.exe 的引号规则不同。
  • 杀软拦 node.exe / openclaw.exe — 把可执行文件和 api3.claudestore.store 加入白名单。

准备好开始了吗？

2 分钟即可获得 Claude 全系列模型 API 接入。

查看价格