Amazon Bedrock

OpenClaw kan Amazon Bedrock-modellen gebruiken via pi‑ai’s Bedrock Converse streamingprovider. Bedrock-authenticatie gebruikt de standaard AWS SDK‑credential chain, niet een API-sleutel.

Wat pi‑ai ondersteunt

Provider: amazon-bedrock
API: bedrock-converse-stream
Auth: AWS-referenties (omgevingsvariabelen, gedeelde config of instance role)
Regio: AWS_REGION of AWS_DEFAULT_REGION (standaard: us-east-1)

Automatische model discovery

Als AWS-referenties worden gedetecteerd, kan OpenClaw automatisch Bedrock-modellen ontdekken die streaming en tekstuitvoer ondersteunen. Discovery gebruikt bedrock:ListFoundationModels en wordt gecachet (standaard: 1 uur). Config-opties staan onder models.bedrockDiscovery:

{
  models: {
    bedrockDiscovery: {
      enabled: true,
      region: "us-east-1",
      providerFilter: ["anthropic", "amazon"],
      refreshInterval: 3600,
      defaultContextWindow: 32000,
      defaultMaxTokens: 4096,
    },
  },
}

Notities:

enabled staat standaard op true wanneer AWS-referenties aanwezig zijn.
region staat standaard op AWS_REGION of AWS_DEFAULT_REGION, daarna us-east-1.
providerFilter komt overeen met namen van Bedrock-providers (bijvoorbeeld anthropic).
refreshInterval is in seconden; stel in op 0 om cachen uit te schakelen.
defaultContextWindow (standaard: 32000) en defaultMaxTokens (standaard: 4096) worden gebruikt voor ontdekte modellen (overschrijf als je je modellimieten kent).

Installatie (handmatig)

Zorg dat AWS-referenties beschikbaar zijn op de Gateway-host:

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

Voeg een Bedrock-provider en -model toe aan je config (geen apiKey vereist):

{
  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-instantierollen

Wanneer OpenClaw draait op een EC2-instance met een gekoppelde IAM-rol, gebruikt de AWS SDK automatisch de instance metadata service (IMDS) voor authenticatie. De detectie van referenties in OpenClaw controleert momenteel echter alleen omgevingsvariabelen, niet IMDS-referenties. Workaround: Stel AWS_PROFILE=default in om aan te geven dat AWS-referenties beschikbaar zijn. De daadwerkelijke authenticatie gebruikt nog steeds de instance role via IMDS.

# Add to ~/.bashrc or your shell profile
export AWS_PROFILE=default
export AWS_REGION=us-east-1

Vereiste IAM-rechten voor de EC2-instance role:

bedrock:InvokeModel
bedrock:InvokeModelWithResponseStream
bedrock:ListFoundationModels (voor automatische discovery)

Of koppel het beheerde beleid AmazonBedrockFullAccess. Snelle installatie:

# 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
openclaw config set models.bedrockDiscovery.enabled true
openclaw config set models.bedrockDiscovery.region us-east-1

# 4. Set the workaround env vars
echo 'export AWS_PROFILE=default' >> ~/.bashrc
echo 'export AWS_REGION=us-east-1' >> ~/.bashrc
source ~/.bashrc

# 5. Verify models are discovered
openclaw models list

Notities

Bedrock vereist dat modeltoegang is ingeschakeld in je AWS-account/regio.
Automatische discovery vereist de machtiging bedrock:ListFoundationModels.
Als je profielen gebruikt, stel AWS_PROFILE in op de Gateway-host.
OpenClaw toont de credentialbron in deze volgorde: AWS_BEARER_TOKEN_BEDROCK, daarna AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, daarna AWS_PROFILE, en vervolgens de standaard AWS SDK‑chain.
Ondersteuning voor redeneren hangt af van het model; raadpleeg de Bedrock-modelkaart voor de huidige mogelijkheden.
Als je de voorkeur geeft aan een beheerde sleutelstroom, kun je ook een OpenAI‑compatibele proxy vóór Bedrock plaatsen en deze in plaats daarvan configureren als een OpenAI-provider.

Overzicht

Modelconcepten

Configuratie

Providers

Amazon Bedrock

Amazon Bedrock

Wat pi‑ai ondersteunt

Automatische model discovery

Installatie (handmatig)

EC2-instantierollen

Notities

​Amazon Bedrock

​Wat pi‑ai ondersteunt

​Automatische model discovery

​Installatie (handmatig)

​EC2-instantierollen

​Notities

Amazon Bedrock

Wat pi‑ai ondersteunt

Automatische model discovery

Installatie (handmatig)

EC2-instantierollen

Notities