9.4 Anthropic

Anthropic Claude 配置指南

概述

OpenClaw 支持通过两种方式使用 Anthropic 的 Claude 模型:使用 API 密钥或通过 Claude setup-token 进行认证。

认证方式

1. API 密钥认证

使用以 sk-ant- 开头的 API 密钥进行认证。

export ANTHROPIC_API_KEY=sk-ant-your-api-key-here

2. Setup Token 认证

通过 claude setup-token 命令获取设置令牌进行认证。

claude setup-token

快速开始

使用 API 密钥

# 引导式配置
openclaw onboard --anthropic-api-key

# 设置环境变量
export ANTHROPIC_API_KEY=sk-ant-your-api-key-here

# 设置为默认模型
openclaw models set anthropic/claude-opus-4-5

使用 Setup Token

# 引导式配置
openclaw onboard --auth-choice setup-token

# 设置为默认模型
openclaw models set anthropic/claude-opus-4-5

模型引用格式

Anthropic 模型使用以下格式引用:

• anthropic/claude-opus-4-5 - Claude Opus 4.5
• anthropic/claude-sonnet-4-5 - Claude Sonnet 4.5
• anthropic/claude-haiku-4 - Claude Haiku 4

配置示例

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-5"
      }
    }
  }
}

提示缓存

Claude 支持提示缓存功能,可以使用 cacheControlTtl 配置缓存过期时间。

{
  "model": {
    "cacheControlTtl": 300
  }
}

常用命令

# 列出可用的 Anthropic 模型
openclaw models list --provider anthropic

# 粘贴 API 令牌
openclaw models auth paste-token --provider anthropic

# 通过 OAuth 登录
openclaw models auth login --provider anthropic --set-default

故障排查

OAuth 令牌刷新失败

如果遇到 "OAuth token refresh failed" 错误,需要使用 setup-token 重新认证:

claude setup-token
openclaw onboard --auth-choice setup-token