Amazon Bedrock¶

OpenClaw, pi‑ai के Bedrock Converse के माध्यम से Amazon Bedrock मॉडल्स का उपयोग कर सकता है streaming provider. Bedrock auth uses the AWS SDK default credential chain, not an API key.

pi‑ai क्या समर्थन करता है¶

• प्रदाता: amazon-bedrock
• API: bedrock-converse-stream
• Auth: AWS क्रेडेंशियल (env vars, साझा कॉन्फ़िग, या इंस्टेंस रोल)
• Region: AWS_REGION या AWS_DEFAULT_REGION (डिफ़ॉल्ट: us-east-1)

स्वचालित मॉडल डिस्कवरी¶

यदि AWS क्रेडेंशियल्स का पता चलता है, तो OpenClaw स्वचालित रूप से Bedrock को खोज सकता है models that support streaming and text output. Discovery uses bedrock:ListFoundationModels and is cached (default: 1 hour).

कॉन्फ़िग विकल्प models.bedrockDiscovery के अंतर्गत होते हैं:

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

नोट्स:

• enabled AWS क्रेडेंशियल उपलब्ध होने पर डिफ़ॉल्ट रूप से true होता है।
• region डिफ़ॉल्ट रूप से AWS_REGION या AWS_DEFAULT_REGION, फिर us-east-1 होता है।
• providerFilter Bedrock प्रदाता नामों से मेल खाता है (उदाहरण के लिए anthropic)।
• refreshInterval सेकंड में है; कैशिंग अक्षम करने के लिए 0 पर सेट करें।
• defaultContextWindow (डिफ़ॉल्ट: 32000) और defaultMaxTokens (डिफ़ॉल्ट: 4096) खोजे गए मॉडलों के लिए उपयोग किए जाते हैं (यदि आपको अपने मॉडल की सीमाएँ पता हों तो ओवरराइड करें)।

सेटअप (मैनुअल)¶

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 आवश्यक नहीं):

{
  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 इंस्टेंस रोल्स¶

जब OpenClaw को किसी EC2 instance पर संलग्न IAM role के साथ चलाया जाता है, तो AWS SDK will automatically use the instance metadata service (IMDS) for authentication. However, OpenClaw's credential detection currently only checks for environment variables, not IMDS credentials.

समाधान: यह संकेत देने के लिए AWS_PROFILE=default सेट करें कि AWS क्रेडेंशियल्स उपलब्ध हैं available. The actual authentication still uses the instance role via IMDS.

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

EC2 इंस्टेंस रोल के लिए आवश्यक IAM अनुमतियाँ:

• bedrock:InvokeModel
• bedrock:InvokeModelWithResponseStream
• bedrock:ListFoundationModels (स्वचालित डिस्कवरी के लिए)

या प्रबंधित पॉलिसी AmazonBedrockFullAccess संलग्न करें।

त्वरित सेटअप:

# 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

नोट्स¶

• Bedrock के लिए आपके AWS अकाउंट/रीजन में मॉडल एक्सेस सक्षम होना आवश्यक है।
• स्वचालित डिस्कवरी के लिए bedrock:ListFoundationModels अनुमति की आवश्यकता होती है।
• यदि आप प्रोफाइल का उपयोग करते हैं, तो Gateway होस्ट पर AWS_PROFILE सेट करें।
• OpenClaw क्रेडेंशियल स्रोत को इस क्रम में दर्शाता है: AWS_BEARER_TOKEN_BEDROCK, फिर AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, फिर AWS_PROFILE, फिर डिफ़ॉल्ट AWS SDK चेन।
• रीज़निंग समर्थन मॉडल पर निर्भर करता है; वर्तमान क्षमताओं के लिए Bedrock मॉडल कार्ड देखें।
• यदि आप प्रबंधित कुंजी प्रवाह को प्राथमिकता देते हैं, तो आप Bedrock के सामने OpenAI‑संगत प्रॉक्सी भी रख सकते हैं और इसे OpenAI प्रदाता के रूप में कॉन्फ़िगर कर सकते हैं।