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:

{
  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ú¶

• Tạo setup-token bằng claude setup-token rồi dán vào, hoặc chạy openclaw models auth setup-token trên máy chủ gateway.
• Nếu bạn thấy “OAuth token refresh failed …” trên một 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 + quy tắc tái sử dụng nằm tại /concepts/oauth.

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.