Providers
Anthropic
Anthropic خانواده مدلهای Claude را میسازد. OpenClaw از دو مسیر احراز هویت پشتیبانی میکند:
- کلید API — دسترسی مستقیم به Anthropic API با صورتحساب مبتنی بر میزان استفاده (مدلهای
anthropic/*) - Claude CLI — استفاده دوباره از ورود Claude CLI موجود روی همان میزبان
شروع به کار
کلید API
بهترین گزینه برای: دسترسی استاندارد API و صورتحساب مبتنی بر میزان استفاده.
کلید API خود را دریافت کنید
یک کلید API در Anthropic Console بسازید.
راهاندازی اولیه را اجرا کنید
openclaw onboard
# choose: Anthropic API key
یا کلید را مستقیما پاس دهید:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
در دسترس بودن مدل را بررسی کنید
openclaw models list --provider anthropic
نمونه پیکربندی
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Claude CLI
بهترین گزینه برای: استفاده دوباره از ورود Claude CLI موجود بدون کلید API جداگانه.
مطمئن شوید Claude CLI نصب شده و وارد شده است
با این دستور بررسی کنید:
claude --version
راهاندازی اولیه را اجرا کنید
openclaw onboard
# choose: Claude CLI
OpenClaw اعتبارنامههای Claude CLI موجود را تشخیص میدهد و دوباره استفاده میکند.
در دسترس بودن مدل را بررسی کنید
openclaw models list --provider anthropic
نمونه پیکربندی
مرجع مدل استاندارد Anthropic را همراه با بازنویسی زمان اجرای CLI ترجیح دهید:
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
مراجع مدل قدیمی claude-cli/claude-opus-4-7 همچنان برای
سازگاری کار میکنند، اما پیکربندی جدید باید انتخاب provider/model را به صورت
anthropic/* نگه دارد و پشتوانه اجرا را در agentRuntime.id قرار دهد.
پیشفرضهای تفکر (Claude 4.6)
مدلهای Claude 4.6 در OpenClaw وقتی سطح تفکر صریحی تنظیم نشده باشد، به طور پیشفرض از تفکر adaptive استفاده میکنند.
برای هر پیام با /think:<level> یا در پارامترهای مدل بازنویسی کنید:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
کشکردن پرامپت
OpenClaw از قابلیت کشکردن پرامپت Anthropic برای احراز هویت با کلید API پشتیبانی میکند.
| مقدار | مدت کش | توضیح |
|---|---|---|
"short" (پیشفرض) |
۵ دقیقه | برای احراز هویت با کلید API به طور خودکار اعمال میشود |
"long" |
۱ ساعت | کش گسترشیافته |
"none" |
بدون کش | کشکردن پرامپت را غیرفعال میکند |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
بازنویسیهای کش برای هر عامل
از پارامترهای سطح مدل به عنوان مبنای خود استفاده کنید، سپس عاملهای مشخص را از طریق agents.list[].params بازنویسی کنید:
{
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["provider/model"].paramsagents.list[].params(idمنطبق، بازنویسی بر اساس کلید)
این امکان را میدهد که یک عامل کش بلندمدت را نگه دارد، در حالی که عامل دیگری روی همان مدل کش را برای ترافیک جهشی یا با استفاده دوباره کم غیرفعال کند.
نکتههای Bedrock Claude
- مدلهای Anthropic Claude روی Bedrock (
amazon-bedrock/*anthropic.claude*) وقتی پیکربندی شده باشند، عبور مستقیمcacheRetentionرا میپذیرند. - مدلهای غیر Anthropic در Bedrock در زمان اجرا به
cacheRetention: "none"مجبور میشوند. - پیشفرضهای هوشمند کلید API همچنین برای مراجع Claude-on-Bedrock وقتی مقدار صریحی تنظیم نشده باشد،
cacheRetention: "short"را مقداردهی اولیه میکنند.
پیکربندی پیشرفته
حالت سریع
کلید مشترک /fast در OpenClaw از ترافیک مستقیم Anthropic پشتیبانی میکند (کلید API و OAuth به api.anthropic.com).
| دستور | نگاشت میشود به |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{
agents: {
defaults: {
models: {
"anthropic/claude-sonnet-4-6": {
params: { fastMode: true },
},
},
},
},
}
درک رسانه (تصویر و PDF)
Plugin همراه Anthropic درک تصویر و PDF را ثبت میکند. OpenClaw قابلیتهای رسانه را از احراز هویت پیکربندیشده Anthropic به طور خودکار حل میکند؛ پیکربندی اضافهای لازم نیست.
| ویژگی | مقدار |
|---|---|
| مدل پیشفرض | claude-opus-4-7 |
| ورودی پشتیبانیشده | تصاویر، اسناد PDF |
وقتی تصویر یا PDF به یک گفتوگو پیوست شود، OpenClaw آن را به طور خودکار از طریق فراهمکننده درک رسانه Anthropic مسیریابی میکند.
پنجره زمینه 1M (بتا)
پنجره زمینه 1M در Anthropic پشت دروازه بتا است. آن را برای هر مدل فعال کنید:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { context1m: true },
},
},
},
},
}
OpenClaw این را در درخواستها به anthropic-beta: context-1m-2025-08-07 نگاشت میکند.
params.context1m: true همچنین برای پشتوانه Claude CLI
(claude-cli/*) در مدلهای واجد شرایط Opus و Sonnet اعمال میشود و پنجره زمینه
زمان اجرا را برای آن نشستهای CLI گسترش میدهد تا با رفتار API مستقیم منطبق شود.
زمینه 1M در Claude Opus 4.7
anthropic/claude-opus-4.7 و نوع claude-cli آن به طور پیشفرض پنجره زمینه 1M
دارند — نیازی به params.context1m: true نیست.
عیبیابی
خطاهای 401 / توکن ناگهان نامعتبر شد
احراز هویت توکن Anthropic منقضی میشود و میتواند باطل شود. برای راهاندازیهای جدید، به جای آن از کلید Anthropic API استفاده کنید.
هیچ کلید API برای provider "anthropic" پیدا نشد
احراز هویت Anthropic برای هر عامل جداگانه است — عاملهای جدید کلیدهای عامل اصلی را به ارث نمیبرند. راهاندازی اولیه را برای آن عامل دوباره اجرا کنید (یا یک کلید API را روی میزبان Gateway پیکربندی کنید)، سپس با openclaw models status بررسی کنید.
هیچ اعتبارنامهای برای پروفایل "anthropic:default" پیدا نشد
openclaw models status را اجرا کنید تا ببینید کدام پروفایل احراز هویت فعال است. راهاندازی اولیه را دوباره اجرا کنید، یا یک کلید API برای مسیر آن پروفایل پیکربندی کنید.
هیچ پروفایل احراز هویت در دسترسی نیست (همه در دوره cooldown هستند)
openclaw models status --json را برای auth.unusableProfiles بررسی کنید. دورههای cooldown محدودیت نرخ Anthropic میتوانند محدود به مدل باشند، بنابراین یک مدل Anthropic همخانواده ممکن است همچنان قابل استفاده باشد. یک پروفایل Anthropic دیگر اضافه کنید یا تا پایان cooldown صبر کنید.