Providers

Amazon Bedrock

OpenClaw 可透過其 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 憑證的主機。

在閘道主機上設定 AWS 憑證

bash

export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID"export AWS_SECRET_ACCESS_KEY="..."export AWS_REGION="us-east-1"# 選用：export AWS_SESSION_TOKEN="..."export AWS_PROFILE="your-profile"# 選用（Bedrock API 金鑰／持有者權杖）：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 預設鏈，因此即使探索需要設定 enabled: true 才能啟用，共用設定、SSO 和 IMDS 執行個體角色驗證仍可正常運作。

探索設定選項

設定選項位於 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`	自動	在自動模式下，OpenClaw 只有在看到支援的 AWS 環境標記時，才會啟用隱含的 Bedrock 供應商。設為 `true` 可強制進行探索。
`region`	`AWS_REGION` / `AWS_DEFAULT_REGION` / `us-east-1`	用於探索 API 呼叫的 AWS 區域。
`providerFilter`	（全部）	比對 Bedrock 供應商名稱（例如 `anthropic`、`amazon`）。
`refreshInterval`	`3600`	快取期間，以秒為單位。設為 `0` 可停用快取。
`defaultContextWindow`	`32000`	用於未提供已知權杖限制之已探索模型的上下文視窗（如果你知道模型限制，請覆寫此值）。
`defaultMaxTokens`	`4096`	用於未提供已知權杖限制之已探索模型的最大輸出權杖數（如果你知道模型限制，請覆寫此值）。

上下文視窗與最大權杖限制

Bedrock ListFoundationModels 和 GetFoundationModel API 不會傳回權杖限制中繼資料，只會傳回模型 ID、名稱、模態和生命週期狀態。OpenClaw 隨附熱門 Bedrock 模型（Claude、Nova、Llama、Mistral、DeepSeek 等）的已知上下文視窗與輸出限制查找表，讓工作階段管理、壓縮閾值和上下文溢位偵測可針對這些模型正確運作。

不在此表中的已探索模型會回退使用 defaultContextWindow 和 defaultMaxTokens。如果你使用的模型缺少準確限制，請以明確的 models.providers["amazon-bedrock"].models 項目覆寫。

快速設定（AWS 路徑）

本逐步指南會建立 IAM 角色、附加 Bedrock 權限、關聯執行個體設定檔，並在 EC2 主機上啟用 OpenClaw 探索。

bash

# 1. 建立 IAM 角色和執行個體設定檔aws 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. 附加至你的 EC2 執行個體aws ec2 associate-iam-instance-profile \  --instance-id i-xxxxx \  --iam-instance-profile Name=EC2-Bedrock-Access # 3. 在 EC2 執行個體上明確啟用探索openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. 選用：如果你希望無須明確啟用即可使用自動模式，請新增環境標記echo 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. 確認已探索到模型openclaw models list

進階設定

推論設定檔

OpenClaw 會在基礎模型之外，同時探索區域和全域推論設定檔。當設定檔對應至已知基礎模型時，該設定檔會繼承該模型的能力（上下文視窗、最大權杖數、推理、視覺），並自動注入正確的 Bedrock 請求區域。這表示跨區域 Claude 設定檔無須手動覆寫供應商即可運作。全域跨區域設定檔（global.*）會在 openclaw models list 中優先列出，因為它們通常提供更佳容量和自動容錯移轉。

推論設定檔 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", // 套用至所有模型      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // 按模型覆寫          },        },      },    },  },}

有效值為 default、flex、priority 與 reserved。Claude Fable 5 和 Sonnet 5 僅支援 default 層級；若為這些模型要求 flex、priority 或 reserved，OpenClaw 會發出警告並忽略該設定。對於其他模型，並非每個模型都支援所有層級——不受支援的層級會傳回 Bedrock 驗證錯誤，而錯誤訊息可能具有誤導性（例如顯示「提供的模型識別碼無效」，而非指出問題出在層級）。如果看到此錯誤，請檢查該模型是否支援所要求的層級。

Claude Opus 4.7 and 4.8 temperature

Bedrock 會拒絕 Claude Opus 4.7 和 Opus 4.8 的 temperature 參數。 OpenClaw 會自動為任何相符的 Bedrock 參照省略 temperature，包括基礎模型 ID、具名推論設定檔、其底層模型透過 bedrock:GetInferenceProfile 解析為 Opus 4.7/4.8 的應用程式推論設定檔，以及帶有選用區域前綴（us.、eu.、ap.、apac.、au.、jp.、 global.）的點號式 opus-4.7/opus-4.8 變體。不需要任何設定開關，而且此省略同時適用於請求選項物件與 inferenceConfig 承載資料欄位。

Claude Fable 5

在 us-east-1 中使用 amazon-bedrock/anthropic.claude-fable-5，或使用如 us.anthropic.claude-fable-5 的區域推論 ID。 OpenClaw 會套用 Fable 的 100 萬內容窗口、128K 輸出上限、永遠啟用的自適應思考，以及受支援的投入程度對應。/think off 和 /think minimal 會對應至 low；系統會省略溫度與強制工具選擇控制項，與 Opus 4.7/4.8 路徑一致。串流輸出會保留到 Bedrock 傳回終止狀態，以避免串流途中遭拒時暴露部分文字。

AWS 要求明確選擇加入 provider_data_share 資料保留，才能使用 Fable。提示與完成內容會與 Anthropic 分享，並保留最多 30 天，以供信任與安全用途。啟用模型前，請檢閱並設定 Bedrock 資料保留。

Claude Mythos 5

Claude Mythos 5 僅供已取得必要有限存取核准的帳戶透過 Bedrock 使用。OpenClaw 可辨識基礎模型 anthropic.claude-mythos-5，以及如 us.anthropic.claude-mythos-5 的區域或全域推論設定檔。

OpenClaw 會套用 1,000,000 個權杖的內容窗口、128,000 個權杖的輸出上限、圖片輸入、提示快取、安全處理拒絕的串流，以及原生投入程度。自適應思考永遠啟用：/think off 和 /think minimal 會對應至 low，而 xhigh 和 max 仍然可用。系統會省略自訂取樣與強制工具選擇值。

Claude Sonnet 5

AWS 文件指出 Sonnet 5 同時支援 bedrock-runtime 與 bedrock-mantle 端點。 OpenClaw 可辨識 Bedrock 基礎模型 anthropic.claude-sonnet-5，以及如 us.anthropic.claude-sonnet-5 的區域或全域推論設定檔。它會套用 1,000,000 個權杖的內容窗口、128,000 個權杖的輸出上限、圖片輸入、原生投入程度、提示快取，以及安全處理拒絕的串流。

Bedrock 會讓 Sonnet 5 保持啟用自適應思考。OpenClaw 預設使用 high；由於此路徑無法停用思考，/think off 和 /think minimal 會對應至 low。啟用自適應思考時，系統會省略自訂溫度與強制工具選擇值。

Guardrails

你可以在 amazon-bedrock 外掛設定中加入 guardrail 物件，將 Amazon Bedrock 防護機制套用至所有 Bedrock 模型呼叫。防護機制可讓你強制執行內容篩選、主題拒絕、字詞篩選、敏感資訊篩選，以及情境依據檢查。

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 和 guardrailVersion 為必填。

選項	說明
`guardrailIdentifier`	防護機制 ID（例如 `abc123`）或完整 ARN（例如 `arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123`）。
`guardrailVersion`	已發布的版本號，或以 `"DRAFT"` 表示工作草稿。
`streamProcessingMode`	串流期間執行防護機制評估時使用 `"sync"` 或 `"async"`。若省略，Bedrock 會使用其預設值。
`trace`	偵錯時使用 `"enabled"` 或 `"enabled_full"`；正式環境中請省略或設為 `"disabled"`。

Embeddings for memory search

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 金鑰。

支援的嵌入模型包括 Amazon Titan Embed（v1、v2）、Amazon Nova Embed、Cohere Embed（v3、v4）及 TwelveLabs Marengo。完整模型清單與維度選項請參閱記憶設定參考——Bedrock。

Notes and caveats

Bedrock 要求在你的 AWS 帳戶／區域中啟用模型存取權。
自動探索需要 bedrock:ListFoundationModels 和 bedrock:ListInferenceProfiles 權限。
如果依賴自動模式，請在閘道主機上設定其中一個受支援的 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 提供者。

Amazon Bedrock

開始使用

存取金鑰／環境變數

在閘道主機上設定 AWS 憑證

將 Bedrock 供應商與模型新增至設定

確認模型可用

EC2 執行個體角色（IMDS）

明確啟用探索

選擇性新增環境標記以使用自動模式

確認已探索到模型

自動模型探索

快速設定（AWS 路徑）

進階設定

相關內容

On this page

Molty