Amazon Bedrock 模型接入指南

2025-07-10 · 5 分钟模型接入

概述

Amazon Bedrock 是 AWS 提供的托管式大模型服务平台，汇聚了 Anthropic Claude、Meta Llama、Mistral 等主流模型。与其他提供商不同，Bedrock 不使用 API Key 认证，而是依托 AWS SDK 的标准凭证链，天然适合已有 AWS 基础设施的企业团队。在 OpenClaw 中，Bedrock 对应的提供者 ID 为 amazon-bedrock，底层使用 bedrock-converse-stream API 协议。

快速开始

第一步：配置 AWS 凭证

最简单的方式是设置环境变量：

export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
export AWS_REGION="us-east-1"

若使用临时凭证（如 STS AssumeRole），还需设置：

export AWS_SESSION_TOKEN="your-session-token"

第二步：执行初始化

openclaw onboard --provider amazon-bedrock

OpenClaw 检测到 AWS 凭证后会自动启用 Bedrock 模型发现功能。

配置参数

{
  models: {
    bedrockDiscovery: {
      enabled: true,
      region: "us-east-1",           // 使用的 AWS 区域
      providerFilter: ["anthropic"],  // 按提供商过滤，留空则加载全部
      refreshInterval: 3600,          // 模型列表缓存刷新间隔（秒），0 表示不缓存
      defaultContextWindow: 32000,
      defaultMaxTokens: 4096
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0"
      }
    }
  }
}

支持的模型

Bedrock 上可用的模型取决于你的 AWS 账户已申请的模型访问权限。常用模型 ID 示例：

us.anthropic.claude-opus-4-6-v1:0（20 万 token 上下文，支持图像输入）
us.anthropic.claude-3-5-sonnet-20241022-v2:0
us.meta.llama3-3-70b-instruct-v1:0
us.mistral.mistral-large-2402-v1:0

在 OpenClaw 中引用时使用 amazon-bedrock/<模型ID> 格式。

IAM 权限配置

运行 OpenClaw 的 IAM 用户或角色至少需要以下权限：

{
  "Effect": "Allow",
  "Action": [
    "bedrock:InvokeModel",
    "bedrock:InvokeModelWithResponseStream",
    "bedrock:ListFoundationModels"
  ],
  "Resource": "*"
}

也可以直接附加 AWS 托管策略 AmazonBedrockFullAccess 快速完成授权。

注意事项

EC2 实例角色：若在 EC2 上部署，无需手动配置 Key，SDK 会自动通过实例元数据服务（IMDS）获取凭证。建议设置 AWS_PROFILE=default 告知 OpenClaw 凭证可用。

区域与模型可用性：并非所有模型在所有区域均可用。us-east-1 和 us-west-2 的模型覆盖最全面，建议优先选择。

模型访问申请：首次使用某个模型前，需要在 AWS 控制台的 Bedrock 页面手动申请该模型的访问权限，否则调用会返回 AccessDeniedException。

多区域部署：可以配置多个 Bedrock 提供者实例分别指向不同区域，通过不同 Agent 调度，实现跨区域负载均衡。