Anthropic (Claude)

Anthropic phát triển dòng model Claude và cung cấp quyền truy cập thông qua API. Trong OpenClaw, các bạn có thể xác thực bằng API key hoặc setup-token.

Phương án A: Anthropic API key

Phù hợp cho: truy cập API tiêu chuẩn và thanh toán theo lượng sử dụng. Tạo API key của các bạn trong Anthropic Console.

Cài đặt qua CLI

openclaw onboard
# chọn: Anthropic API key

# hoặc chạy không tương tác
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Config mẫu

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

Prompt caching (Anthropic API)

OpenClaw hỗ trợ tính năng prompt caching của Anthropic. Tính năng này chỉ dành cho API; xác thực qua subscription không áp dụng cài đặt cache.

Cấu hình

Dùng tham số cacheRetention trong config model của các bạn:

Giá trị	Thời gian cache	Mô tả
`none`	Không cache	Tắt prompt caching
`short`	5 phút	Mặc định cho xác thực API Key
`long`	1 giờ	Cache mở rộng (cần bật beta flag)

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

Giá trị mặc định

Khi dùng xác thực Anthropic API Key, OpenClaw tự động áp dụng cacheRetention: "short" (cache 5 phút) cho tất cả model Anthropic. Các bạn có thể ghi đè bằng cách đặt cacheRetention rõ ràng trong config.

Tham số cũ

Tham số cacheControlTtl cũ vẫn được hỗ trợ để tương thích ngược:

"5m" tương ứng với short
"1h" tương ứng với long

Mình khuyên các bạn nên chuyển sang dùng tham số cacheRetention mới.

OpenClaw bao gồm beta flag extended-cache-ttl-2025-04-11 cho các request Anthropic API; giữ lại nếu các bạn ghi đè provider headers (xem /gateway/configuration).

Phương án B: Claude setup-token

Phù hợp cho: sử dụng subscription Claude của các bạn.

Lấy setup-token ở đâu

Setup-token được tạo bởi Claude Code CLI, không phải Anthropic Console. Các bạn có thể chạy lệnh này trên bất kỳ máy nào:

claude setup-token

Dán token vào OpenClaw (wizard: Anthropic token (paste setup-token)), hoặc chạy trên gateway host:

openclaw models auth setup-token --provider anthropic

Nếu các bạn tạo token trên máy khác, hãy dán nó vào:

openclaw models auth paste-token --provider anthropic

Cài đặt qua CLI

# Dán setup-token trong quá trình onboarding
openclaw onboard --auth-choice setup-token

Config mẫu

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

Lưu ý

Tạo setup-token bằng claude setup-token và dán vào, hoặc chạy openclaw models auth setup-token trên gateway host.
Nếu thấy lỗi “OAuth token refresh failed …” với Claude subscription, hãy xác thực lại bằng setup-token. Xem /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
Chi tiết xác thực và quy tắc tái sử dụng ở /concepts/oauth.

Troubleshooting

Lỗi 401 / token đột ngột không hợp lệ

Xác thực Claude subscription có thể hết hạn hoặc bị thu hồi. Chạy lại claude setup-token và dán vào gateway host.
Nếu Claude CLI login nằm trên máy khác, dùng openclaw models auth paste-token --provider anthropic trên gateway host.

No API key found for provider “anthropic”

Xác thực là theo từng agent. Agent mới không kế thừa key của agent chính.
Chạy lại onboarding cho agent đó, hoặc dán setup-token / API key trên gateway host, sau đó kiểm tra bằng openclaw models status.

No credentials found for profile anthropic:default

Chạy openclaw models status để xem auth profile nào đang hoạt động.
Chạy lại onboarding, hoặc dán setup-token / API key cho profile đó.

No available auth profile (all in cooldown/unavailable)

Kiểm tra openclaw models status --json xem auth.unusableProfiles.
Thêm profile Anthropic khác hoặc đợi hết cooldown.

Xem thêm: /gateway/troubleshooting và /help/faq.