如何将 Claude 接入 OpenClaw

配置 OpenClaw，通过 Claude API Tech 使用 Claude 模型。API 密钥作为环境变量保存，提供商和模型则集中写入一个配置文件。

什么是 OpenClaw

OpenClaw 是开源个人 AI 助手和自托管 gateway，可在自己的电脑或服务器上将 AI 代理连接到 Telegram、WhatsApp、Slack、Discord 等渠道。

开始之前

你需要安装 Node.js、能够使用终端，并准备一个 Claude API Tech API 密钥。如果还没有密钥，请先在控制台中创建。获取 API 密钥 →

1. 安装 OpenClaw

从官方网站下载 OpenClaw，或在 macOS 和 Linux 上运行官方安装脚本：

Terminal

curl -fsSL https://openclaw.ai/install.sh | bash

OpenClaw 官方网站 ↗OpenClaw 文档 ↗

2. 打开配置文件

主配置文件位于 ~/.openclaw/openclaw.json。如果目录和文件不存在，请先创建：

Terminal

mkdir -p ~/.openclaw && $EDITOR ~/.openclaw/openclaw.json

如果文件中已有渠道、代理或 gateway 设置，请不要整体覆盖。将下面示例中的部分合并到现有配置中。

3. 添加 Claude API Tech

粘贴配置，并将 sk-cs2-YOUR_API_KEY 替换为控制台中的密钥。Claude Sonnet 5 是主模型，Fable 5 和 Opus 4.8 可随时切换。

~/.openclaw/openclaw.json

{
  "env": {
    "LLM_GATE_API_KEY": "sk-cs2-YOUR_API_KEY"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "llmgate/claude-sonnet-5"
      },
      "models": {
        "llmgate/claude-fable-5": {},
        "llmgate/claude-sonnet-5": {},
        "llmgate/claude-opus-4-8": {}
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "llmgate": {
        "baseUrl": "https://api.llm-gate.tech",
        "apiKey": "${LLM_GATE_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-fable-5",
            "name": "Claude Fable 5",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          },
          {
            "id": "claude-sonnet-5",
            "name": "Claude Sonnet 5",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          },
          {
            "id": "claude-opus-4-8",
            "name": "Claude Opus 4.8",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      }
    }
  }
}

API 密钥安全

请勿公开含真实密钥的 openclaw.json，也不要将其提交到 Git。此配置通过 OpenClaw 内部的 LLM_GATE_API_KEY 环境变量传递密钥。

此配置包含的内容

通过 https://api.llm-gate.tech 使用 Anthropic Messages API
将 Claude Sonnet 5 设为主模型
支持文本和图片输入
在模型列表中添加 Fable 5、Sonnet 5 和 Opus 4.8

4. 检查 gateway

保存配置，并确认 OpenClaw gateway 正在运行且能够响应：

Terminal

openclaw gateway status

5. 检查模型列表

输出中应包含 llmgate/claude-fable-5、llmgate/claude-sonnet-5 和 llmgate/claude-opus-4-8：

Terminal

openclaw models list

6. 配置完成

OpenClaw 已配置完成。新会话默认使用 Claude Sonnet 5，需要时可以在 OpenClaw 中选择其他已添加模型。

模型未显示时

请验证 JSON，确认 LLM_GATE_API_KEY 名称完全一致，并删除弯引号。重启 gateway 后，再次运行两条检查命令。 openclaw gateway status

你需要安装 Node.js、能够使用终端，并准备一个 Claude API Tech API 密钥。如果还没有密钥，请先在控制台中创建。

获取 API 密钥 →

← OpenCode Cline