Amazon Bedrock

Các tùy chọn cấu hình nằm trong plugins.entries.amazon-bedrock.config.discovery:

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          discovery: {            enabled: true,            region: "us-east-1",            providerFilter: ["anthropic", "amazon"],            refreshInterval: 3600,            defaultContextWindow: 32000,            defaultMaxTokens: 4096,          },        },      },    },  },}

Các API ListFoundationModels và GetFoundationModel của Bedrock không trả về siêu dữ liệu về giới hạn token mà chỉ trả về ID mô hình, tên, phương thức dữ liệu và trạng thái vòng đời. OpenClaw cung cấp sẵn một bảng tra cứu các cửa sổ ngữ cảnh và giới hạn đầu ra đã biết cho các mô hình Bedrock phổ biến (Claude, Nova, Llama, Mistral, DeepSeek và các mô hình khác), nhờ đó việc quản lý phiên, ngưỡng Compaction và phát hiện tràn ngữ cảnh hoạt động chính xác cho các mô hình đó.

Các mô hình được khám phá nhưng không có trong bảng sẽ dùng giá trị dự phòng defaultContextWindow và defaultMaxTokens. Nếu một mô hình bạn sử dụng không có giới hạn chính xác, hãy ghi đè bằng một mục models.providers["amazon-bedrock"].models tường minh.

OpenClaw khám phá các hồ sơ suy luận theo khu vực và toàn cầu cùng với các mô hình nền tảng. Khi một hồ sơ ánh xạ đến một mô hình nền tảng đã biết, hồ sơ sẽ kế thừa các khả năng của mô hình đó (cửa sổ ngữ cảnh, số token tối đa, suy luận, thị giác), đồng thời khu vực yêu cầu Bedrock chính xác được tự động chèn vào. Điều này cho phép các hồ sơ Claude liên khu vực hoạt động mà không cần ghi đè trình cung cấp theo cách thủ công. Các hồ sơ liên khu vực toàn cầu (global.*) được liệt kê trước trong openclaw models list vì nhìn chung chúng cung cấp dung lượng tốt hơn và khả năng chuyển đổi dự phòng tự động.

ID hồ sơ suy luận có dạng us.anthropic.claude-opus-4-6-v1:0 (theo khu vực) hoặc anthropic.claude-opus-4-6-v1:0 (toàn cầu). Nếu mô hình nền đã có trong kết quả khám phá, hồ sơ sẽ kế thừa toàn bộ tập hợp khả năng của mô hình đó; nếu không, các giá trị mặc định an toàn sẽ được áp dụng.

Không cần cấu hình bổ sung. Miễn là tính năng khám phá được bật và chủ thể IAM có quyền bedrock:ListInferenceProfiles, các hồ sơ sẽ xuất hiện cùng với các mô hình nền tảng trong openclaw models list.

Một số mô hình Bedrock hỗ trợ tham số service_tier để tối ưu hóa chi phí hoặc độ trễ. Có các cấp dịch vụ sau:

Đặt serviceTier (hoặc service_tier) thông qua agents.defaults.params cho các yêu cầu mô hình Bedrock hoặc theo từng mô hình trong agents.defaults.models["<model-key>"].params:

