本页内容
本页内容
供应商
Amazon Bedrock
OpenClaw 可以通过其 Bedrock Converse 流式 provider 使用 Amazon Bedrock 模型。Bedrock 身份验证使用 AWS SDK 默认凭证链,而不是 API 密钥。
| 属性 | 值 |
|---|---|
| 提供者 | amazon-bedrock |
| API | bedrock-converse-stream |
| 认证 | AWS 凭证(环境变量、共享配置或实例角色) |
| 区域 | AWS_REGION 或 AWS_DEFAULT_REGION(默认:us-east-1) |
自定义提供商 ID(例如,amazon-bedrock-east1)可以使用 api: "bedrock-converse-stream" 和 auth: "aws-sdk"。他们激活相同的基岩插件。该区域来自所选提供商的标准 bedrock-runtime.<region>.amazonaws.com URL,然后是解析的模型 URL,然后是插件发现区域。如果没有其中之一,则应用 AWS SDK 区域环境和配置文件设置。自定义路由不会继承库存 amazon-bedrock 提供商的区域。
入门
选择您首选的身份验证方法并按照设置步骤操作。
访问键/环境变量
最适合: 开发机、CI,或你直接管理 AWS 凭证的主机。
在网关主机上设置 AWS 凭据
将基岩提供商和模型添加到您的配置中
不需要 apiKey。使用 auth: "aws-sdk" 配置 provider:
验证模型是否可用
EC2 实例角色 (IMDS)
最适合:附加了 IAM 角色的 EC2 实例,使用实例元数据服务进行身份验证。
显式启用发现
使用 IMDS 时,OpenClaw 不能仅从 env marker 检测到 AWS 身份验证,因此你必须显式启用:
可以选择为自动模式添加环境标记
如果你还希望 env-marker 自动检测路径生效(例如用于 openclaw status 展示):
你不需要伪造的 API 密钥。
验证模型是否被发现
自动模型发现
OpenClaw 可以自动发现支持 流式输出 和 文本输出 的 Bedrock 模型。发现过程使用 bedrock:ListFoundationModels 和 bedrock:ListInferenceProfiles,结果会被缓存(默认:1 小时)。
在 OpenClaw 缓存结果之前,两个列表(包括每个推理配置文件页面)都必须成功。刷新失败会报告不可用或拒绝目录访问,并保留兼容的最新模型。恢复对两个列表操作的访问并再次刷新。成功的空列表会清除已发现的成员资格。
在启动时没有兼容的先前目录的情况下,失败的推理配置文件列表也会阻止仅基础清单。授予两个列表权限或使用显式 models.providers["amazon-bedrock"].models 列表。
插件的公共发现帮助程序的编程调用者保留来自 v2026.9.2. 的建议默认值,传递 discoveryMode: "strict" 以传播获取失败并保留成功的空提供程序结果,就像捆绑的目录挂钩所做的那样。咨询部分结果不会作为完整清单缓存。
隐式 provider 的启用方式:
- 如果
plugins.entries.amazon-bedrock.config.discovery.enabled为true, 即使没有 AWS env marker,OpenClaw 也会尝试发现。 - 如果未设置
plugins.entries.amazon-bedrock.config.discovery.enabled, OpenClaw 只会在检测到以下 AWS 身份验证标记之一时自动添加隐式 Bedrock provider:AWS_BEARER_TOKEN_BEDROCK、AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY,或AWS_PROFILE。 - 实际的 Bedrock 运行时身份验证路径仍然使用 AWS SDK 默认链,因此即使发现过程需要通过
enabled: true显式启用,共享配置、SSO 和 IMDS 实例角色身份验证也可以正常工作。
发现配置选项
配置选项位于 plugins.entries.amazon-bedrock.config.discovery 下:
| 选项 | 默认值 | 描述 |
|---|---|---|
enabled |
汽车 | 在自动模式下,OpenClaw 仅在检测到受支持的 AWS env marker 时启用隐式 Bedrock provider。设置为 true 可强制发现。 |
region |
AWS_REGION / AWS_DEFAULT_REGION / us-east-1 |
用于发现 API 调用的 AWS 区域。 |
providerFilter |
(全部) | 匹配 Bedrock provider 名称(例如 anthropic、amazon)。 |
refreshInterval |
3600 |
缓存时长,单位为秒。设置为 0 可禁用缓存。 |
defaultContextWindow |
32000 |
用于未知 token 限制的已发现模型的上下文窗口(如果你知道模型限制,可覆盖此值)。 |
defaultMaxTokens |
4096 |
用于未知 token 限制的已发现模型的最大输出 token 数(如果你知道模型限制,可覆盖此值)。 |
上下文窗口和最大令牌限制
Bedrock ListFoundationModels 和 GetFoundationModel API 不返回令牌限制元数据,仅返回模型 ID、名称、模式和生命周期状态。 OpenClaw 为流行的基岩模型(Claude、Nova、Llama、Mistral、DeepSeek 等)提供了已知上下文窗口和输出限制的查找表,因此会话管理、压缩阈值和上下文溢出检测可以在这些模型上正常工作。
未在表中的已发现模型会回退到 defaultContextWindow 和 defaultMaxTokens。如果你使用的模型缺少准确限制,请通过显式的 models.providers["amazon-bedrock"].models 条目进行覆盖。
快速设置(AWS 路径)
此流程会创建 IAM 角色、附加 Bedrock 权限、关联实例配置文件,并在 EC2 主机上启用 OpenClaw 发现功能。
高级配置
推理配置文件
OpenClaw 会在基础模型之外一并发现 区域和全局推理配置文件。当配置文件映射到已知的基础模型时,该配置文件会继承该模型的能力(上下文窗口、最大 token 数、推理、视觉),并且会自动注入正确的 Bedrock 请求区域。这意味着跨区域 Claude 配置文件无需手动覆盖 provider 即可工作。全局跨区域配置文件(global.*)会在 openclaw models list 中优先显示,因为它们通常提供更好的容量和自动故障转移。
推理配置文件 ID 类似于 us.anthropic.claude-opus-4-6-v1(区域)或 anthropic.claude-opus-4-6-v1(全球)。如果支持模型已存在于发现结果中,则配置文件将继承其完整功能集;否则应用安全默认值。
无需额外配置。只要启用了发现,并且 IAM 主体具有 bedrock:ListInferenceProfiles,配置文件就会与基础模型一起出现在 openclaw models list 中。
服务等级
某些 Bedrock 模型支持 service_tier 参数,用于优化成本或延迟。可用的层级如下:
| 层级 | 描述 |
|---|---|
default |
标准 Bedrock 层级 |
flex |
适用于可接受更长延迟的工作负载的折扣处理 |
priority |
适用于对延迟敏感的工作负载的优先处理 |
reserved |
适用于稳定态工作负载的预留容量 |
通过 agents.defaults.params 为基岩模型请求设置 serviceTier(或 service_tier),或 agents.defaults.models["<model-key>"].params 中的每个模型:
有效值为 default、flex、priority 和 reserved。 Claude Fable 5、Opus 5和Sonnet 5仅支持default层; OpenClaw 发出警告并忽略针对这些模型请求的 flex、priority 或 reserved。对于其他模型,并非每个模型都支持每个层 - 不受支持的层会返回基岩验证错误,并且错误消息可能会产生误导(例如“提供的模型标识符无效”,而不是将该层命名为问题)。如果您看到此错误,请检查模型是否支持请求的层。
Claude Opus 5、4.8 和 4.7 温度
Bedrock 拒绝 Claude Opus 5、Opus 4.8 和 Opus 4.7. OpenClaw 自动忽略 temperature 的 temperature 参数匹配基岩参考,包括基础模型 ID、命名推理配置文件、底层模型通过 bedrock:GetInferenceProfile 解析为 Opus 5/4.8/4.7 的应用程序推理配置文件,以及带有可选区域前缀的点状 opus-4.7/opus-4.8 变体(us.、 eu.、ap.、apac.、au.、jp.、global.)。不需要配置旋钮,并且省略适用于请求选项对象和 inferenceConfig 有效负载字段。
Claude Opus 5
在 Messages-API Bedrock 端点上使用 amazon-bedrock/anthropic.claude-opus-5,或使用 regional/global 推理配置文件,例如出现在 Bedrock 发现中的 global.anthropic.claude-opus-5。 OpenClaw 应用 1,000,000 个令牌上下文窗口、128,000 个令牌输出限制、图像输入、提示缓存、拒绝安全流和本机 xhigh/max 工作级别。
适应性思维默认为 high。 /think off 禁用思维,而 /think xhigh|max 保持自适应思维启用。 OpenClaw 省略了自定义采样参数和不受支持的非默认服务层。
Claude 寓言5
在 us-east-1 中使用 amazon-bedrock/anthropic.claude-fable-5,或区域推理 ID,例如 us.anthropic.claude-fable-5。 OpenClaw 应用了 Fable 的 1M 上下文窗口、128K 输出限制、始终在线的自适应思维以及支持的工作量映射。 《神鬼寓言5》和《5.1》默认为medium的努力;明确的努力设置优先。 /think off 和 /think minimal 映射到 low;省略了温度和强制工具选择控制,与 Opus 4.7/4.8 路线相匹配。流输出将一直保留,直到 Bedrock 返回终端状态,因此中流拒绝不会暴露部分文本。
AWS 要求在 Fable 可用之前显式选择加入 provider_data_share 数据保留。 提示和补全内容会与 Anthropic 共享,并最多保留 30 天用于信任与安全。 在启用该模型前,请先查看并配置 Bedrock data retention 。
Claude神话5
Claude Mythos 5 仅对已获得所需有限访问批准的账户可通过 Bedrock 使用。OpenClaw 能识别基础模型 anthropic.claude-mythos-5 以及区域或全局推理配置文件,例如 us.anthropic.claude-mythos-5。
OpenClaw 会应用 1,000,000 token 的上下文窗口、128,000 token 的输出上限、图像输入、提示缓存、拒绝安全流式传输,以及原生 effort 等级。自适应思考始终开启:/think off 和 /think minimal 映射为 low,而 xhigh 和 max 仍然可用。 自定义采样和强制工具选择值会被省略。
Claude Sonnet 5
AWS 在 bedrock-runtime 和 bedrock-mantle 端点 上都记录了 Sonnet 5。 OpenClaw 识别 Bedrock 基础模型 anthropic.claude-sonnet-5 以及区域或全局推理配置文件,例如 us.anthropic.claude-sonnet-5。它会应用 1,000,000 token 的上下文窗口、128,000 token 的输出上限、图像输入、原生 effort 等级、 提示缓存和拒绝安全流式传输。
Bedrock 会为 Sonnet 5 保持自适应思考开启。OpenClaw 默认使用 high;/think off 和 /think minimal 映射为 low,因为该路由无法关闭思考功能。当自适应思考处于活动状态时,自定义 temperature 和强制工具选择值会被省略。
护栏
您可以通过将 guardrail 对象添加到 amazon-bedrock 插件配置来将 Amazon Bedrock Guardrails 应用于所有 Bedrock 模型调用。 Guardrails 可让您强制执行内容过滤、主题拒绝、单词过滤器、敏感信息过滤器和上下文基础检查。
guardrailIdentifier 和 guardrailVersion 是必需的。
| 选项 | 描述 |
|---|---|
guardrailIdentifier |
护栏ID(e.g. abc123)或完整ARN(e.g. arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123)。 |
guardrailVersion |
已发布的版本号,或用于工作草稿的 "DRAFT"。 |
streamProcessingMode |
流式传输期间用于 guardrail 评估的 "sync" 或 "async"。如果省略,Bedrock 将使用其默认值。 |
trace |
用于调试的 "enabled" 或 "enabled_full";生产环境中省略或设为 "disabled"。 |
用于内存搜索的嵌入
Bedrock还可以充当内存搜索的嵌入提供者。这是与推理提供程序分开配置的——将 memory.search.provider 设置为 "bedrock":
Bedrock embeddings 使用与 inference 相同的 AWS SDK 凭证链(实例角色、SSO、访问密钥、共享配置和 web identity)。不需要 API 密钥。
支持的 embedding 模型包括 Amazon Titan Embed(v1、v2)、Amazon Nova Embed、Cohere Embed(v3、v4)以及 TwelveLabs Marengo。有关完整的模型列表和维度选项,请参见 Memory configuration reference -- Bedrock。
注意事项和警告
- Bedrock 需要在 AWS account/region. 中启用 模型访问
- 自动发现需要
bedrock:ListFoundationModels和bedrock:ListInferenceProfiles权限。 - 如果您依赖自动模式,请在网关主机上设置受支持的 AWS 身份验证环境标记之一。如果您更喜欢不带环境标记的 IMDS/shared-config 身份验证,请设置
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 提供程序。