Anthropic

Anthropic خانواده مدل‌های Claude را می‌سازد. OpenClaw از دو مسیر احراز هویت پشتیبانی می‌کند:

• کلید API — دسترسی مستقیم به API شرکت Anthropic با صورت‌حساب مبتنی بر میزان استفاده (مدل‌های anthropic/*)
• Claude CLI — استفاده دوباره از ورود موجود Claude Code روی همان میزبان

شروع کار

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

پیش‌فرض‌های تفکر (Claude Fable 5، 4.8، و 4.6)

anthropic/claude-fable-5 همیشه از تفکر تطبیقی استفاده می‌کند و به‌صورت پیش‌فرض روی تلاش high قرار دارد. چون Anthropic اجازه نمی‌دهد تفکر برای این مدل غیرفعال شود، /think off و /think minimal از تلاش low استفاده می‌کنند. OpenClaw همچنین مقادیر سفارشی temperature را برای درخواست‌های Fable 5 حذف می‌کند.

Claude Opus 4.8 در OpenClaw به‌صورت پیش‌فرض تفکر را خاموش نگه می‌دارد. وقتی تفکر تطبیقی را با /think high|xhigh|max صراحتا فعال می‌کنید، OpenClaw مقادیر تلاش Opus 4.8 شرکت Anthropic را ارسال می‌کند؛ مدل‌های Claude 4.6 به‌صورت پیش‌فرض روی adaptive هستند.

برای هر پیام با /think:<level> یا در پارامترهای مدل بازنویسی کنید:

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

fallback رد ایمنی (Claude Fable 5)

چرا این وجود دارد

دسته‌بندهای Fable 5 برای درخواست‌ها در دامنه‌های محدودشده، stop_reason: "refusal" برمی‌گردانند، و همچنین روی کارهای نزدیک به موارد بی‌خطر (ابزارهای امنیتی، علوم زیستی، یا حتی درخواست از مدل برای بازتولید استدلال خام خودش) مثبت کاذب می‌دهند. بدون fallback، نوبت با خطا از بین می‌رود، هرچند یک مدل Claude دیگر با میل آن را پاسخ می‌داد — پیام رد خود Anthropic به یکپارچه‌سازان API می‌گوید یک مدل fallback پیکربندی کنند.

نحوه کار

1. برای هر درخواست مستقیم با کلید API به anthropic/claude-fable-5، OpenClaw opt-in fallback سمت سرور Anthropic را ارسال می‌کند: هدر بتای server-side-fallback-2026-06-01 به‌همراه fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 تنها هدف fallback است که Anthropic برای Fable 5 اجازه می‌دهد.
2. فقط رد توسط دسته‌بند ایمنی fallback را فعال می‌کند. محدودیت‌های نرخ، بار بیش‌ازحد، و خطاهای سرور دقیقا مانند قبل رفتار می‌کنند و از failover مدل عادی OpenClaw عبور می‌کنند.
3. نجات داخل همان فراخوانی رخ می‌دهد. رد پیش از هر خروجی، جز از نظر تاخیر، نامرئی است؛ کل پاسخ از Opus 4.8 می‌آید. در رد وسط جریان، متن جزئی به‌عنوان پیشوندی نگه داشته می‌شود که مدل fallback از آن ادامه می‌دهد، در حالی که استدلال و فراخوانی‌های ابزار مدل ردشده طبق قوانین بازپخش Anthropic دور ریخته می‌شوند (نباید دوباره بازتاب داده یا اجرا شوند).
4. اگر Claude Opus 4.8 هم رد کند، نوبت رد را به‌صورت خطا نشان می‌دهد، دقیقا مانند پیش از این قابلیت.

fallback در سطح API شرکت Anthropic رخ می‌دهد، بنابراین لازم نیست claude-opus-4-8 در فهرست مدل‌های پیکربندی‌شده یا زنجیره fallback شما باشد — یک کلید API سازگار با Fable همیشه می‌تواند Opus را سرویس دهد.

مشاهده‌پذیری و صورت‌حساب

• نوبتی که با fallback پاسخ داده شده است، یک diagnostic با نام provider_fallback روی پیام دستیار ثبت می‌کند که fromModel و toModel را نام می‌برد، و responseModel پیام، claude-opus-4-8 را گزارش می‌کند.
• Anthropic به‌ازای هر تلاش صورت‌حساب می‌کند: رد پیش از خروجی رایگان است، و نجات با نرخ‌های Claude Opus 4.8 صورت‌حساب می‌شود (در حال حاضر نصف نرخ‌های Fable 5). برآورد هزینه هر نوبت OpenClaw، نوبت‌های پاسخ‌داده‌شده با fallback را با نرخ‌های Opus قیمت‌گذاری می‌کند تا همخوان باشد.
• رد وسط جریان، علاوه بر این، بخش جزئی Fable را که از قبل stream شده روی سمت Anthropic صورت‌حساب می‌کند؛ آن بخش در میزان استفاده هر تلاش API گزارش می‌شود اما در برآورد هر نوبت OpenClaw ادغام نمی‌شود.

دامنه

برای anthropic/claude-fable-5 با احراز هویت کلید API در برابر api.anthropic.com اعمال می‌شود. OAuth (استفاده دوباره از اشتراک Claude CLI)، URLهای پایه پروکسی، Bedrock، Vertex، و درخواست‌های Foundry بدون تغییر هستند و همچنان ردها را در آنجا به‌صورت خطا نشان می‌دهند.

راستی‌آزمایی زنده: یک prompt بی‌خطر که از Fable 5 می‌خواهد زنجیره تفکر خام خود را بازتولید کند، وقتی بدون fallback ارسال شود با category: "reasoning_extraction" رد می‌شود، و همان prompt از طریق OpenClaw یک پاسخ عادی سرویس‌شده توسط Opus با diagnostic پیوست‌شده provider_fallback برمی‌گرداند.

برای رفتار زیربنایی، راهنمای ردها و fallback شرکت Anthropic را ببینید.

cache کردن prompt

OpenClaw از قابلیت cache کردن prompt شرکت Anthropic برای احراز هویت با کلید API پشتیبانی می‌کند.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-6" },      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },    list: [      { id: "research", default: true },      { id: "alerts", params: { cacheRetention: "none" } },    ],  },}

پیکربندی پیشرفته

{  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

عیب‌یابی

مرتبط