提供商

Amazon Bedrock

OpenClaw 可以通过 pi-ai 的 Bedrock Converse 流式提供商使用 Amazon Bedrock 模型。Bedrock 凭证使用 AWS SDK 默认凭证链，而不是 API 密钥。

属性	值
提供商	`amazon-bedrock`
API	`bedrock-converse-stream`
凭证	AWS 凭证（环境变量、共享配置或实例角色）
区域	`AWS_REGION` 或 `AWS_DEFAULT_REGION`（默认：`us-east-1`）

入门指南

选择你偏好的凭证方式，并按设置步骤操作。

访问密钥 / 环境变量

**最适合：**开发机器、CI，或你直接管理 AWS 凭证的主机。

在 Gateway 网关主机上设置 AWS 凭证

bash

export AWS_ACCESS_KEY_ID="AKIA..."export AWS_SECRET_ACCESS_KEY="..."export AWS_REGION="us-east-1"# Optional:export AWS_SESSION_TOKEN="..."export AWS_PROFILE="your-profile"# Optional (Bedrock API key/bearer token):export AWS_BEARER_TOKEN_BEDROCK="..."

将 Bedrock 提供商和模型添加到你的配置

不需要 apiKey。使用 auth: "aws-sdk" 配置提供商：

json5

{  models: {    providers: {      "amazon-bedrock": {        baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com",        api: "bedrock-converse-stream",        auth: "aws-sdk",        models: [          {            id: "us.anthropic.claude-opus-4-6-v1:0",            name: "Claude Opus 4.6 (Bedrock)",            reasoning: true,            input: ["text", "image"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0" },    },  },}

验证模型可用

bash

openclaw models list

EC2 实例角色（IMDS）

**最适合：**附加了 IAM 角色的 EC2 实例，使用实例元数据服务进行身份验证。

显式启用发现

使用 IMDS 时，OpenClaw 无法仅通过环境标记检测 AWS 凭证，因此你必须选择启用：

bash

openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1

可选：为自动模式添加环境标记

如果你还希望环境标记自动检测路径生效（例如用于 openclaw status 界面）：

bash

export AWS_PROFILE=defaultexport AWS_REGION=us-east-1

你不需要假的 API 密钥。

验证模型已被发现

bash

openclaw models list

自动模型发现

OpenClaw 可以自动发现支持流式传输和文本输出的 Bedrock 模型。发现使用 bedrock:ListFoundationModels 和 bedrock:ListInferenceProfiles，结果会被缓存（默认：1 小时）。

隐式提供商的启用方式：

如果 plugins.entries.amazon-bedrock.config.discovery.enabled 为 true，即使没有 AWS 环境变量标记，OpenClaw 也会尝试设备发现。
如果未设置 plugins.entries.amazon-bedrock.config.discovery.enabled， OpenClaw 只会在看到以下 AWS 凭证标记之一时，才自动添加隐式 Bedrock 提供商： AWS_BEARER_TOKEN_BEDROCK、AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY，或 AWS_PROFILE。
实际的 Bedrock 运行时凭证路径仍使用 AWS SDK 默认链，因此共享配置、SSO 和 IMDS 实例角色凭证即使在设备发现需要 enabled: true 才能选择启用时也可以工作。

Discovery config options

配置选项位于 plugins.entries.amazon-bedrock.config.discovery 下：

json5

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          discovery: {            enabled: true,            region: "us-east-1",            providerFilter: ["anthropic", "amazon"],            refreshInterval: 3600,            defaultContextWindow: 32000,            defaultMaxTokens: 4096,          },        },      },    },  },}

选项	默认值	说明
`enabled`	auto	在 auto 模式下，OpenClaw 只有在看到受支持的 AWS 环境变量标记时，才会启用隐式 Bedrock 提供商。设为 `true` 可强制设备发现。
`region`	`AWS_REGION` / `AWS_DEFAULT_REGION` / `us-east-1`	用于设备发现 API 调用的 AWS 区域。
`providerFilter`	(all)	匹配 Bedrock 提供商名称（例如 `anthropic`、`amazon`）。
`refreshInterval`	`3600`	缓存时长，单位为秒。设为 `0` 可禁用缓存。
`defaultContextWindow`	`32000`	用于已发现模型的上下文窗口（如果你知道模型限制，可覆盖）。
`defaultMaxTokens`	`4096`	用于已发现模型的最大输出 token 数（如果你知道模型限制，可覆盖）。

快速设置（AWS 路径）

本演练会创建 IAM 角色、附加 Bedrock 权限、关联实例配置文件，并在 EC2 主机上启用 OpenClaw 设备发现。

bash

# 1. Create IAM role and instance profileaws iam create-role --role-name EC2-Bedrock-Access \  --assume-role-policy-document '{    "Version": "2012-10-17",    "Statement": [{      "Effect": "Allow",      "Principal": {"Service": "ec2.amazonaws.com"},      "Action": "sts:AssumeRole"    }]  }' aws iam attach-role-policy --role-name EC2-Bedrock-Access \  --policy-arn arn:aws:iam::aws:policy/AmazonBedrockFullAccess aws iam create-instance-profile --instance-profile-name EC2-Bedrock-Accessaws iam add-role-to-instance-profile \  --instance-profile-name EC2-Bedrock-Access \  --role-name EC2-Bedrock-Access # 2. Attach to your EC2 instanceaws ec2 associate-iam-instance-profile \  --instance-id i-xxxxx \  --iam-instance-profile Name=EC2-Bedrock-Access # 3. On the EC2 instance, enable discovery explicitlyopenclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. Optional: add an env marker if you want auto mode without explicit enableecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Verify models are discoveredopenclaw models list

高级配置

推理配置文件

