9.5 Amazon Bedrock

AWS Bedrock 配置指南

概述

OpenClaw 通过 AWS SDK 默认凭证链与 Amazon Bedrock 集成。Bedrock 使用 amazon-bedrock 提供商和 bedrock-converse-stream API,支持自动模型发现功能。

认证方式

Amazon Bedrock 使用 AWS SDK 默认凭证链,不使用 API 密钥。支持以下认证方法:

1. 环境变量

export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"

2. 共享配置文件

使用 ~/.aws/credentials 和 ~/.aws/config 文件配置 AWS 凭证。

export AWS_PROFILE=default

3. EC2 实例角色

在 EC2 实例上运行时,可以使用实例角色自动获取凭证(需要设置 AWS_PROFILE=default 作为变通方案)。

区域设置

默认区域为 us-east-1,可以通过 AWS_REGION 环境变量修改:

export AWS_REGION="us-west-2"

自动模型发现

当检测到 AWS 凭证时,自动模型发现功能默认启用。该功能使用 bedrock:ListFoundationModels API 获取可用模型列表,并缓存 3600 秒。

配置示例

{
  "models": {
    "bedrockDiscovery": {
      "enabled": true,
      "defaultContextWindow": 32000,
      "defaultMaxTokens": 4096,
      "providers": ["anthropic"]
    }
  }
}

配置选项说明

• enabled - 是否启用自动发现(默认: true)
• defaultContextWindow - 默认上下文窗口大小(默认: 32000)
• defaultMaxTokens - 默认最大令牌数(默认: 4096)
• providers - 要过滤的提供商列表(例如: ["anthropic"])

手动配置

如果不使用自动发现,可以手动配置模型:

{
  "models": {
    "providers": {
      "amazon-bedrock": {
        "models": [
          {
            "id": "anthropic.claude-opus-4-5-20251101-v1:0",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

IAM 权限要求

您的 AWS IAM 用户或角色需要以下权限:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListFoundationModels"
      ],
      "Resource": "*"
    }
  ]
}

启用模型访问

在使用 Bedrock 之前,需要在 AWS 账户和区域中启用模型访问权限。请在 AWS Bedrock 控制台中启用所需模型的访问权限。

常用命令

# 验证模型发现功能
openclaw models list

# 列出 Bedrock 模型
openclaw models list --provider amazon-bedrock

# 设置默认模型
openclaw models set amazon-bedrock/anthropic.claude-opus-4-5-20251101-v1:0

模型引用格式

Bedrock 模型使用以下格式引用:

amazon-bedrock/anthropic.claude-opus-4-5-20251101-v1:0