- Khóa API - truy cập trực tiếp API Anthropic với phương thức tính phí dựa trên mức sử dụng (các mô hình
anthropic/*) - Claude CLI - sử dụng lại thông tin đăng nhập Claude Code hiện có trên cùng máy chủ
Theo dõi mức sử dụng và chi phí
OpenClaw phát hiện thông tin xác thực Anthropic khả dụng và chọn giao diện mức sử dụng tương ứng:- Thông tin xác thực đăng ký/thiết lập Claude hiển thị các khoảng hạn ngạch và ngân sách sử dụng bổ sung tùy chọn.
ANTHROPIC_ADMIN_KEYhoặcANTHROPIC_ADMIN_API_KEYhiển thị 30 ngày chi phí tổ chức và mức sử dụng Messages API do nhà cung cấp báo cáo trong mục Mức sử dụng của Control UI, bao gồm chi tiêu hằng ngày, tổng số token/bộ nhớ đệm, các mô hình hàng đầu và các hạng mục chi phí.- Thông tin xác thực
sk-ant-admin...được lưu trong hồ sơ nhà cung cấp Anthropic sẽ tự động được phát hiện là khóa Admin API.
Bắt đầu
- Khóa API
- Claude CLI
Phù hợp nhất cho: quyền truy cập API tiêu chuẩn và phương thức tính phí dựa trên mức sử dụng.Hoặc truyền trực tiếp khóa:
1
Lấy khóa API
Tạo khóa API trong Anthropic Console.
2
Chạy quy trình thiết lập ban đầu
3
Xác minh mô hình khả dụng
Ví dụ cấu hình
Các phiên Claude trên nhiều máy tính
Plugin Anthropic đi kèm bổ sung nhóm Claude Code vào thanh bên phiên thông thường. Các hàng mở trong ngăn Trò chuyện thông thường. Plugin phát hiện các phiên Claude Code chưa được lưu trữ trên Gateway và trên các máy chủ node đã kết nối:- Các phiên Claude CLI đến từ bản ghi chỉ mục dự án hợp lệ và các tệp JSONL hiện tại
có tiền tố siêu dữ liệu bị giới hạn xác định một phiên
sdk-clikhông phải sidechain trong~/.claude/projects/. - Các phiên Claude Desktop sử dụng tiêu đề Desktop, thời gian hoạt động và trạng thái lưu trữ khi siêu dữ liệu của chúng trỏ đến cùng một ID phiên Claude Code.
- Phiên chỉ có CLI không có cờ lưu trữ, vì vậy phiên đó vẫn hiển thị khi bản ghi hội thoại còn tồn tại.
~/.claude/projects/ cục bộ tồn tại.
Hãy phê duyệt nâng cấp ghép nối node khi các lệnh đó xuất hiện lần đầu.
Thanh bên nhóm các hàng theo Gateway hoặc máy chủ node đã ghép nối và hiển thị
trang giới hạn mới nhất của mỗi máy chủ ngay khi máy tính đó phản hồi. Thanh bên đối soát lại
sau khi kết nối máy chủ thay đổi, khi trang lấy lại tiêu điểm và tối đa mỗi
30 giây khi đang hiển thị, nhờ đó các phiên Claude được tạo bên ngoài OpenClaw xuất hiện
mà không cần tải lại. Danh mục đã thay đổi sẽ kích hoạt lượt theo dõi nhanh hơn. Sử dụng Tải thêm
phiên bên dưới một nhóm danh mục để nối thêm trang tiếp theo cho mọi máy chủ có
thêm lịch sử; các hàng được nối thêm vẫn hiển thị và được tìm nạp lại đến cùng độ sâu
qua các lần làm mới. Các máy khách danh mục sử dụng sessions.catalog.list; việc mở một hàng sử dụng
sessions.catalog.read.
Quyền tiếp quản terminal phân giải claude từ PATH của shell đăng nhập của người dùng máy chủ sở hữu
trước PATH của dịch vụ/daemon. Điều này giữ cho các phiên được khởi chạy từ ứng dụng đồng nhất
với Claude CLI mà người vận hành nhận được trong terminal thông thường.
Việc chọn một hàng sẽ đọc trang bản ghi hội thoại mới nhất trước. Tải các mục bản ghi hội thoại
cũ hơn đi theo con trỏ byte mờ và đọc một phần giới hạn khác từ
tệp JSONL thay vì tải toàn bộ lịch sử. Nội dung thông thường của người dùng, trợ lý,
lập luận, lệnh gọi công cụ và kết quả công cụ được giữ nguyên. Một mục riêng lẻ
lớn hơn giới hạn an toàn của node/Gateway được đánh dấu rõ ràng là đã bị cắt bớt.
Đối với hàng claude-cli cục bộ trên Gateway, việc nhập trong trình soạn thảo thông thường sẽ gọi
sessions.catalog.continue. OpenClaw phân giải lại bản ghi danh mục cục bộ,
tạo hoặc sử dụng lại phiên gốc bị khóa theo mô hình, nhập tối đa 200 mục hiển thị
hoặc 512 KiB và khởi tạo liên kết Claude CLI. Lượt đầu tiên tiếp tục với
--fork-session; Claude gán cho bản phân nhánh một ID phiên mới, vì vậy các lượt sau sử dụng
bản phân nhánh còn phiên nguồn không bị thay đổi.
Máy chủ node không có giao diện cũng có thể cho phép tiếp tục các hàng Claude CLI bằng cách bật
cài đặt cục bộ của node bên dưới rồi khởi động lại máy chủ node:
agent.cli.claude.run.v1 khi cài đặt được bật
và tệp thực thi claude cục bộ của node được phân giải. OpenClaw phân giải lại bản ghi danh mục
trên node đó, nhập cùng phần lịch sử bị giới hạn và liên kết phiên được tiếp quản
với node và thư mục làm việc do danh mục báo cáo. Mỗi lượt chạy tiến trình
claude -p thực của node bằng các tệp Claude và thông tin đăng nhập của node đó. Chính sách
phê duyệt thực thi của node vẫn áp dụng; Gateway không thể ép buộc việc chủ động bật tính năng này.
Tính năng tiếp tục trên node v1 chỉ dùng một lần. Tính năng này bỏ qua cấu hình MCP vòng lặp Gateway và
các đối số Plugin Skills của Gateway, không khởi tạo lại từ bản ghi hội thoại Gateway,
đồng thời từ chối tệp đính kèm và hình ảnh. Các hàng Claude Desktop vẫn chỉ có thể xem. Các
node ứng dụng macOS gốc cũng vẫn chỉ có thể xem cho đến khi ứng dụng quảng bá lệnh chạy.
Các phiên Claude trên node đã ghép nối vẫn ở chế độ chỉ đọc trừ khi node không có giao diện quảng bá rõ ràng
agent.cli.claude.run.v1. OpenClaw không bao giờ sửa đổi siêu dữ liệu Claude Desktop
hoặc lưu trữ các phiên Claude. Trang này yêu cầu kết nối người vận hành
có phạm vi ghi vì sử dụng node.invoke đã xác thực; thao tác liệt kê và đọc
vẫn ở chế độ chỉ đọc ngay cả trên node đã bật tính năng tiếp tục.Thiết lập mặc định về suy luận (Claude Sonnet 5, Mythos 5, Fable 5, 4.8 và 4.6)
anthropic/claude-sonnet-5 mặc định sử dụng suy luận thích ứng với mức nỗ lực high.
Dùng /think off để tắt suy luận hoặc /think xhigh|max để sử dụng các
mức nỗ lực gốc cao hơn của mô hình. OpenClaw bỏ qua ngân sách suy luận thủ công,
tham số lấy mẫu tùy chỉnh, phần điền trước của trợ lý và Priority Tier đối với
Sonnet 5 vì Anthropic không hỗ trợ các tính năng yêu cầu này trên mô hình đó.
Danh mục sử dụng mức giá đầu vào/đầu ra giới thiệu $2/$10 của Anthropic đến hết
ngày 31 tháng 8 năm 2026; mức giá tiêu chuẩn $3/$15 bắt đầu từ ngày 1 tháng 9 năm 2026.
anthropic/claude-fable-5 luôn sử dụng suy luận thích ứng và mặc định có mức nỗ lực
high. Anthropic không cho phép tắt suy luận đối với mô hình này, vì vậy
/think off và /think minimal được ánh xạ sang mức nỗ lực low. OpenClaw cũng
bỏ qua các giá trị nhiệt độ tùy chỉnh cho yêu cầu Fable 5 vì Anthropic từ chối
ghi đè nhiệt độ đối với mọi yêu cầu đã bật suy luận.
anthropic/claude-mythos-5 là mô hình có quyền truy cập hạn chế với cùng hợp đồng
suy luận thích ứng luôn bật. OpenClaw mặc định dùng high, ánh xạ /think off và
/think minimal sang low, đồng thời bỏ qua các tham số lấy mẫu do bên gọi chọn.
Danh mục công bố cửa sổ ngữ cảnh 1.000.000 token, giới hạn đầu ra 128.000 token,
đầu vào hình ảnh và mức giá đầu vào/đầu ra $10/$50 của mô hình này.
Claude Opus 4.8 duy trì trạng thái tắt suy luận 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 sẽ gửi
các giá trị nỗ lực Opus 4.8 của Anthropic; các mô hình Claude 4.6 (Opus 4.6 và Sonnet 4.6)
mặc định dùng adaptive.
Ghi đè cho 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:
Cơ chế dự phòng khi từ chối vì an toàn (Claude Fable 5)
Lý do tồn tại
Các bộ phân loại của Fable 5 trả vềstop_reason: "refusal" đối với yêu cầu thuộc
các lĩnh vực bị hạn chế, đồng thời cũng có thể nhận diện nhầm đối với công việc lành tính
nhưng có liên quan (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 chính nó). Nếu không có cơ chế dự phòng, lượt sẽ kết thúc bằng lỗi dù
một mô hình Claude khác vẫn có thể xử lý 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ột mô hình dự phòng.
Cách hoạt động
- Đối với mọi yêu cầu trực tiếp bằng khóa API tới
anthropic/claude-fable-5, OpenClaw gửi tùy chọn tham gia cơ chế dự phòng phía máy chủ của Anthropic: tiêu đề 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 mà Anthropic cho phép đối với Fable 5. - Chỉ trường hợp bộ phân loại an toàn từ chối mới kích hoạt cơ chế dự phòng. Giới hạn tốc độ, quá tải và lỗi máy chủ hoạt động hoàn toàn như trước và được xử lý qua cơ chế chuyển đổi dự phòng mô hình thông thường của OpenClaw.
- Quá trình khôi phục diễn ra trong cùng một lệnh gọi. Trường hợp từ chối trước khi có đầu ra sẽ không thể nhận biết ngoài độ trễ; toàn bộ câu trả lời đến từ Opus 4.8. Khi bị từ chối giữa luồng, phần văn bản đã tạo được giữ lại làm tiền tố để mô hình dự phòng tiếp tục, còn phần 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 (không được phản hồi lại hoặc thực thi chúng).
- Nếu Claude Opus 4.8 cũng từ chối, lượt sẽ hiển thị lời từ chối dưới dạng lỗi, hoàn toàn giố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 hoặc chuỗi dự phòng đã cấu hình — khóa API
có khả năng dùng Fable luôn có thể phục vụ Opus.
Khả năng quan sát và tính phí
- Một lượt do mô hình dự phòng phục vụ sẽ ghi lại chẩn đoán
provider_fallbacktrên tin nhắn của trợ lý, trong đó nêufromModelvàtoModel; đồng thờiresponseModelcủa tin nhắn báo cáoclaude-opus-4-8. - Anthropic tính phí theo từng lần thử: trường hợp từ chối trước khi có đầu ra không mất phí, còn lượt khôi phục được tính theo mức giá Claude Opus 4.8 (hiện bằng một nửa mức giá Fable 5). Ước tính chi phí theo lượt của OpenClaw định giá các lượt do mô hình dự phòng phục vụ theo mức giá Opus để khớp với cách tính này.
- Trường hợp từ chối giữa luồng còn bị Anthropic tính phí cho phần Fable đã truyền phát; phần đó được báo cáo trong mức sử dụng theo từng lần thử của API nhưng không được cộng vào ước tính theo lượt của OpenClaw.
Phạm vi
Áp dụng choanthropic/claude-fable-5 sử dụng phương thức xác thực bằng khóa API vớ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ị
lời từ chối dưới dạng lỗi tại đó.
Đã xác minh trực tiếp: một lời nhắc lành tính yêu cầu Fable 5 tái tạo chuỗi
suy luận thô của chính nó bị từ chối với category: "reasoning_extraction" khi gửi mà không có
cơ chế dự phòng, còn cùng lời nhắc đó thông qua OpenClaw trả về câu trả lời bình thường
do Opus phục vụ, kèm theo chẩn đoán provider_fallback.
Xem hướng dẫn về lời từ chối và cơ chế dự phòng của Anthropic
để biết hành vi nền tảng.
Bộ nhớ đệm lời nhắc
OpenClaw hỗ trợ tính năng bộ nhớ đệm lời nhắc của Anthropic đối với phương thức xác thực bằng khóa API.Ghi đè bộ nhớ đệm theo từng tác nhân
Ghi đè bộ nhớ đệm theo từng tác nhân
Dùng tham số cấp mô hình làm giá trị cơ sở, sau đó ghi đè cho các tác nhân 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ớp vớiid, ghi đè theo khóa)
Ghi chú về Claude trên Bedrock
Ghi chú về Claude trên Bedrock
- Các mô hình Anthropic Claude trên Bedrock (
amazon-bedrock/*anthropic.claude*) chấp nhận truyền trực tiếpcacheRetentionkhi được cấu hình. - Các mô hình Bedrock không phải Anthropic bị buộc sử dụng
cacheRetention: "none"trong thời gian chạy. - Các giá trị mặc định thông minh dành cho khóa API cũng khởi tạo
cacheRetention: "short"cho các tham chiếu Claude trên Bedrock khi không đặt giá trị rõ ràng.
Cấu hình nâng cao
Chế độ nhanh
Chế độ nhanh
Nút chuyển đổi
/fast dùng chung của OpenClaw đặt trường service_tier của Anthropic thành api.anthropic.com đối với lưu lượng trực tiếp sử dụng khóa API.- Chỉ áp dụng cho các yêu cầu
api.anthropic.comtrực tiếp được thực hiện bằng khóa API. Các yêu cầu bằng OAuth/token đăng ký và các tuyến proxy không bao giờ nhận trườngservice_tier. - Các tham số
serviceTierhoặcservice_tierđược đặt rõ ràng sẽ ghi đè/fastkhi cả hai cùng được đặt. - Trên các tài khoản không có dung lượng Priority Tier,
service_tier: "auto"có thể được phân giải thànhstandard.
Hiểu nội dung đa phương tiện (hình ảnh và PDF)
Hiểu nội dung đa 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 đa phương tiện từ phương thức 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 hội thoại, OpenClaw tự động
định tuyến nội dung đó qua nhà cung cấp khả năng hiểu đa phương tiện Anthropic.
Cửa sổ ngữ cảnh 1M
Cửa sổ ngữ cảnh 1M
Claude Sonnet 5, Mythos 5 và Fable 5 có cửa sổ đầu vào chính xác
1,000,000 token và hỗ trợ tối đa 128,000 token đầu ra. Cửa sổ ngữ cảnh
1M của Anthropic cũng đã khả dụng rộng rãi trên các mô hình Claude 4.x có tư duy thích ứng: Opus 4.8,
Opus 4.7, Opus 4.6 và Sonnet 4.6. OpenClaw tự động xác định kích thước
cho các mô hình này, không cần Các cấu hình cũ có thể giữ lại
params.context1m:params.context1m: true; đây là thao tác không gây ảnh hưởng đối với
các mô hình này và OpenClaw không còn gửi tiêu đề beta
context-1m-2025-08-07 đã ngừng sử dụng trong mọi trường hợp. Các mục cấu hình anthropicBeta cũ
có giá trị đó sẽ bị loại bỏ trong quá trình phân giải tiêu đề yêu cầu, còn
các mô hình Claude cũ không được hỗ trợ vẫn sử dụng cửa sổ ngữ cảnh thông thường.params.context1m: true hoạt động tương tự đối với phần phụ trợ CLI Claude
(claude-cli/*): các mô hình Opus và Sonnet đủ điều kiện hỗ trợ GA đã tự động nhận
cửa sổ 1M, vì vậy tham số này cũng là tùy chọn tại đó.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ó mặc định có cửa sổ ngữ cảnh
1M; không cần params.context1m: true.Khắc phục sự cố
Lỗi 401/token đột nhiên không hợp lệ
Lỗi 401/token đột nhiên không hợp lệ
Xác thực bằng token Anthropic sẽ hết hạn và có thể bị thu hồi. Đối với thiết lập mới, hãy sử dụng khóa API Anthropic.
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"
Phương thức xác thực Anthropic được cấu hình theo từng tác nhân; 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 quy trình thiết lập ban đầu cho tác nhân đó (hoặc cấu hình khóa API trên máy chủ Gateway), sau đó 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 thiết lập ban đầu 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 cho auth.unusableProfiles. Thời gian chờ do giới hạn tốc độ của Anthropic có thể áp dụng theo từng mô hình, vì vậy một mô hình Anthropic cùng nhóm vẫn có thể sử dụng được. Thêm một 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
Lựa chọn mô hình
Chọn nhà cung cấp, tham chiếu mô hình và cơ chế chuyển đổi dự phòng.
Backend CLI
Thiết lập backend Claude CLI và thông tin chi tiết về runtime.
Bộ nhớ đệm prompt
Cách bộ nhớ đệm prompt hoạt động trên các nhà cung cấp.
OAuth và xác thực
Thông tin chi tiết về xác thực và các quy tắc tái sử dụng thông tin xác thực.