​

Anthropic (Claude)

​

Lựa chọn A: API key của Anthropic

​

Thiết lập CLI

openclaw onboard
# chọn: Anthropic API key

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

​

Đoạn cấu hình

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

​

Mặc định suy nghĩ (Claude 4.6)

• Mô hình Anthropic Claude 4.6 mặc định là adaptive trong OpenClaw khi không có mức suy nghĩ cụ thể nào được đặt.
• Bạn có thể ghi đè theo từng tin nhắn (/think:<level>) hoặc trong tham số mô hình: agents.defaults.models["anthropic/<model>"].params.thinking.
• Tài liệu liên quan của Anthropic:
  • Adaptive thinking
  • Extended thinking

​

Chế độ nhanh (Anthropic API)

• /fast on ánh xạ tới service_tier: "auto"
• /fast off ánh xạ tới service_tier: "standard_only"
• Cấu hình mặc định:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

• Đây chỉ dành cho API-key. Setup-token / OAuth của Anthropic không hỗ trợ tiêm tầng nhanh của OpenClaw.
• OpenClaw chỉ tiêm tầng dịch vụ của Anthropic cho các yêu cầu trực tiếp api.anthropic.com. Nếu bạn định tuyến anthropic/* qua proxy hoặc gateway, /fast sẽ giữ nguyên service_tier.
• Anthropic báo cáo tầng hiệu quả trong phản hồi dưới usage.service_tier. Trên các tài khoản không có khả năng Tầng Ưu tiên, service_tier: "auto" có thể vẫn giải quyết thành standard.

​

Bộ nhớ đệm prompt (Anthropic API)

​

Cấu hình

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

​

Mặc định

​

Ghi đè cacheRetention theo từng agent

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // cơ sở cho hầu hết các agent
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // ghi đè chỉ cho agent này
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params (khớp id, ghi đè theo khóa)

​

Ghi chú Claude trên Bedrock

• Các mô hình Anthropic Claude trên Bedrock (amazon-bedrock/*anthropic.claude*) chấp nhận truyền qua cacheRetention khi được cấu hình.
• Các mô hình Bedrock không phải của Anthropic bị buộc phải cacheRetention: "none" khi chạy.
• Mặc định thông minh của API-key Anthropic cũng đặt cacheRetention: "short" cho các tham chiếu mô hình Claude-on-Bedrock khi không có giá trị rõ ràng nào được đặt.

​

Tham số cũ

• "5m" ánh xạ tới short
• "1h" ánh xạ tới long

​

Cửa sổ ngữ cảnh 1M (Anthropic beta)

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

​

Lựa chọn B: Claude setup-token

​

Nơi lấy setup-token

claude setup-token

openclaw models auth setup-token --provider anthropic

openclaw models auth paste-token --provider anthropic

​

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

# Dán một setup-token trong quá trình thiết lập
openclaw onboard --auth-choice setup-token

​

Đoạn cấu hình (setup-token)

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

​

Ghi chú

• Tạo setup-token với claude setup-token và dán nó, 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 đăng ký Claude, xác thực lại với setup-token. Xem /gateway/troubleshooting.
• Chi tiết xác thực + quy tắc tái sử dụng có trong /concepts/oauth.

​

Khắc phục sự cố

• Xác thực đăng ký Claude 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 máy chủ gateway.
• Nếu đăng nhập Claude CLI nằm trên một máy khác, sử dụng openclaw models auth paste-token --provider anthropic trên máy chủ gateway.

• Xác thực là theo từng agent. Các agent mới không thừa hưởng khóa của agent chính.
• Chạy lại onboarding cho agent đó, hoặc dán một setup-token / API key trên máy chủ gateway, sau đó xác minh với openclaw models status.

• Chạy openclaw models status để xem hồ sơ xác thực nào đang hoạt động.
• Chạy lại onboarding, hoặc dán một setup-token / API key cho hồ sơ đó.

• Kiểm tra openclaw models status --json cho auth.unusableProfiles.
• Thêm một hồ sơ Anthropic khác hoặc chờ cooldown.