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 giới hạn token, mà chỉ trả về ID mô hình, tên, phương thức và trạng thái vòng đời. OpenClaw cung cấp sẵn bảng tra cứu các cửa sổ ngữ cảnh và giới hạn đầu ra đã biết cho những 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, các ngưỡng Compaction và phát hiện tràn ngữ cảnh hoạt động chính xác cho những mô hình này.

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

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ô 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 chèn tự động. Điều này có nghĩa là các hồ sơ Claude liên khu vực hoạt động mà không cần ghi đè 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ê đầu tiên trong openclaw models list vì nhìn chung chúng cung cấp dung lượng tốt hơn và khả năng tự động chuyển đổi dự phòng.

ID hồ sơ suy luận có dạng us.anthropic.claude-opus-4-6-v1 (theo khu vực) hoặc anthropic.claude-opus-4-6-v1 (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 đầy đủ 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ó 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 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", // áp dụng cho tất cả mô hình      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // ghi đè theo từng mô hình          },        },      },    },  },}

Các giá trị hợp lệ là default, flex, priority và reserved. Claude Fable 5 và Sonnet 5 chỉ hỗ trợ cấp 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 đó. Đối với các mô hình khác, không phải mô hình nào cũng hỗ trợ mọi cấp -- cấp không được hỗ trợ sẽ trả về lỗi xác thực 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 cấp là nguyên nhân). Nếu gặp lỗi này, hãy kiểm tra xem mô hình có hỗ trợ cấp đượ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ỏ 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 tên, hồ sơ suy luận ứng dụng có mô hình cơ sở được phân giải thành Opus 4.7/4.8 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 trong 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 1M, giới hạn đầu ra 128K, chế độ tư duy 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 ánh xạ tới low; nhiệt độ và các điều khiển 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 một phần.

AWS yêu cầu chủ động chọn tham gia lưu giữ dữ liệu provider_data_share một cách rõ ràng 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 đảm bảo độ tin cậy và an toàn. Hãy xem xét và cấu hình việc lưu giữ dữ liệu của Bedrock trước khi bật mô hình.

Claude Mythos 5 chỉ khả dụng qua Bedrock đối với các tài khoản có phê duyệt quyền truy cập hạn chế bắt buộc. 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. Tư duy thích ứng luôn được bật: /think off và /think minimal ánh xạ tới low, trong khi 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ì bật tư duy thích ứng cho Sonnet 5. OpenClaw mặc định dùng high; /think off và /think minimal ánh xạ tới low vì tuyến này không thể tắt tư duy. Các giá trị nhiệt độ tùy chỉnh và buộc chọn công cụ bị bỏ qua khi tư duy thích ứng đang hoạt động.

Bạn có thể áp dụng Amazon Bedrock Guardrails 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. Rào chắn cho phép bạn thực thi việc lọc nội dung, từ chối chủ đề, lọc từ, lọc thông tin nhạy cảm và kiểm tra căn cứ theo ngữ cảnh.

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          guardrail: {            guardrailIdentifier: "abc123", // mã rào chắn hoặc ARN đầy đủ            guardrailVersion: "1", // số phiên bản hoặc "DRAFT"            streamProcessingMode: "sync", // tùy chọn: "sync" hoặc "async"            trace: "enabled", // tùy chọn: "enabled", "disabled" hoặc "enabled_full"          },        },      },    },  },}

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

Bedrock cũng có thể đóng vai trò nhà cung cấp embedding cho tìm kiếm bộ nhớ. Phần này được cấu hình riêng 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", // mặc định      },    },  },}

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ợ 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 kích thước.

• Bedrock yêu cầu bật quyền truy cập mô hình 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 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 muốn 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, sau đó AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, tiếp theo AWS_PROFILE, rồi đến chuỗi AWS SDK mặc định.
• Khả năng hỗ trợ suy luận tùy 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 luồng 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.