آشا آشا AI Gateway
ورود شروع رایگان

OpenClaw

پلتفرم عامل هوش مصنوعیِ چندکانالهٔ متن‌باز را به درگاه آشا وصل کنید؛ با پشتیبانی از Telegram، Discord، Slack، Signal، iMessage و WhatsApp.

OpenClaw (در گذشته Moltbot و Clawdbot) یک پلتفرم عامل هوش مصنوعی متن‌باز است که هوش مصنوعی گفتگویی را به چند کانال پیام‌رسانی از جمله Telegram، Discord، Slack، Signal، iMessage و WhatsApp می‌آورد. از چند ارائه‌دهندهٔ LLM پشتیبانی می‌کند و به شما اجازه می‌دهد عامل‌های هوش مصنوعی را اجرا کنید که می‌توانند در همهٔ این پلتفرم‌ها تعامل داشته باشند.

چرا باید OpenClaw را به آشا وصل کنیم؟

دسترسی چندمدلی با یک کلید

به‌جای مدیریت کلید جداگانه برای هر ارائه‌دهنده، همهٔ مدل‌های آشا را با یک کلید API واحد در اختیار عامل‌های خود بگذارید.

جابه‌جایی خودکار پروایدر برای دسترس‌پذیری بالا

اگر ارائه‌ای در دسترس نباشد یا محدودیت نرخ داشته باشد، آشا درخواست را به پروایدر دیگری هدایت می‌کند و عامل‌ها بدون وقفه به کارشان ادامه می‌دهند.

کنترل بودجه و مصرف

هزینهٔ همهٔ عامل‌ها از کیف پول آشا کسر و در داشبورد فعالیت لحظه‌ای نمایش داده می‌شود؛ ببینید هر کانال یا هر عامل بیشترین مصرف را از کدام مدل دارد.

تنظیم

پیشنهادی: استفاده از جادوگر راه‌اندازی OpenClaw

ساده‌ترین راه تنظیم OpenClaw با آشا، استفاده از جادوگر راه‌اندازی داخلی است:

Bash Terminal 
openclaw onboard

جادوگر شما را راهنمایی می‌کند:

  1. Asha را به‌عنوان پروایدر انتخاب کنید.
  2. کلید API خود را وارد کنید.
  3. مدل موردنظرتان را برگزینید.
  4. کانال‌های پیام‌رسانی را پیکربندی کنید.

این روش برای کاربران تازه‌کار پیشنهاد می‌شود و مطمئن می‌شود همه‌چیز درست پیکربندی شده است.

شروع سریع (CLI)

اگر کلید API آشا را دارید و می‌خواهید از جادوگر رد شوید، از این دستور یک‌خطی استفاده کنید:

Bash Terminal 
openclaw onboard --auth-choice apiKey --token-provider asha --token "$ASHA_API_KEY"

این دستور OpenClaw را به‌صورت خودکار برای استفاده از آشا پیکربندی می‌کند.

پیکربندی دستی

!

فقط کاربران پیشرفته: پیکربندی دستی زیر برای کاربرانی است که می‌خواهند فایل تنظیمات را مستقیم ویرایش کنند. برای بیشتر کاربران، استفاده از جادوگر راه‌اندازی بالا را پیشنهاد می‌کنیم.

اگر نیاز به ویرایش دستی فایل پیکربندی OpenClaw دارید، این گام‌ها را دنبال کنید:

گام ۱ — دریافت کلید API آشا

  1. در داشبورد آشا ثبت‌نام یا وارد شوید.
  2. به صفحهٔ کلیدهای API بروید.
  3. یک کلید API جدید بسازید.
  4. کلید را کپی کنید (با sk-asha-... شروع می‌شود).

گام ۲ — تنظیم کلید API

کلید API آشا را به ~/.openclaw/openclaw.json اضافه کنید:

JSON ~/.openclaw/openclaw.json 
{
  "env": {
    "ASHA_API_KEY": "sk-asha-..."
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "asha/~anthropic/claude-sonnet-latest"
      },
      "models": {
        "asha/~anthropic/claude-sonnet-latest": {}
      }
    }
  }
}

یا آن را به‌عنوان متغیر محیطی در فایل پوستهٔ خود تنظیم کنید:

Bash ~/.zshrc 
export ASHA_API_KEY="sk-asha-..."
ن

تمام شد! OpenClaw پشتیبانی داخلی از آشا دارد. نیازی به پیکربندی models.providers نیست؛ فقط کلید API را تنظیم کنید و مدل‌ها را با قالب asha/<author>/<slug> صدا بزنید.

گام ۳ — انتخاب مدل

مدل primary را به‌روزرسانی کنید و آن را به فهرست models اضافه کنید. چند گزینهٔ محبوب:

Anthropic Claude:

JSON ~/.openclaw/openclaw.json 
"model": {
  "primary": "asha/~anthropic/claude-sonnet-latest"
},
"models": {
  "asha/~anthropic/claude-sonnet-latest": {}
}

OpenAI (آخرین نسخه):

JSON ~/.openclaw/openclaw.json 
"model": {
  "primary": "asha/~openai/gpt-latest"
},
"models": {
  "asha/~openai/gpt-latest": {}
}

