Chuyển đến nội dung chính

​
Anthropic (Claude)

Anthropic xây dựng họ mô hình Claude và cung cấp quyền truy cập thông qua API. Trong OpenClaw, bạn có thể xác thực bằng API key hoặc setup-token.

​
Tùy chọn A: Khóa API Anthropic

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

​
Thiết lập CLI

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​
Mẫu cấu hình

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

​
Lưu đệm prompt (Anthropic API)

OpenClaw hỗ trợ tính năng lưu bộ đệm prompt của Anthropic. Đây là chỉ-API; xác thực bằng subscription không tôn trọng các thiết lập cache.

​
Cấu hình

Dùng tham số cacheRetention trong cấu hình mô hình của bạn:
Giá trịThời lượng lưu đệmMô tả
noneKhông lưu đệmTắt lưu đệm prompt
short5 phútMặc định cho xác thực bằng khóa API
long1 giờLưu đệm mở rộng (cần cờ beta)
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

​
Mặc định

Khi sử 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ả các mô hình Anthropic. Bạn có thể ghi đè điều này bằng cách đặt cacheRetention một cách tường minh trong cấu hình của bạn.

​
Tham số cũ

Tham số cũ cacheControlTtl vẫn được hỗ trợ để tương thích ngược:
  • "5m" ánh xạ sang short
  • "1h" ánh xạ sang long
Chúng tôi khuyến nghị chuyển sang tham số mới cacheRetention. OpenClaw bao gồm cờ beta extended-cache-ttl-2025-04-11 cho các yêu cầu Anthropic API; hãy giữ cờ này nếu bạn ghi đè header của nhà cung cấp (xem /gateway/configuration).

​
Tùy chọn B: Claude setup-token

Phù hợp nhất cho: dùng gói thuê bao Claude của bạn.

​
Lấy setup-token ở đâu

Setup-token được tạo bởi Claude Code CLI, không phải Anthropic Console. Bạn có thể chạy điều này trên bất kỳ máy nào: 
claude setup-token
Dán token vào OpenClaw (trình hướng dẫn: Anthropic token (dán setup-token)), hoặc chạy lệnh trên máy chủ gateway: 
openclaw models auth setup-token --provider anthropic
Nếu bạn tạo token trên một máy khác, hãy dán nó: 
openclaw models auth paste-token --provider anthropic

​
Thiết lập CLI (setup-token)

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

​
Mẫu cấu hình (setup-token)

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

​
Ghi chú

​
Xử lý sự cố

Lỗi 401 / token đột nhiên 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 nó vào gateway host.
  • Nếu đăng nhập Claude CLI nằm trên một máy khác, dùng openclaw models auth paste-token --provider anthropic trên máy chủ gateway.
Không tìm thấy khóa API cho nhà cung cấp “anthropic”
  • Xác thực là theo từng agent. Các tác nhân mới không kế thừa khóa của tác nhân chính.
  • Chạy lại hướng dẫn ban đầu cho tác tử đó, hoặc dán setup-token / khóa API trên máy chủ gateway, rồi xác minh bằng openclaw models status.
Không tìm thấy thông tin xác thực cho hồ sơ anthropic:default
  • Chạy openclaw models status để xem hồ sơ xác thực nào đang hoạt động.
  • Chạy lại hướng dẫn ban đầu, hoặc dán setup-token / khóa API cho hồ sơ đó.
Không có hồ sơ xác thực khả dụng (tất cả đang cooldown/không khả dụng)
  • Kiểm tra openclaw models status --json cho auth.unusableProfiles.
  • Thêm một hồ sơ Anthropic khác hoặc chờ hết cooldown.
Xem thêm: /gateway/troubleshooting và /help/faq.