Skip to main content

Amazon Bedrock

OpenClaw 可以透過 pi-ai 的 Bedrock Converse 串流提供者使用 Amazon Bedrock 模型。Bedrock 認證使用 AWS SDK 預設認證鏈, 不是 API 鑰。

pi-ai 支援的內容

  • 提供者:amazon-bedrock
  • API:bedrock-converse-stream
  • 認證:AWS 認證(環境變數、共用設定或實例角色)
  • 區域:AWS_REGIONAWS_DEFAULT_REGION(預設:us-east-1

自動模型探索

如果偵測到 AWS 認證,OpenClaw 可以自動探索支援串流文字輸出的 Bedrock 模型。探索使用 bedrock:ListFoundationModels 並被快取(預設:1 小時)。 設定選項在 models.bedrockDiscovery 底下:
註記:
  • enabled 在 AWS 認證存在時預設為 true
  • region 預設為 AWS_REGIONAWS_DEFAULT_REGION,然後 us-east-1
  • providerFilter 符合 Bedrock 提供者名稱(例如 anthropic)。
  • refreshInterval 是秒數;設定為 0 停用快取。
  • defaultContextWindow(預設:32000)和 defaultMaxTokens(預設:4096) 用於探索到的模型(如果知道模型限制,則覆蓋)。

上線

  1. 確保 AWS 認證在 gateway 主機上可用:
  1. 新增 Bedrock 提供者和模型到設定(不需要 apiKey):

EC2 實例角色

在執行 OpenClaw 的 EC2 實例上附加了 IAM 角色時,AWS SDK 將自動使用實例中繼資料服務(IMDS)進行認證。 然而,OpenClaw 的認證偵測目前只檢查環境 變數,不檢查 IMDS 認證。 因應措施:設定 AWS_PROFILE=default 以訊號 AWS 認證可用。 實際認證仍透過 IMDS 使用實例角色。
EC2 實例角色的必需 IAM 權限
  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListFoundationModels(用於自動探索)
或附加受管制原則 AmazonBedrockFullAccess

快速設定(AWS 路徑)

註記

  • Bedrock 需要在 AWS 帳戶 / 區域中啟用模型存取
  • 自動探索需要 bedrock:ListFoundationModels 權限。
  • 如果使用設定檔,在 gateway 主機上設定 AWS_PROFILE
  • OpenClaw 按此順序顯示認證來源:AWS_BEARER_TOKEN_BEDROCK, 然後 AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY,然後 AWS_PROFILE,然後 預設 AWS SDK 鏈。
  • 推理支援取決於模型;檢查 Bedrock 模型卡以獲取 目前的能力。
  • 如果偏好受管制的鑰流程,也可以在 Bedrock 前面放置 OpenAI 相容 的代理,並將其設定為 OpenAI 提供者。