OpenAI (نسخهٔ سنجاق‌شده):

JSON ~/.openclaw/openclaw.json 
"model": {
  "primary": "asha/openai/gpt-4o"
},
"models": {
  "asha/openai/gpt-4o": {}
}

همهٔ مدل‌های در دسترس را در فهرست مدل‌های آشا ببینید.

گام ۴ — شروع OpenClaw

پس از به‌روزرسانی پیکربندی، OpenClaw را اجرا یا دوباره اجرا کنید:

Bash Terminal 
openclaw gateway run

عامل‌های شما حالا از آشا برای مسیردهی درخواست‌ها به مدل انتخابی استفاده می‌کنند.

قالب مدل

OpenClaw برای مدل‌های آشا از قالب asha/<author>/<slug> استفاده می‌کند (برای دنبال‌کردن آخرین نسخهٔ هر خانواده، نویسنده را با ~ پیشوند کنید). برای مثال:

  • asha/~anthropic/claude-sonnet-latest
  • asha/~openai/gpt-latest
  • asha/~anthropic/claude-opus-latest
  • asha/openai/gpt-4o

قالب دقیق هر مدل را در فهرست مدل‌های آشا پیدا می‌کنید.

چند مدل با مدل‌های جایگزین (Fallback)

OpenClaw از fallback پشتیبانی می‌کند. اگر مدل اصلی در دسترس نبود، به‌ترتیب مدل‌های جایگزین را امتحان می‌کند:

JSON ~/.openclaw/openclaw.json 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "asha/~anthropic/claude-sonnet-latest",
        "fallbacks": [
          "asha/~anthropic/claude-haiku-latest"
        ]
      },
      "models": {
        "asha/~anthropic/claude-sonnet-latest": {},
        "asha/~anthropic/claude-haiku-latest": {}
      }
    }
  }
}

این یک لایهٔ اطمینان اضافه بر جابه‌جایی پروایدر در سطح آشا فراهم می‌کند.

استفاده از پروفایل‌های احراز هویت

برای مدیریت امن‌تر اعتبارنامه، به‌جای متغیرهای محیطی می‌توانید از پروفایل‌های احراز هویت OpenClaw استفاده کنید. وقتی از دستور openclaw onboard استفاده کنید این به‌صورت خودکار پیکربندی می‌شود.

برای ساخت دستی یک پروفایل احراز هویت، این را به openclaw.json اضافه کنید:

JSON ~/.openclaw/openclaw.json 
{
  "auth": {
    "profiles": {
      "asha:default": {
        "provider": "asha",
        "mode": "api_key"
      }
    }
  }
}

سپس با CLI اوپن‌کلاو کلید را در keychain سیستم تنظیم کنید:

Bash Terminal 
openclaw auth set asha:default --key "$ASHA_API_KEY"

این‌طور کلید API از فایل پیکربندی خارج می‌ماند و به‌صورت امن در keychain سیستم ذخیره می‌شود.

پایش مصرف

مصرف OpenClaw را لحظه‌ای دنبال کنید:

  1. داشبورد فعالیت آشا را باز کنید.
  2. درخواست‌ها، هزینه‌ها و مصرف توکن همهٔ عامل‌های OpenClaw را ببینید.
  3. بر اساس مدل، بازهٔ زمانی یا معیارهای دیگر فیلتر کنید.
  4. داده‌های مصرف را برای صورتحساب یا تحلیل خروجی بگیرید.

خطاهای رایج

«No API key found for provider ‘asha’»

OpenClaw نمی‌تواند کلید API آشا را پیدا کند. رفع اشکال:

  1. مطمئن شوید متغیر محیطی ASHA_API_KEY تنظیم شده است: echo $ASHA_API_KEY
  2. یا وجود پروفایل احراز هویت را بررسی کنید: openclaw auth list
  3. یا دستور onboard را اجرا کنید: openclaw onboard --auth-choice apiKey --token-provider asha --token "$ASHA_API_KEY"

خطاهای احراز هویت (401/403)

  1. معتبر بودن کلید API را در صفحهٔ کلیدهای API داشبورد آشا بررسی کنید.
  2. مطمئن شوید در کیف پول حساب‌تان اعتبار کافی دارید.
  3. مطمئن شوید کلید منقضی یا لغو نشده است.

مدل کار نمی‌کند

  1. شناسهٔ مدل را در فهرست مدل‌های آشا بررسی کنید.
  2. از قالب asha/<author>/<slug> استفاده کنید و برای آخرین نسخهٔ خانواده، نویسنده را با ~ پیشوند کنید (مثل asha/~anthropic/claude-sonnet-latest).
  3. مدل را به agents.defaults.models در پیکربندی خود اضافه کنید.

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

مدل‌های جداگانه برای هر کانال

برای کانال‌های مختلف پیام‌رسانی، مدل‌های متفاوتی پیکربندی کنید:

JSON ~/.openclaw/openclaw.json 
{
  "telegram": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "asha/~anthropic/claude-sonnet-latest"
        }
      }
    }
  },
  "discord": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "asha/~openai/gpt-latest"
        }
      }
    }
  }
}

منابع