{  agents: {    defaults: {      params: {        serviceTier: "flex", // applies to all models      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // per-model override          },        },      },    },  },}

Các giá trị hợp lệ là default, flex, priority và reserved. Claude Fable 5 và Sonnet 5 chỉ hỗ trợ tầng default; OpenClaw sẽ cảnh báo và bỏ qua flex, priority hoặc reserved được yêu cầu cho các mô hình đó. Với các mô hình khác, không phải mô hình nào cũng hỗ trợ mọi tầng -- tầng không được hỗ trợ sẽ trả về lỗi xác thực của Bedrock và thông báo lỗi có thể gây hiểu nhầm (ví dụ: "Mã định danh mô hình được cung cấp không hợp lệ" thay vì nêu rõ tầng là nguyên nhân). Nếu bạn gặp lỗi này, hãy kiểm tra xem mô hình có hỗ trợ tầng được yêu cầu hay không.

Bedrock từ chối tham số temperature đối với Claude Opus 4.7 và Opus 4.8. OpenClaw tự động bỏ qua temperature cho mọi tham chiếu Bedrock phù hợp, bao gồm mã mô hình nền tảng, hồ sơ suy luận có tên, hồ sơ suy luận ứng dụng có mô hình nền tảng được phân giải thành Opus 4.7/4.8 thông qua bedrock:GetInferenceProfile, và các biến thể opus-4.7/opus-4.8 có dấu chấm với tiền tố khu vực tùy chọn (us., eu., ap., apac., au., jp., global.). Không cần tùy chọn cấu hình nào và việc bỏ qua này áp dụng cho cả đối tượng tùy chọn yêu cầu lẫn trường tải trọng inferenceConfig.

Sử dụng amazon-bedrock/anthropic.claude-fable-5 tại us-east-1, hoặc các mã suy luận khu vực như us.anthropic.claude-fable-5. OpenClaw áp dụng cửa sổ ngữ cảnh 1 triệu token, giới hạn đầu ra 128 nghìn token, chế độ suy nghĩ thích ứng luôn bật và ánh xạ mức độ nỗ lực được hỗ trợ của Fable. /think off và /think minimal được ánh xạ thành low; các điều khiển nhiệt độ và buộc chọn công cụ bị bỏ qua, tương tự tuyến Opus 4.7/4.8. Đầu ra truyền phát được giữ lại cho đến khi Bedrock trả về trạng thái kết thúc để các lần từ chối giữa luồng không làm lộ văn bản chưa hoàn chỉnh.

AWS yêu cầu bạn chủ động đồng ý lưu giữ dữ liệu bằng provider_data_share trước khi Fable khả dụng. Lời nhắc và nội dung hoàn thành được chia sẻ với Anthropic và lưu giữ tối đa 30 ngày nhằm phục vụ mục đích tin cậy và an toàn. Hãy xem xét và cấu hình chính sách lưu giữ dữ liệu của Bedrock trước khi bật mô hình.

Claude Mythos 5 chỉ khả dụng thông qua Bedrock đối với các tài khoản đã được phê duyệt quyền truy cập hạn chế theo yêu cầu. OpenClaw nhận diện mô hình nền tảng anthropic.claude-mythos-5 và các hồ sơ suy luận khu vực hoặc toàn cầu như us.anthropic.claude-mythos-5.

OpenClaw áp dụng 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, bộ nhớ đệm lời nhắc, truyền phát an toàn khi từ chối và các mức độ nỗ lực gốc. Chế độ suy nghĩ thích ứng luôn được bật: /think off và /think minimal được ánh xạ thành low, còn xhigh và max vẫn khả dụng. Các giá trị lấy mẫu tùy chỉnh và buộc chọn công cụ bị bỏ qua.

AWS cung cấp tài liệu về Sonnet 5 cho cả hai điểm cuối bedrock-runtime và bedrock-mantle. OpenClaw nhận diện mô hình nền tảng Bedrock anthropic.claude-sonnet-5 và các hồ sơ suy luận khu vực hoặc toàn cầu như us.anthropic.claude-sonnet-5. OpenClaw áp dụng 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, các mức độ nỗ lực gốc, bộ nhớ đệm lời nhắc và truyền phát an toàn khi từ chối.

Bedrock duy trì chế độ suy nghĩ thích ứng cho Sonnet 5. OpenClaw mặc định sử dụng high; /think off và /think minimal được ánh xạ thành low vì tuyến này không thể tắt chế độ suy nghĩ. Các giá trị nhiệt độ tùy chỉnh và buộc chọn công cụ bị bỏ qua khi chế độ suy nghĩ thích ứng đang hoạt động.

Bạn có thể áp dụng các biện pháp bảo vệ Amazon Bedrock cho mọi lần gọi mô hình Bedrock bằng cách thêm đối tượng guardrail vào cấu hình plugin amazon-bedrock. Các biện pháp bảo vệ cho phép bạn thực thi việc lọc nội dung, từ chối chủ đề, lọc từ ngữ, lọc thông tin nhạy cảm và kiểm tra tính xác thực theo ngữ cảnh.

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          guardrail: {            guardrailIdentifier: "abc123", // guardrail ID or full ARN            guardrailVersion: "1", // version number or "DRAFT"            streamProcessingMode: "sync", // optional: "sync" or "async"            trace: "enabled", // optional: "enabled", "disabled", or "enabled_full"          },        },      },    },  },}

guardrailIdentifier và guardrailVersion là bắt buộc.

Bedrock cũng có thể đóng vai trò là nhà cung cấp embedding cho tìm kiếm bộ nhớ. Cấu hình này tách biệt với nhà cung cấp suy luận -- đặt agents.defaults.memorySearch.provider thành "bedrock":

{  agents: {    defaults: {      memorySearch: {        provider: "bedrock",        model: "amazon.titan-embed-text-v2:0", // default      },    },  },}

Embedding Bedrock sử dụng cùng chuỗi thông tin xác thực AWS SDK như suy luận (vai trò phiên bản, SSO, khóa truy cập, cấu hình dùng chung và danh tính web). Không cần khóa API.

Các mô hình embedding được hỗ trợ bao gồm Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4) và TwelveLabs Marengo. Xem Tham chiếu cấu hình bộ nhớ -- Bedrock để biết danh sách đầy đủ các mô hình và tùy chọn số chiều.

• Bedrock yêu cầu quyền truy cập mô hình được bật trong tài khoản/khu vực AWS của bạn.
• Tính năng tự động khám phá cần các quyền bedrock:ListFoundationModels và bedrock:ListInferenceProfiles.
• Nếu bạn dựa vào chế độ tự động, hãy đặt một trong các dấu hiệu biến môi trường xác thực AWS được hỗ trợ trên máy chủ Gateway. Nếu bạn muốn sử dụng xác thực IMDS/cấu hình dùng chung mà không có dấu hiệu biến môi trường, hãy đặt plugins.entries.amazon-bedrock.config.discovery.enabled: true.
• OpenClaw hiển thị nguồn thông tin xác thực theo thứ tự sau: AWS_BEARER_TOKEN_BEDROCK, tiếp theo là AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, rồi AWS_PROFILE, sau đó là chuỗi AWS SDK mặc định.
• Khả năng hỗ trợ suy luận phụ thuộc vào mô hình; hãy kiểm tra thẻ mô hình Bedrock để biết các khả năng hiện tại.
• Nếu muốn dùng quy trình khóa được quản lý, bạn cũng có thể đặt một proxy tương thích với OpenAI phía trước Bedrock và cấu hình proxy đó làm nhà cung cấp OpenAI.