跳转到主要内容

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 实例角色

当在附加了 IAM 角色的 EC2 实例上运行 OpenClaw 时,AWS SDK 会自动使用实例元数据服务(IMDS)进行认证。但是,OpenClaw 的凭证检测目前只检查环境变量,不检查 IMDS 凭证。 解决方法: 设置 AWS_PROFILE=default 以表明 AWS 凭证可用。实际认证仍然通过 IMDS 使用实例角色。
EC2 实例角色所需的 IAM 权限
  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListFoundationModels(用于自动发现)
或者附加托管策略 AmazonBedrockFullAccess 快速设置:

注意事项

  • 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 提供商。