Anthropic

Anthropic xây dựng dòng mô hình Claude. OpenClaw hỗ trợ hai tuyến xác thực:

• 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

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

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:

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

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

1. 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 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 Anthropic cho phép với Fable 5.
2. 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.
3. 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).
4. 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.

Dự phòng diễn ra ở cấp Anthropic API, vì vậ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_fallback trên tin nhắn trợ lý, nêu fromModel và toModel, và responseModel của tin nhắn báo cáo claude-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 cho anthropic/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.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}

{  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" } },    ],  },}

Cấu hình nâng cao

{  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

Khắc phục sự cố

Liên quan