OpenClaw Claude API 接入教程

本教程详细介绍在 OpenClaw 中配置 Claude API 的多种方法，帮助你快速上手。

简介

OpenClaw 是一个强大的 AI 智能体框架，支持多种大语言模型的接入。Claude 是由 Anthropic 开发的高性能 AI 模型，在代码生成、推理分析等方面表现出色。

准备工作

在开始之前，你需要：

安装 OpenClaw：npm install -g openclaw
拥有相应的 API 访问权限

方法一：使用 Defapi（推荐）

如果你想节省成本，推荐使用 Defapi！

Defapi 是一个 AI 模型聚合平台，所有 Claude 模型价格只有官方的半价。Defapi 支持 OpenAI 兼容的 v1/chat/completions 接口，配置简单方便。

优势

价格半价：Claude Sonnet 4.5 仅需 $1.5/M 输入，$7.5/M 输出
兼容性强：完美兼容 OpenAI 接口格式
稳定可靠：国内访问速度快

支持的 Claude 模型

Claude Opus 4.5 / 4.6
Claude Sonnet 4.5
Claude Haiku 4.5

配置步骤

访问 Defapi 注册账号，获取 API Key
在 OpenClaw 中配置：

{
  env: {
    OPENAI_API_KEY: "你的Defapi-Key",
    OPENAI_BASE_URL: "https://api.defapi.org/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-sonnet-4.5" },
    },
  },
}

验证配置：

# 直接发送消息测试（推荐）
openclaw agent --message "Hello"

# 或查看模型状态
openclaw models status

验证成功后，你可以通过以下方式与 Claude 对话：

# 直接发送消息
openclaw agent --message "你好"

# 或使用终端界面
openclaw tui

# 或启动 Gateway 后通过其他渠道对话
openclaw gateway

现在你可以用半价享受 Claude 的强大能力了！

方法二：官方 Anthropic API

这是最直接的接入方式，适合有 API Key 或 Claude 订阅的用户。

方式 2.1：API Key 认证

如果你有 Anthropic API Key（按量付费），配置非常简单：

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

或在配置文件中添加：

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

验证：

openclaw agent --message "Hello"

方式 2.2：Setup-Token 认证

如果你有 Claude Max/Pro 订阅，可以使用 setup-token：

# 在 Claude Code CLI 中生成
claude setup-token

# 在 OpenClaw 中配置
openclaw models auth setup-token --provider anthropic

提示缓存

Anthropic API 支持提示缓存，可提升性能并降低成本：

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

方法三：OpenRouter

OpenRouter 提供统一的 API 接口，可访问多种模型，包括 Claude 系列。

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

配置：

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
    },
  },
}

验证：

openclaw agent --message "Hello"

方法四：Claude Max API Proxy

如果你有 Claude Max 订阅但需要 OpenAI 格式的接口，可以使用社区工具 claude-max-api-proxy：

npm install -g claude-max-api-proxy
claude-max-api

配置 OpenClaw：

{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

验证：

openclaw agent --message "Hello"

方法五：自定义兼容 API

对于其他提供兼容 API 的平台，OpenClaw 也支持自定义配置。

v1/chat/completions 格式

{
  env: {
    CUSTOM_API_KEY: "sk-...",
  },
  agents: {
    defaults: {
      model: { primary: "custom/claude-model" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      "custom": {
        baseUrl: "https://api.example.com/v1",
        apiKey: "${CUSTOM_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "claude-model", name: "Claude Model", contextWindow: 200000 },
        ],
      },
    },
  },
}

v1/messages 格式（Anthropic 兼容）

{
  env: {
    CUSTOM_API_KEY: "sk-...",
  },
  agents: {
    defaults: {
      model: { primary: "custom/claude-opus-4" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      "custom": {
        baseUrl: "https://api.example.com/v1",
        apiKey: "${CUSTOM_API_KEY}",
        api: "anthropic-messages",
        models: [
          { id: "claude-opus-4", name: "Claude Opus 4", contextWindow: 200000 },
        ],
      },
    },
  },
}

常用模型参考

模型	配置引用
Claude Opus 4.6	`anthropic/claude-opus-4-6`
Claude Sonnet 4.6	`anthropic/claude-sonnet-4-6`
Claude Haiku 4.6	`anthropic/claude-haiku-4-6`

故障排查

问题：401 错误 / Token 失效

重新运行 claude setup-token 并配置

问题："No API key found for provider anthropic"

认证是按智能体隔离的，确认目标智能体已配置认证

问题：连接失败

检查网络连接
确认 API Key 正确
验证 baseUrl 配置无误