- 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ủ
Bắt đầu
- Khóa API
- Claude CLI
Phù hợp nhất cho: truy cập API tiêu chuẩn và thanh toán theo mức sử dụng.
Lấy khóa API của bạn
Tạo khóa API trong Anthropic Console.
Ví dụ cấu hình
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 và /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:
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)
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
- 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 betaserver-side-fallback-2026-06-01cộng vớifallbacks: [{"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. - 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.
- 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).
- 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.
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_fallbacktrên tin nhắn trợ lý, nêufromModelvàtoModel, vàresponseModelcủa tin nhắn báo cáoclaude-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 choanthropic/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ớ đệm | Mô tả |
|---|---|---|
"short" (mặc định) | 5 phút | Tự độ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ớ đệm | Tắt bộ nhớ đệm prompt |
Ghi đè bộ nhớ đệm theo tác tử
Ghi đè bộ nhớ đệm theo tác tử
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 Thứ tự hợp nhất cấu hình:
agents.list[].params:agents.defaults.models["provider/model"].paramsagents.list[].params(khớpid, ghi đè theo khóa)
Ghi chú về Bedrock Claude
Ghi chú về Bedrock Claude
- Các mô hình Anthropic Claude trên Bedrock (
amazon-bedrock/*anthropic.claude*) chấp nhận truyền quacacheRetentionkhi đượ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
Chế độ nhanh
Chế độ nhanh
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 on | service_tier: "auto" |
/fast off | service_tier: "standard_only" |
- 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ênservice_tier. - Tham số
serviceTierhoặcservice_tierrõ ràng sẽ ghi đè/fastkhi 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ànhstandard.
Hiểu phương tiện (hình ảnh và PDF)
Hiểu phương tiện (hình ảnh và PDF)
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.
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.
| Thuộc tính | Giá trị |
|---|---|
| Mô hình mặc định | claude-opus-4-8 |
| Đầu vào được hỗ trợ | Hình ảnh, tài liệu PDF |
Cửa sổ ngữ cảnh 1M
Cửa sổ ngữ cảnh 1M
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: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.Ngữ cảnh 1M của Claude Opus 4.8
Ngữ cảnh 1M của Claude Opus 4.8
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ố
Lỗi 401 / mã thông báo đột ngột không hợp lệ
Lỗi 401 / mã thông báo đột ngột không hợp lệ
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ế.
Không tìm thấy khóa API cho nhà cung cấp "anthropic"
Không tìm thấy khóa API cho nhà cung cấp "anthropic"
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.Không tìm thấy thông tin xác thực cho hồ sơ "anthropic:default"
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 quy trình onboarding, hoặc cấu hình khóa API cho đường dẫn hồ sơ đó.Không có hồ sơ xác thực khả dụng (tất cả đang trong thời gian chờ)
Không có hồ sơ xác thực khả dụng (tất cả đang trong thời gian chờ)
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ờ.Trợ giúp thêm: Khắc phục sự cố và Câu hỏi thường gặp.
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.