Providers
Anthropic
Anthropic xây dựng họ mô hình Claude. OpenClaw hỗ trợ hai tuyến xác thực:
- API key — truy cập trực tiếp API Anthropic với tính phí theo mức sử dụng (các mô hình
anthropic/*) - Claude CLI — tái sử dụng phiên đăng nhập Claude CLI hiện có trên cùng máy chủ
Bắt đầu
API key
Phù hợp nhất cho: truy cập API tiêu chuẩn và tính phí theo mức sử dụng.
Get your API key
Tạo API key trong Anthropic Console.
Run onboarding
openclaw onboard# choose: Anthropic API keyHoặc truyền khóa trực tiếp:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"Verify the model is available
openclaw models list --provider anthropicVí dụ cấu hình
{ env: { ANTHROPIC_API_KEY: "sk-ant-..." }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },}Claude CLI
Phù hợp nhất cho: tái sử dụng phiên đăng nhập Claude CLI hiện có mà không cần API key riêng.
Ensure Claude CLI is installed and logged in
Xác minh bằng:
claude --versionRun onboarding
openclaw onboard# choose: Claude CLIOpenClaw phát hiện và tái sử dụng thông tin đăng nhập Claude CLI hiện có.
Verify the model is available
openclaw models list --provider anthropicVí dụ cấu hình
Ưu tiên tham chiếu mô hình Anthropic chuẩn cùng với ghi đè runtime CLI:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-7" }, models: { "anthropic/claude-opus-4-7": { agentRuntime: { id: "claude-cli" }, }, }, }, },}Các tham chiếu mô hình cũ claude-cli/claude-opus-4-7 vẫn hoạt động để
tương thích, nhưng cấu hình mới nên giữ phần chọn nhà cung cấp/mô hình là
anthropic/* và đặt backend thực thi trong chính sách runtime của nhà cung cấp/mô hình.
Mặc định suy luận (Claude 4.6)
Các mô hình Claude 4.6 mặc định dùng suy luận adaptive trong OpenClaw khi chưa đặt mức suy luận rõ ràng.
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-6": { params: { thinking: "adaptive" }, }, }, }, },}Lưu bộ nhớ đệm prompt
OpenClaw hỗ trợ tính năng lưu bộ nhớ đệm prompt của Anthropic cho xác thực bằng API key.
| 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 bằng API key |
"long" |
1 giờ | Bộ nhớ đệm mở rộng |
"none" |
Không lưu bộ nhớ đệm | Tắt lưu bộ nhớ đệm prompt |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}Per-agent cache overrides
Dùng tham số cấp mô hình làm đường cơ sở, rồi ghi đè các tác nhân 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:
agents.defaults.models["provider/model"].paramsagents.list[].params(khớpid, ghi đè theo khóa)
Điều này cho phép một tác nhân giữ bộ nhớ đệm dài hạn trong khi một tác nhân khác trên cùng mô hình tắt lưu bộ nhớ đệm cho lưu lượng đột biến/tái sử dụng thấp.
Bedrock Claude notes
- 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 dùng
cacheRetention: "none"trong runtime. - Mặc định thông minh cho API key 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
Fast mode
Công tắc /fast dùng chung của OpenClaw hỗ trợ lưu lượng Anthropic trực tiếp (API key và OAuth tới api.anthropic.com).
| Lệnh | Ánh xạ tới |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{ agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, },}Media understanding (image and 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 năng lực media từ xác thực Anthropic đã cấu hình — không cần cấu hình bổ sung.
| Thuộc tính | Giá trị |
|---|---|
| Mô hình mặc định | claude-opus-4-7 |
| Đầu vào được hỗ trợ | Hình ảnh, tài liệu PDF |
Khi hình ảnh hoặc PDF được đính kèm vào một cuộc trò chuyện, OpenClaw tự động định tuyến nó qua nhà cung cấp hiểu media của Anthropic.
1M context window (beta)
Cửa sổ ngữ cảnh 1M của Anthropic được kiểm soát bằng beta. Bật theo từng mô hình:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { context1m: true }, }, }, }, },}OpenClaw ánh xạ điều này thành anthropic-beta: context-1m-2025-08-07 trên các yêu cầu.
params.context1m: true cũng áp dụng cho backend Claude CLI
(claude-cli/*) với các mô hình Opus và Sonnet đủ điều kiện, mở rộng cửa sổ
ngữ cảnh runtime cho các phiên CLI đó để khớp hành vi API trực tiếp.
Claude Opus 4.7 1M context
anthropic/claude-opus-4.7 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ố
401 errors / token suddenly invalid
Xác thực token Anthropic sẽ hết hạn và có thể bị thu hồi. Với các thiết lập mới, hãy dùng API key của Anthropic thay thế.
No API key found for provider "anthropic"
Xác thực Anthropic là theo từng tác nhân — 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 onboarding cho tác nhân đó (hoặc cấu hình API key trên máy chủ gateway), rồi xác minh bằng openclaw models status.
No credentials found for profile "anthropic:default"
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 cấu hình API key cho đường dẫn hồ sơ đó.
No available auth profile (all in cooldown)
Kiểm tra openclaw models status --json để xem auth.unusableProfiles. Các thời gian chờ do giới hạn tốc độ của Anthropic có thể được phạm vi hóa theo mô hình, nên một mô hình Anthropic cùng cấp vẫn có thể dùng được. Thêm hồ sơ Anthropic khác hoặc chờ hết thời gian chờ.