跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 可以透過 pi-ai 的 Bedrock Converse 串流提供者使用 Amazon Bedrock 模型。Bedrock 驗證使用 AWS SDK 預設憑證鏈，不是 API 金鑰。
屬性值
提供者amazon-bedrock
APIbedrock-converse-stream
驗證AWS 憑證（環境變數、共用設定或執行個體角色）
區域AWS_REGION 或 AWS_DEFAULT_REGION（預設：us-east-1）

​
開始使用

選擇偏好的驗證方法，並依照設定步驟操作。
最適合： 開發者機器、CI，或你直接管理 AWS 憑證的主機。
1

在 gateway 主機上設定 AWS 憑證

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="..."
2

將 Bedrock 提供者和模型新增到你的設定

不需要 apiKey。使用 auth: "aws-sdk" 設定提供者：
{
  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" },
    },
  },
}
3

確認模型可用

openclaw models list
使用環境標記驗證（AWS_ACCESS_KEY_ID、AWS_PROFILE 或 AWS_BEARER_TOKEN_BEDROCK）時，OpenClaw 會自動啟用隱含的 Bedrock 提供者，以便在沒有額外設定的情況下進行模型探索。

​
自動模型探索

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 執行個體角色驗證仍可運作。
對於明確的 models.providers["amazon-bedrock"] 項目，OpenClaw 仍可從 AWS 環境標記（例如 AWS_BEARER_TOKEN_BEDROCK）提早解析 Bedrock 環境標記驗證，而不強制載入完整執行階段驗證。實際的模型呼叫驗證路徑仍使用 AWS SDK 預設鏈。
設定選項位於 plugins.entries.amazon-bedrock.config.discovery 下：
{
  plugins: {
    entries: {
      "amazon-bedrock": {
        config: {
          discovery: {
            enabled: true,
            region: "us-east-1",
            providerFilter: ["anthropic", "amazon"],
            refreshInterval: 3600,
            defaultContextWindow: 32000,
            defaultMaxTokens: 4096,
          },
        },
      },
    },
  },
}
選項預設值說明
enabledauto在自動模式中，OpenClaw 只有在看到支援的 AWS 環境標記時，才會啟用隱含的 Bedrock 提供者。設為 true 可強制探索。
regionAWS_REGION / AWS_DEFAULT_REGION / us-east-1用於探索 API 呼叫的 AWS 區域。
providerFilter（全部）符合 Bedrock 提供者名稱（例如 anthropic、amazon）。
refreshInterval3600快取持續時間，以秒為單位。設為 0 可停用快取。
defaultContextWindow32000已探索模型使用的上下文視窗（如果你知道模型限制，可覆寫）。
defaultMaxTokens4096已探索模型使用的最大輸出 Token 數（如果你知道模型限制，可覆寫）。

​
快速設定（AWS 路徑）

此逐步說明會建立 IAM 角色、附加 Bedrock 權限、關聯執行個體設定檔，並在 EC2 主機上啟用 OpenClaw 探索。 
# 1. Create IAM role and instance profile
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-Access
aws iam add-role-to-instance-profile \
  --instance-profile-name EC2-Bedrock-Access \
  --role-name EC2-Bedrock-Access

# 2. Attach to your EC2 instance
aws ec2 associate-iam-instance-profile \
  --instance-id i-xxxxx \
  --iam-instance-profile Name=EC2-Bedrock-Access

# 3. On the EC2 instance, enable discovery explicitly
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled true
openclaw 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 enable
echo 'export AWS_PROFILE=default' >> ~/.bashrc
echo 'export AWS_REGION=us-east-1' >> ~/.bashrc
source ~/.bashrc

# 5. Verify models are discovered
openclaw 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 會拒絕 Claude Opus 4.7 的 temperature 參數。OpenClaw 會自動略過任何 Opus 4.7 Bedrock 參照的 temperature，包括基礎模型 ID、命名推論設定檔、其底層模型透過 bedrock:GetInferenceProfile 解析為 Opus 4.7 的應用程式推論設定檔，以及具有選用區域前綴（us.、eu.、ap.、apac.、au.、jp.、global.）的點分 opus-4.7 變體。不需要設定旋鈕，且此略過會套用到請求選項物件與 inferenceConfig 承載欄位。
你可以透過將 guardrail 物件新增到 amazon-bedrock Plugin 設定，將 Amazon Bedrock Guardrails 套用到所有 Bedrock 模型叫用。防護欄可讓你強制執行內容篩選、主題拒絕、字詞篩選、敏感資訊篩選，以及情境接地檢查。
{
  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是防護欄 ID（例如 abc123）或完整 ARN（例如 arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123）。
guardrailVersion是已發布版本號，或工作草稿的 "DRAFT"。
streamProcessingMode否串流期間防護欄評估使用的 "sync" 或 "async"。如果省略，Bedrock 會使用其預設值。
trace否用於偵錯的 "enabled" 或 "enabled_full"；生產環境請省略或設為 "disabled"。
Gateway 使用的 IAM 主體除了標準叫用權限外，還必須具備 bedrock:ApplyGuardrail 權限。
Bedrock 也可以作為 記憶搜尋的嵌入提供者。這會與推論提供者分開設定，請將 agents.defaults.memorySearch.provider 設為 "bedrock"：
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0", // default
      },
    },
  },
}
Bedrock 嵌入使用與推論相同的 AWS SDK 憑證鏈（執行個體角色、SSO、存取金鑰、共用設定，以及 Web 身分）。不需要 API 金鑰。當 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 提供者。

​
相關

模型選擇

選擇提供者、模型參照和容錯移轉行為。

記憶搜尋

Bedrock 嵌入的記憶搜尋設定。

記憶設定參考

完整的 Bedrock 嵌入模型清單和維度選項。

疑難排解

一般疑難排解與常見問題。