Providers
Anthropic
Anthropic xây dựng họ mô hình Claude. OpenClaw hỗ trợ hai cách xác thực:
- Khóa API — truy cập trực tiếp API Anthropic với tính phí theo mức sử dụng (mô hình
anthropic/*) - Claude CLI — dùng lại phiên đăng nhập Claude CLI hiện có trên cùng máy chủ
Bắt đầu
Khóa API
Phù hợp nhất cho: truy cập API tiêu chuẩn và tính phí theo mức sử dụng.
Lấy khóa API của bạn
Tạo khóa API trong Anthropic Console.
Chạy quy trình thiết lập ban đầu
openclaw onboard
# choose: Anthropic API key
Hoặc truyền khóa trực tiếp:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
Xác minh mô hình có sẵn
openclaw models list --provider anthropic
Ví 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: dùng lại phiên đăng nhập Claude CLI hiện có mà không cần khóa API riêng.
Đảm bảo Claude CLI đã được cài đặt và đăng nhập
Xác minh bằng:
claude --version
Chạy quy trình thiết lập ban đầu
openclaw onboard
# choose: Claude CLI
OpenClaw phát hiện và dùng lại thông tin xác thực Claude CLI hiện có.
Xác minh mô hình có sẵn
openclaw models list --provider anthropic
Ví dụ cấu hình
Ưu tiên tham chiếu mô hình Anthropic chuẩn cùng một ghi đè runtime CLI:
{
agents: {
defaults: {
model: { primary: "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 agentRuntime.id.
Mặc định suy nghĩ (Claude 4.6)
Các mô hình Claude 4.6 mặc định dùng suy nghĩ adaptive trong OpenClaw khi không đặt mức suy nghĩ 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 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 bằng khóa API |
"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" },
},
},
},
},
}
Ghi đè bộ nhớ đệm theo từng agent
Dùng tham số cấp mô hình làm đường cơ sở, sau đó ghi đè các agent 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 agent giữ bộ nhớ đệm dài hạn trong khi một agent khác trên cùng mô hình tắt bộ nhớ đệm cho lưu lượng tăng đột biến hoặc ít tái sử dụng.
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ị ép thành
cacheRetention: "none"trong runtime. - Các mặc định thông minh cho khóa API cũng đặt trước
cacheRetention: "short"cho tham chiếu Claude-on-Bedrock khi không đặt giá trị rõ ràng.
Cấu hình nâng cao
Chế độ nhanh
Công tắc /fast dùng chung của OpenClaw hỗ trợ lưu lượng Anthropic trực tiếp (khóa API và OAuth đến 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 },
},
},
},
},
}
Hiểu nội dung media (hình ảnh và PDF)
Plugin Anthropic được đóng gói đă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 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 media Anthropic.
Cửa sổ ngữ cảnh 1M (beta)
Cửa sổ ngữ cảnh 1M của Anthropic đang đượ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ạ giá trị 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/*) đối 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 với hành vi API trực tiếp.
Ngữ cảnh 1M của Claude Opus 4.7
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ố
Lỗi 401 / token đột ngột 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. Với các 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"
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 thiết lập ban đầu 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"
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 hồi
Kiểm tra openclaw models status --json để xem auth.unusableProfiles. Thời gian hồi do giới hạn tốc độ của Anthropic có thể theo từng mô hình, nên một mô hình Anthropic cùng nhóm có thể vẫn dùng được. Thêm hồ sơ Anthropic khác hoặc chờ hết thời gian hồi.