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,          },        },      },    },  },}

OpenClaw khám phá hồ sơ suy luận 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, token tối đa, suy luận, thị giác) và vùng 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 vùng hoạt động mà không cần ghi đè nhà cung cấp thủ công.

ID hồ sơ suy luận có dạng us.anthropic.claude-opus-4-6-v1:0 (khu vực) hoặc anthropic.claude-opus-4-6-v1:0 (toàn cầu). Nếu mô hình nền bên dưới đã có trong kết quả khám phá, hồ sơ sẽ kế thừa toàn bộ tậ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à 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ấp sau có sẵn:

Đặt serviceTier (hoặc service_tier) 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. Không phải mô hình nào cũng hỗ trợ mọi cấp — nếu yêu cầu một cấp không được hỗ trợ, Bedrock sẽ trả về lỗi xác thực. Lưu ý: thông báo lỗi có phần gây hiểu nhầm; nó có thể nói "The provided model identifier is invalid" thay vì chỉ ra một cấp dịch vụ không được hỗ trợ. Nếu bạn thấy 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 cho Claude Opus 4.7. OpenClaw tự động bỏ qua temperature cho bất kỳ tham chiếu Bedrock Opus 4.7 nào, bao gồm ID 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 bên dưới phân giải thành Opus 4.7 qua bedrock:GetInferenceProfile, và các biến thể opus-4.7 dạng dấu chấm có tiền tố vùng tùy chọn (us., eu., ap., apac., au., jp., global.). Không cần nút cấu hình nào, và việc bỏ qua á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.

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. Guardrails cho phép bạn thực thi lọc nội dung, từ chối chủ đề, bộ lọc từ, bộ lọc thông tin nhạy cảm và kiểm tra nền tảng 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"          },        },      },    },  },}

Bedrock cũng có thể đóng vai trò là 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", // default      },    },  },}

Embedding của Bedrock 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. Khi provider là "auto", Bedrock được tự động phát hiện nếu chuỗi thông tin xác thực đó phân giải thành công.

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 mô hình đầy đủ và các tùy chọn số chiều.

• 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ự độ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 env xác thực AWS được hỗ trợ trên máy chủ Gateway. Nếu bạn muốn dùng xác thực IMDS/cấu hình dùng chung mà không có dấu hiệu env, 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ự này: AWS_BEARER_TOKEN_BEDROCK, sau đó AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, rồi AWS_PROFILE, rồi chuỗi AWS SDK mặc định.
• 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 năng lực hiện tại.
• Nếu bạn muốn luồng khóa được quản lý, bạn cũng có thể đặt một proxy tương thích OpenAI phía trước Bedrock và cấu hình nó như một nhà cung cấp OpenAI.