Chuyển đến nội dung chính
Anthropic xây dựng dòng mô hình Claude. OpenClaw hỗ trợ hai tuyến xác thực:
  • Khóa API — truy cập trực tiếp Anthropic API với thanh toán theo mức sử dụng (các mô hình anthropic/*)
  • Claude CLI — tái sử dụng đăng nhập Claude Code hiện có trên cùng máy chủ
Backend Claude CLI của OpenClaw chạy Claude Code CLI đã cài đặt ở chế độ in không tương tác. Tài liệu Claude Code hiện tại của Anthropic mô tả claude -p là cách dùng Agent SDK/lập trình. Bản cập nhật hỗ trợ ngày 15 tháng 6 năm 2026 của Anthropic đã tạm dừng thay đổi thanh toán Agent SDK đã công bố. Hiện tại, Anthropic cho biết Claude Agent SDK, claude -p, và việc sử dụng ứng dụng bên thứ ba vẫn tính vào giới hạn sử dụng của gói đăng ký. Khoản tín dụng Agent SDK hằng tháng đã công bố trước đó không khả dụng trong khi Anthropic điều chỉnh lại kế hoạch đó.Claude Code tương tác vẫn tính vào giới hạn của gói Claude đã đăng nhập. Xác thực bằng khóa API vẫn là thanh toán API trực tiếp theo mức sử dụng. Với các máy chủ Gateway chạy lâu dài, tự động hóa dùng chung, và chi phí sản xuất dễ dự đoán, hãy dùng khóa API Anthropic.Kiểm tra các bài viết hỗ trợ hiện tại của Anthropic trước khi dựa vào hành vi thanh toán theo gói đăng ký:

Bắt đầu

Phù hợp nhất cho: truy cập API tiêu chuẩn và thanh toán theo mức sử dụng.
1

Lấy khóa API của bạn

Tạo khóa API trong Anthropic Console.
2

Chạy onboarding

openclaw onboard
# choose: Anthropic API key
Hoặc truyền khóa trực tiếp:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Xác minh mô hình khả dụng

openclaw models list --provider anthropic

Ví dụ cấu hình

{
  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

Mặc định suy luận (Claude Fable 5, 4.8 và 4.6)

anthropic/claude-fable-5 luôn dùng suy luận thích ứng và mặc định là nỗ lực high. Vì Anthropic không cho phép tắt suy luận cho mô hình này, /think off/think minimal dùng nỗ lực low. OpenClaw cũng bỏ qua các giá trị temperature tùy chỉnh cho yêu cầu Fable 5. Claude Opus 4.8 giữ suy luận tắt theo mặc định trong OpenClaw. Khi bạn bật rõ ràng suy luận thích ứng bằng /think high|xhigh|max, OpenClaw gửi các giá trị nỗ lực Opus 4.8 của Anthropic; các mô hình Claude 4.6 mặc định là adaptive. Ghi đè theo từng tin nhắn bằng /think:<level> hoặc trong tham số mô hình:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
Tài liệu Anthropic liên quan:

Phương án dự phòng khi từ chối vì an toàn (Claude Fable 5)

Dùng Claude Fable 5 cũng có nghĩa là dùng Claude Opus 4.8. Fable 5 đi kèm các bộ phân loại an toàn có thể từ chối một yêu cầu, và cách khôi phục được Anthropic chấp thuận là để claude-opus-4-8 phục vụ lượt đó. OpenClaw tự động chọn tham gia cơ chế này cho các yêu cầu khóa API trực tiếp, vì vậy một số lượt Fable được trả lời và tính phí như Claude Opus 4.8. Nếu chính sách hoặc ngân sách của bạn không thể chấp nhận các lượt do Opus phục vụ, đừng chọn anthropic/claude-fable-5.

Vì sao cơ chế này tồn tại

Các bộ phân loại Fable 5 trả về stop_reason: "refusal" với yêu cầu trong các miền bị hạn chế, và cũng nhận diện nhầm một số công việc gần với nội dung lành tính (công cụ bảo mật, khoa học sự sống, hoặc thậm chí yêu cầu mô hình tái tạo suy luận thô của nó). Nếu không có phương án dự phòng, lượt sẽ kết thúc bằng lỗi dù một mô hình Claude khác có thể phục vụ nó bình thường — thông báo từ chối của chính Anthropic yêu cầu các bên tích hợp API cấu hình mô hình dự phòng.

Cách hoạt động

  1. Với mọi yêu cầu khóa API trực tiếp tới anthropic/claude-fable-5, OpenClaw gửi tùy chọn tham gia dự phòng phía máy chủ của Anthropic: header beta server-side-fallback-2026-06-01 cộng với fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 là mục tiêu dự phòng duy nhất Anthropic cho phép với Fable 5.
  2. Chỉ từ chối của bộ phân loại an toàn mới kích hoạt dự phòng. Giới hạn tốc độ, quá tải, và lỗi máy chủ hoạt động đúng như trước và đi qua chuyển đổi dự phòng mô hình bình thường của OpenClaw.
  3. Việc cứu lượt diễn ra bên trong cùng một lệnh gọi. Một từ chối trước khi có bất kỳ đầu ra nào là vô hình ngoài độ trễ; toàn bộ câu trả lời đến từ Opus 4.8. Khi từ chối giữa luồng, phần văn bản một phần được giữ làm tiền tố để mô hình dự phòng tiếp tục từ đó, trong khi suy luận và các lệnh gọi công cụ của mô hình đã từ chối bị loại bỏ theo quy tắc phát lại của Anthropic (chúng không được vọng lại hoặc thực thi).
  4. Nếu Claude Opus 4.8 cũng từ chối, lượt hiển thị từ chối dưới dạng lỗi, đúng như trước khi có tính năng này.
Dự phòng diễn ra ở cấp Anthropic API, vì vậy claude-opus-4-8 không cần nằm trong danh sách mô hình đã cấu hình hoặc chuỗi dự phòng của bạn — khóa API có khả năng dùng Fable luôn có thể phục vụ Opus.

Quan sát và thanh toán

  • Một lượt được phục vụ bằng dự phòng ghi lại chẩn đoán provider_fallback trên tin nhắn trợ lý, nêu fromModeltoModel, và responseModel của tin nhắn báo cáo claude-opus-4-8.
  • Anthropic tính phí theo từng lần thử: từ chối trước đầu ra là miễn phí, và lượt cứu được tính theo giá Claude Opus 4.8 (hiện bằng một nửa giá Fable 5). Ước tính chi phí theo lượt của OpenClaw định giá các lượt được phục vụ bằng dự phòng theo giá Opus cho khớp.
  • Từ chối giữa luồng còn tính phí phần Fable một phần đã stream ở phía Anthropic; phần đó được báo cáo trong mức sử dụng theo lần thử của API nhưng không được gộp vào ước tính theo lượt của OpenClaw.

Phạm vi

Áp dụng cho anthropic/claude-fable-5 với xác thực khóa API tới api.anthropic.com. OAuth (tái sử dụng gói đăng ký Claude CLI), URL cơ sở proxy, các yêu cầu Bedrock, Vertex, và Foundry không thay đổi và vẫn hiển thị từ chối dưới dạng lỗi ở đó. Đã xác minh trực tiếp: một prompt lành tính yêu cầu Fable 5 tái tạo chuỗi suy nghĩ thô của nó bị từ chối với category: "reasoning_extraction" khi gửi mà không có dự phòng, và cùng prompt đó qua OpenClaw trả về một câu trả lời bình thường do Opus phục vụ với chẩn đoán provider_fallback được đính kèm. Xem hướng dẫn về từ chối và dự phòng của Anthropic để biết hành vi nền tảng.

Bộ nhớ đệm prompt

OpenClaw hỗ trợ tính năng bộ nhớ đệm prompt của Anthropic cho xác thực khóa API.
Giá trịThời lượng bộ nhớ đệmMô tả
"short" (mặc định)5 phútTự động áp dụng cho xác thực khóa API
"long"1 giờBộ nhớ đệm mở rộng
"none"Không dùng bộ nhớ đệmTắt bộ nhớ đệm prompt
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
Dùng tham số cấp mô hình làm đường cơ sở, rồi ghi đè các tác tử cụ thể qua agents.list[].params:
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } },
    ],
  },
}
Thứ tự hợp nhất cấu hình:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (khớp id, ghi đè theo khóa)
Điều này cho phép một agent giữ bộ nhớ đệm tồn tại lâu trong khi một agent khác trên cùng mô hình tắt bộ nhớ đệm cho lưu lượng bùng phát/tái sử dụng thấp.
  • 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 Anthropic bị buộc thành cacheRetention: "none" lúc chạy.
  • Mặc định thông minh cho khóa API cũng đặt sẵn cacheRetention: "short" cho các tham chiếu Claude-on-Bedrock khi chưa đặt giá trị rõ ràng.

Cấu hình nâng cao

Nút bật/tắt /fast dùng chung của OpenClaw hỗ trợ lưu lượng Anthropic trực tiếp (khóa API và OAuth tới api.anthropic.com).
LệnhÁnh xạ tới
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Chỉ được chèn cho các yêu cầu trực tiếp tới api.anthropic.com. Các tuyến proxy giữ nguyên service_tier.
  • Tham số serviceTier hoặc service_tier rõ ràng sẽ ghi đè /fast khi cả hai đều được đặt.
  • Trên các tài khoản không có dung lượng Priority Tier, service_tier: "auto" có thể phân giải thành standard.
Plugin Anthropic đi kèm đăng ký khả năng hiểu hình ảnh và PDF. OpenClaw tự động phân giải các khả năng phương tiện từ xác thực Anthropic đã cấu hình — không cần cấu hình bổ sung.
Thuộc tínhGiá trị
Mô hình mặc địnhclaude-opus-4-8
Đầu vào được hỗ trợHình ảnh, tài liệu PDF
Khi một hình ảnh hoặc PDF được đính kèm vào cuộc trò chuyện, OpenClaw tự động định tuyến nó qua nhà cung cấp hiểu phương tiện Anthropic.
Cửa sổ ngữ cảnh 1M của Anthropic có sẵn trên các mô hình Claude 4.x hỗ trợ GA như Opus 4.8, Opus 4.7, Opus 4.6 và Sonnet 4.6. OpenClaw tự động đặt kích thước các mô hình đó ở 1M:
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {},
      },
    },
  },
}
Các cấu hình cũ hơn có thể giữ params.context1m: true, nhưng OpenClaw không còn gửi tiêu đề beta context-1m-2025-08-07 đã ngừng sử dụng. Các mục cấu hình anthropicBeta cũ hơn có giá trị đó bị bỏ qua trong quá trình phân giải tiêu đề yêu cầu và các mô hình Claude cũ hơn không được hỗ trợ vẫn dùng cửa sổ ngữ cảnh bình thường của chúng.params.context1m: true cũng áp dụng cho phần phụ trợ Claude CLI (claude-cli/*) đối với các mô hình Opus và Sonnet đủ điều kiện hỗ trợ GA, giữ nguyên cửa sổ ngữ cảnh lúc chạy cho các phiên CLI đó để khớp với hành vi API trực tiếp.
Yêu cầu quyền truy cập ngữ cảnh dài trên thông tin xác thực Anthropic của bạn. Xác thực bằng OAuth/mã thông báo đăng ký giữ các tiêu đề beta Anthropic bắt buộc của nó, nhưng OpenClaw loại bỏ tiêu đề beta 1M đã ngừng sử dụng nếu tiêu đề đó vẫn còn trong cấu hình cũ hơn.
anthropic/claude-opus-4-8 và biến thể claude-cli của nó có cửa sổ ngữ cảnh 1M theo mặc định — không cần params.context1m: true.

Khắc phục sự cố

Xác thực bằng mã thông báo Anthropic hết hạn và có thể bị thu hồi. Với thiết lập mới, hãy dùng khóa API Anthropic thay thế.
Xác thực Anthropic là theo từng agent — các agent mới không kế thừa khóa của agent chính. Chạy lại quy trình onboarding cho agent đó (hoặc cấu hình khóa API trên máy chủ gateway), rồi xác minh bằng 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 quy trình onboarding, hoặc cấu hình khóa API cho đường dẫn hồ sơ đó.
Kiểm tra openclaw models status --json để xem auth.unusableProfiles. Thời gian chờ do giới hạn tốc độ Anthropic có thể theo phạm vi mô hình, nên một mô hình Anthropic cùng nhóm vẫn có thể dùng được. Thêm hồ sơ Anthropic khác hoặc chờ hết thời gian chờ.

Liên quan

Chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Phần phụ trợ CLI

Thiết lập phần phụ trợ Claude CLI và chi tiết lúc chạy.

Bộ nhớ đệm lời nhắc

Cách bộ nhớ đệm lời nhắc hoạt động trên các nhà cung cấp.

OAuth và xác thực

Chi tiết xác thực và quy tắc tái sử dụng thông tin xác thực.