OpenClaw 会在发现基础模型的同时发现区域和全局推理配置文件。当某个配置文件映射到已知基础模型时，该配置文件会继承该模型的能力（上下文窗口、最大 token 数、推理、视觉），并自动注入正确的 Bedrock 请求区域。这意味着跨区域 Claude 配置文件无需手动提供商覆盖即可工作。

推理配置文件 ID 的形式类似于 us.anthropic.claude-opus-4-6-v1:0（区域）或 anthropic.claude-opus-4-6-v1:0（全局）。如果其背后的模型已经在发现结果中，该配置文件会继承其完整能力集；否则会应用安全默认值。

不需要额外配置。只要已启用发现，并且 IAM 主体拥有 bedrock:ListInferenceProfiles，配置文件就会与基础模型一起出现在 openclaw models list 中。

服务层级

一些 Bedrock 模型支持 service_tier 参数，用于优化成本或延迟。可用层级如下：

层级	描述
`default`	标准 Bedrock 层级
`flex`	为可容忍更长延迟的工作负载提供折扣处理
`priority`	为延迟敏感型工作负载提供优先处理
`reserved`	为稳态工作负载提供预留容量

通过 agents.defaults.params 为 Bedrock 模型请求设置 serviceTier（或 service_tier），或在 agents.defaults.models["<model-key>"].params 中按模型设置：

json5

{  agents: {    defaults: {      params: {        serviceTier: "flex", // applies to all models      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // per-model override          },        },      },    },  },}

有效值为 default、flex、priority 和 reserved。并非所有模型都支持所有层级。如果请求了不受支持的层级，Bedrock 会返回验证错误。注意：该错误消息有些误导；它可能会说“The provided model identifier is invalid”，而不是指出服务层级不受支持。如果你看到此错误，请检查该模型是否支持所请求的层级。

Claude Opus 4.7 temperature 参数

Bedrock 会拒绝 Claude Opus 4.7 的 temperature 参数。对于任何 Opus 4.7 Bedrock 引用，OpenClaw 都会自动省略 temperature，包括基础模型 ID、命名推理配置文件、其底层模型通过 bedrock:GetInferenceProfile 解析为 Opus 4.7 的应用推理配置文件，以及带有可选区域前缀（us.、eu.、ap.、apac.、au.、jp.、global.）的点分 opus-4.7 变体。不需要配置开关，并且该省略同时适用于请求选项对象和 inferenceConfig 载荷字段。

Guardrails

你可以通过在 amazon-bedrock 插件配置中添加 guardrail 对象，将 Amazon Bedrock Guardrails 应用于所有 Bedrock 模型调用。Guardrails 允许你强制执行内容过滤、主题拒绝、词语过滤、敏感信息过滤和上下文 grounding 检查。

json5

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          guardrail: {            guardrailIdentifier: "abc123", // guardrail ID or full ARN            guardrailVersion: "1", // version number or "DRAFT"            streamProcessingMode: "sync", // optional: "sync" or "async"            trace: "enabled", // optional: "enabled", "disabled", or "enabled_full"          },        },      },    },  },}

选项	必填	描述
`guardrailIdentifier`	是	Guardrail ID（例如 `abc123`）或完整 ARN（例如 `arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123`）。
`guardrailVersion`	是	已发布的版本号，或用于工作草稿的 `"DRAFT"`。
`streamProcessingMode`	否	流式传输期间进行 guardrail 评估时使用 `"sync"` 或 `"async"`。如果省略，Bedrock 会使用默认值。
`trace`	否	调试时使用 `"enabled"` 或 `"enabled_full"`；生产环境中省略或设为 `"disabled"`。

用于记忆搜索的嵌入

Bedrock 也可以作为记忆搜索的嵌入提供商。这与推理提供商分开配置，将 agents.defaults.memorySearch.provider 设为 "bedrock"：

json5

{  agents: {    defaults: {      memorySearch: {        provider: "bedrock",        model: "amazon.titan-embed-text-v2:0", // default      },    },  },}

Bedrock 嵌入使用与推理相同的 AWS SDK 凭证链（实例角色、SSO、访问密钥、共享配置和 Web 身份）。不需要 API key。当 provider 为 "auto" 时，如果该凭证链成功解析，Bedrock 会被自动检测到。

支持的嵌入模型包括 Amazon Titan Embed（v1、v2）、Amazon Nova Embed、Cohere Embed（v3、v4）和 TwelveLabs Marengo。完整模型列表和维度选项见记忆配置参考 -- Bedrock。

注意事项和限制

Bedrock 要求在你的 AWS 账户/区域中启用模型访问权限。
自动发现需要 bedrock:ListFoundationModels 和 bedrock:ListInferenceProfiles 权限。
如果你依赖自动模式，请在 Gateway 网关主机上设置一个受支持的 AWS 认证环境标记。如果你偏好使用没有环境标记的 IMDS/共享配置认证，请设置 plugins.entries.amazon-bedrock.config.discovery.enabled: true。
OpenClaw 按以下顺序展示凭证来源：AWS_BEARER_TOKEN_BEDROCK，然后是 AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY，然后是 AWS_PROFILE，最后是默认 AWS SDK 链。
推理支持取决于模型；请查看 Bedrock 模型卡以了解当前能力。
如果你偏好托管密钥流程，也可以在 Bedrock 前放置一个 OpenAI 兼容的代理，并将其配置为 OpenAI provider。

Amazon Bedrock

入门指南

访问密钥 / 环境变量

在 Gateway 网关主机上设置 AWS 凭证

将 Bedrock 提供商和模型添加到你的配置

验证模型可用

EC2 实例角色（IMDS）

显式启用发现

可选：为自动模式添加环境标记

验证模型已被发现

自动模型发现

快速设置（AWS 路径）

高级配置

相关内容

Ask OpenClaw