OpenClaw接入Amazon Bedrock教程

Amazon Bedrock简介

Amazon Bedrock是AWS推出的全托管AI服务平台，提供来自Anthropic、Meta、Mistral等多家厂商的基础模型。通过Bedrock，你可以在AWS基础设施内安全地调用各种大模型，同时享受AWS的安全合规体系、VPC网络隔离以及IAM权限管理。

OpenClaw将Amazon Bedrock作为一级提供商支持，你可以通过标准的provider/model-name格式访问Bedrock上的所有可用模型。对于已经深度使用AWS服务的团队来说，Bedrock是一个自然且高效的选择。

前置准备

在开始配置之前，你需要完成以下准备工作：

AWS账户：确保你拥有一个有效的AWS账户。
开通Bedrock服务：在AWS控制台中导航到Amazon Bedrock，申请开通你需要的模型访问权限。部分模型（如Claude系列）需要单独申请授权。
创建IAM凭证：创建一个具有bedrock:InvokeModel权限的IAM用户或角色，获取Access Key ID和Secret Access Key。

建议使用IAM策略精确控制可访问的模型范围，遵循最小权限原则。

使用OpenClaw Onboard配置

最简单的配置方式是使用OpenClaw内置的引导工具：

openclaw onboard

选择Amazon Bedrock作为提供商，按照提示输入AWS凭证信息和区域设置。引导工具会自动生成配置文件。

手动配置openclaw.json

手动编辑openclaw.json来配置Bedrock：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0"
      }
    }
  }
}

Bedrock的模型命名遵循AWS自己的模型ID格式，在OpenClaw中需要加上bedrock/前缀。

配置AWS认证

Bedrock的认证方式与其他提供商略有不同，需要提供AWS凭证信息：

{
  "providers": {
    "bedrock": {
      "region": "us-east-1",
      "auth": [
        {
          "accessKeyId": "你的AWS_ACCESS_KEY_ID",
          "secretAccessKey": "你的AWS_SECRET_ACCESS_KEY"
        }
      ]
    }
  }
}

你也可以配置多组AWS凭证实现多账户轮换：

{
  "providers": {
    "bedrock": {
      "region": "us-east-1",
      "auth": [
        {
          "accessKeyId": "账户A的KEY",
          "secretAccessKey": "账户A的SECRET",
          "profile": "主账户"
        },
        {
          "accessKeyId": "账户B的KEY",
          "secretAccessKey": "账户B的SECRET",
          "profile": "备用账户"
        }
      ]
    }
  }
}

当主账户遭遇限流或认证失败时，OpenClaw会自动切换到备用账户，并对主账户启动冷却追踪，一段时间后再重新尝试。

Bedrock上的常用模型

以下是通过Bedrock访问的一些热门模型：

bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0：Claude 3.5 Sonnet，性价比极高的全能模型。
bedrock/anthropic.claude-3-opus-20240229-v1:0：Claude 3 Opus，复杂推理任务的首选。
bedrock/meta.llama3-1-70b-instruct-v1:0：Meta Llama 3.1 70B，强大的开源模型。
bedrock/mistral.mistral-large-2407-v1:0：Mistral Large，欧洲AI厂商的旗舰模型。

注意Bedrock上的模型可用性取决于你所选的AWS区域，不同区域支持的模型列表可能不同。

区域选择建议

AWS Bedrock在多个区域提供服务，选择区域时需要考虑：

延迟：选择距离你的用户最近的区域。
模型可用性：us-east-1和us-west-2通常支持最多的模型。
合规要求：某些数据合规法规可能要求数据不出境，需选择对应区域。

配置故障转移

建议为Bedrock配置跨提供商的故障转移：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0",
        "fallback": "anthropic/claude-3-5-sonnet-20241022"
      }
    }
  }
}

这样当Bedrock服务出现问题时，系统会自动切换到Anthropic直连API，确保服务不中断。

Bedrock的独特优势

选择通过Bedrock访问模型相比直接使用各厂商API的优势包括：

统一计费：所有模型费用统一在AWS账单中，简化财务管理。
企业安全：继承AWS的安全合规体系，支持VPC、私有链接等企业级网络配置。
无需管理多个API密钥：一套AWS凭证访问所有Bedrock上的模型。

完成以上配置后，发送一条测试消息验证Bedrock连接是否正常。查看OpenClaw日志确认请求正确路由到了Bedrock服务。