Amazon Bedrock

Các tùy chọn cấu hình nằm dưới 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 theo vùng 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ạ tới một mô hình nền tảng đã biết, hồ 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) 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 trông như us.anthropic.claude-opus-4-6-v1:0 (theo vùng) 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 đầy đủ tập khả năng của mô hình đó; nếu không thì áp dụng các giá trị mặc định an toàn.

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

Bedrock từ chối tham số temperature cho Claude Opus 4.7. OpenClaw tự động bỏ qua temperature cho mọi tham chiếu Bedrock Opus 4.7, bao gồm ID 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 bên dưới được phân giải thành Opus 4.7 thông qua bedrock:GetInferenceProfile, và các biến thể dạng chấm opus-4.7 với tiền tố vùng tùy chọn (us., eu., ap., apac., au., jp., global.). Không cần núm cấu hình, và việc bỏ qua áp dụng cho cả đối tượng tùy chọn yêu cầu và trường payload inferenceConfig.

Bạn có thể áp dụng Amazon Bedrock Guardrails cho tất cả các lần gọi mô hình Bedrock bằng cách thêm một đố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à các kiểm tra neo 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ò 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 của Bedrock dùng cùng chuỗi thông tin xác thực AWS SDK như suy luận (vai trò instance, SSO, khóa truy cập, cấu hình dùng chung và định danh 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 đó đượ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 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.
• Khám phá tự động 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 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, rồi 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 các khả năng 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.