​

Amazon Bedrock

​

Що підтримує pi-ai

• Провайдер: amazon-bedrock
• API: bedrock-converse-stream
• Автентифікація: облікові дані AWS (змінні середовища, спільна конфігурація або роль екземпляра)
• Регіон: AWS_REGION або AWS_DEFAULT_REGION (типово: us-east-1)

​

Автоматичне виявлення моделей

• Якщо plugins.entries.amazon-bedrock.config.discovery.enabled має значення true, OpenClaw спробує виконати виявлення, навіть якщо немає маркера середовища AWS.
• Якщо plugins.entries.amazon-bedrock.config.discovery.enabled не задано, OpenClaw автоматично додає неявний провайдер Bedrock лише тоді, коли бачить один із цих маркерів автентифікації AWS: AWS_BEARER_TOKEN_BEDROCK, AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY або AWS_PROFILE.
• Фактичний шлях автентифікації під час виконання Bedrock все одно використовує стандартний ланцюжок AWS SDK, тому спільна конфігурація, SSO та автентифікація ролі екземпляра через IMDS можуть працювати, навіть якщо для виявлення потрібно було явно ввімкнути enabled: true.

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

• enabled типово працює в автоматичному режимі. В автоматичному режимі OpenClaw вмикає неявний провайдер Bedrock лише тоді, коли бачить підтримуваний маркер середовища AWS.
• region типово береться з AWS_REGION або AWS_DEFAULT_REGION, а потім us-east-1.
• providerFilter відповідає назвам провайдерів Bedrock (наприклад, anthropic).
• refreshInterval задається в секундах; установіть 0, щоб вимкнути кешування.
• defaultContextWindow (типово: 32000) і defaultMaxTokens (типово: 4096) використовуються для виявлених моделей (перевизначте, якщо знаєте ліміти своєї моделі).
• Для явних записів models.providers["amazon-bedrock"] OpenClaw усе одно може завчасно визначати автентифікацію Bedrock за маркерами середовища AWS, такими як AWS_BEARER_TOKEN_BEDROCK, без примусового повного завантаження автентифікації під час виконання. Фактичний шлях автентифікації для викликів моделі все одно використовує стандартний ланцюжок AWS SDK.

​

Початкове налаштування

1. Переконайтеся, що облікові дані AWS доступні на хості шлюзу:

export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"
# Необов’язково:
export AWS_SESSION_TOKEN="..."
export AWS_PROFILE="your-profile"
# Необов’язково (API-ключ Bedrock/токен bearer):
export AWS_BEARER_TOKEN_BEDROCK="..."

2. Додайте провайдера Bedrock і модель до своєї конфігурації (apiKey не потрібен):

{
  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" },
    },
  },
}

​

Ролі екземплярів EC2

• Установіть plugins.entries.amazon-bedrock.config.discovery.enabled у true.
• Установіть plugins.entries.amazon-bedrock.config.discovery.region (або експортуйте AWS_REGION).
• Вам не потрібен фіктивний API-ключ.
• Вам потрібен AWS_PROFILE=default, лише якщо ви спеціально хочете маркер середовища для автоматичного режиму або поверхонь статусу.

# Рекомендовано: явне ввімкнення виявлення + регіон
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled true
openclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1

# Необов’язково: додайте маркер середовища, якщо хочете автоматичний режим без явного ввімкнення
export AWS_PROFILE=default
export AWS_REGION=us-east-1

• bedrock:InvokeModel
• bedrock:InvokeModelWithResponseStream
• bedrock:ListFoundationModels (для автоматичного виявлення)
• bedrock:ListInferenceProfiles (для виявлення профілів інференсу)

​

Швидке налаштування (шлях AWS)

# 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-Access
aws 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 true
openclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1

# 4. Необов’язково: додайте маркер середовища, якщо хочете автоматичний режим без явного ввімкнення
echo 'export AWS_PROFILE=default' >> ~/.bashrc
echo 'export AWS_REGION=us-east-1' >> ~/.bashrc
source ~/.bashrc

# 5. Перевірте, що моделі виявлено
openclaw models list

​

Профілі інференсу

​

Примітки

• 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.
• Підтримка reasoning залежить від моделі; перевіряйте картку моделі Bedrock щодо актуальних можливостей.
• Якщо ви віддаєте перевагу керованому потоку ключів, ви також можете розмістити OpenAI‑сумісний проксі перед Bedrock і натомість налаштувати його як провайдера OpenAI.

​

Guardrails

{
  plugins: {
    entries: {
      "amazon-bedrock": {
        config: {
          guardrail: {
            guardrailIdentifier: "abc123", // ID guardrail або повний ARN
            guardrailVersion: "1", // номер версії або "DRAFT"
            streamProcessingMode: "sync", // необов’язково: "sync" або "async"
            trace: "enabled", // необов’язково: "enabled", "disabled" або "enabled_full"
          },
        },
      },
    },
  },
}

• guardrailIdentifier (обов’язково) приймає ID guardrail (наприклад, abc123) або повний ARN (наприклад, arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123).
• guardrailVersion (обов’язково) указує, яку опубліковану версію використовувати, або "DRAFT" для робочої чернетки.
• streamProcessingMode (необов’язково) визначає, чи виконуватиметься перевірка guardrail синхронно ("sync") чи асинхронно ("async") під час streaming. Якщо параметр пропущено, Bedrock використовує свою стандартну поведінку.
• trace (необов’язково) вмикає виведення трасування guardrail у відповіді API. Установіть "enabled" або "enabled_full" для налагодження; у production пропустіть параметр або встановіть "disabled".

​

Embeddings для пошуку в пам’яті

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0", // типово
      },
    },
  },
}