Skip to main content
Anthropic phát triển dòng mô hình Claude. OpenClaw hỗ trợ hai phương thức xác thực:
  • 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_KEY hoặc ANTHROPIC_ADMIN_API_KEY hiể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.
Lịch sử chi phí Admin API lấy từ API mức sử dụng và chi phí của Anthropic. Đây là chi phí thực tế do nhà cung cấp tính, tách biệt với chi phí ước tính của OpenClaw được suy ra từ phiên.
Backend Claude CLI của OpenClaw chạy Claude Code CLI đã cài đặt ở chế độ in không tương tác (claude -p). Tài liệu Claude Code hiện tại của Anthropic mô tả chế độ đó là cách sử 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 tính phí Agent SDK riêng biệt từng được công bố: Claude Agent SDK, claude -p và việc sử dụng ứng dụng bên thứ ba vẫn được tính vào giới hạn sử dụng của gói đăng ký đã đăng nhập, đồng thời khoản tín dụng Agent SDK hằng tháng được công bố trước đó không khả dụng trong khi Anthropic điều chỉnh kế hoạch này.Claude Code tương tác vẫn được 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 được tính phí trực tiếp theo mức sử dụng và không phụ thuộc vào gói đó. Đối với các máy chủ Gateway hoạt động lâu dài, tác vụ tự động hóa dùng chung và chi phí vận hành sản xuất có thể dự đoán, hãy sử dụng khóa API Anthropic.Các bài viết hỗ trợ hiện tại của Anthropic có thể thay đổi hành vi này mà không cần phát hành phiên bản OpenClaw mới:

Bắt đầu

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.
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

Hoặc truyền trực tiếp khóa:
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-cli khô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.
Không cần cấu hình OpenClaw bổ sung để phát hiện. Plugin Anthropic được đi kèm và bật theo mặc định; node macOS gốc quảng bá các lệnh phiên Claude chỉ đọc khi thư mục ~/.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:
Node chỉ quảng bá 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.
Xem Node: phiên Claude và bản ghi hội thoại để biết lệnh Node và ranh giới bảo mật.

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/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/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)

Sử dụng Claude Fable 5 cũng đồng nghĩa với việc sử 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 đối với các yêu cầu trực tiếp bằng khóa API, vì vậy một số lượt Fable được Claude Opus 4.8 trả lời và tính phí. 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.

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

  1. Đố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 đề 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 mà Anthropic cho phép đối với Fable 5.
  2. 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.
  3. 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).
  4. 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.
Cơ chế dự phòng diễn ra ở cấp API Anthropic, vì vậ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_fallback trên tin nhắn của trợ lý, trong đó nêu fromModeltoModel; đồng thời responseModel của tin nhắn báo cáo claude-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 cho anthropic/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.
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 agents.list[].params:
Thứ tự hợp nhất cấu hình:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (khớp với id, ghi đè theo khóa)
Điều này cho phép một tác nhân duy trì bộ nhớ đệm dài hạn, trong khi một tác nhân khác sử dụng cùng mô hình có thể tắt bộ nhớ đệm cho lưu lượng đột biến/ít tái sử dụng.
  • Các mô hình Anthropic Claude trên Bedrock (amazon-bedrock/*anthropic.claude*) chấp nhận truyền trực tiếp cacheRetention khi đượ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

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.com trự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ường service_tier.
  • Các tham số serviceTier hoặc service_tier được đặt rõ ràng sẽ ghi đè /fast khi 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à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 đ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.
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 params.context1m:
Các cấu hình cũ có thể giữ lại 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 đó.
Yêu cầu thông tin xác thực Anthropic của bạn có quyền truy cập ngữ cảnh dài. Xác thực bằng OAuth/token đăng ký vẫn giữ các tiêu đề beta Anthropic bắt buộc, nhưng OpenClaw loại bỏ tiêu đề beta 1M đã ngừng sử dụng nếu tiêu đề này vẫn còn trong cấu hình cũ.
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ố

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.
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.
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ơ đó.
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ờ.

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.