Amazon Bedrock | OpenClaw 中文解释版

OpenClaw可以通过一个叫pi-ai的“魔法通道”，使用亚马逊Bedrock大脑库里的模型。它不用普通的密码钥匙，而是用亚马逊自己的一套“身份证明”来敲门。

你需要准备什么？

身份证明：就像进游乐园要戴手环一样，OpenClaw需要知道它是谁。这叫做“AWS凭证”。你可以把它想成是三个秘密口令：AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY和AWS_REGION。把它们放在运行OpenClaw的那台电脑的环境里。
权限：光有身份证明还不够，这个身份还得有“门票”。它需要被允许做三件事：bedrock:InvokeModel（请模型出来）、bedrock:InvokeModelWithResponseStream（请模型流式地出来说话）、bedrock:ListFoundationModels（看看有哪些模型可以请）。或者，直接给它一张“全场通票”，叫做AmazonBedrockFullAccess。

怎么让OpenClaw自动发现模型？ OpenClaw很聪明，如果它发现了你的AWS身份证明，它可以自己去Bedrock大脑库里看看有哪些模型能“流式”说话和输出文字。这个发现过程会被记住一段时间（默认1小时）。你可以在一个叫models.bedrockDiscovery的设置里调整它：

enabled：开关，默认是打开的。
region：去哪个地区的库房里找，默认是us-east-1。
providerFilter：只想找谁家的模型？比如["anthropic", "amazon"]就是只找Anthropic和亚马逊自家的。
refreshInterval：多久重新找一次（秒数），设为0就不记住，每次都重新找。
defaultContextWindow和defaultMaxTokens：给发现的模型假设的“记忆力”和“说话长度”，如果你知道模型的真实能力，可以改掉它们。

最重要的设置步骤

第一步：准备好身份证明。在你运行OpenClaw的电脑上，设置好那些秘密口令。就像在电脑里大声说出它们一样：
```
export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"
```
第二步：告诉OpenClaw怎么用Bedrock。你需要修改OpenClaw的配置文件，增加一个“供应商”。注意，这里不需要apiKey，因为用的是AWS身份证明。
- 供应商名字是：amazon-bedrock。
- 用的API是：bedrock-converse-stream。
- 验证方式是：aws-sdk。
- 然后，在它的models列表里，把你想要用的模型加进去，比如一个叫us.anthropic.claude-opus-4-6-v1:0的模型。

如果你在亚马逊的EC2电脑上运行 如果你的OpenClaw是跑在亚马逊的EC2电脑上，并且那台电脑已经戴好了有权限的“角色手环”（IAM角色），那么身份验证会自动进行。但是，OpenClaw现在有个小迷糊：它只会检查环境里的口令，不会自动发现电脑的“角色手环”。

解决办法：你只需要在环境里设置AWS_PROFILE=default，就像挥挥手告诉OpenClaw：“嘿，我有身份证明哦！”这样它就会去用EC2电脑自己的角色了。记得也要设置AWS_REGION。

一些重要的小提醒

在你亚马逊的账户里，必须先启用对Bedrock模型的访问权限，不然什么都找不到。
自动发现模型需要bedrock:ListFoundationModels这个权限。
模型会不会“推理”（像一步一步想问题），要看模型自己有没有这个本事，你需要去查Bedrock的模型卡片。
OpenClaw找身份证明的顺序是：先找特殊的AWS_BEARER_TOKEN_BEDROCK，再找AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY这对组合，再找AWS_PROFILE，最后用AWS默认的方式。

一个快速的整装待发指南（AWS路径） 如果你是从头开始，在亚马逊EC2上设置一切，可以按这个来：

创建一个有权限的IAM角色和实例配置文件。
把这个角色绑到你的EC2电脑上。
在EC2电脑上，打开OpenClaw的模型自动发现开关。
设置AWS_PROFILE=default和AWS_REGION这两个环境变量。
最后，用openclaw models list命令看看模型是不是都被发现啦！