OpenClaw: ایجنت روی کامپیوتر خودتان

اگر می‌خواهید کاری را به ایجنت بسپارید و سراغ کار دیگری بروید، اینجا راه‌اندازی‌اش را یاد می‌گیرید و اینکه خرجش از دستتان در نرود.

۱۰ دقیقهدرس ۶ از ۸۰ از ۳ قدم

OpenClaw هم ایجنتی متن‌باز است که دیگران ساخته‌اند. روی سیستم خودتان اجرا می‌شود، پنل وب خودش را دارد و کار را تا آخر پیش می‌برد. با کلید ir- روی ایران‌روتر کار می‌کند و هزینه‌اش از همان کیف پول کم می‌شود.

نصب

Node.js نسخهٔ ۲۴٫۱۶ یا بالاتر لازم است. نسخهٔ نصب‌شده را با node --version ببینید. بعد در Linux یا macOS:

Shell
curl -fsSL https://openclaw.ai/install.sh | bash

نصب‌کننده یک ویزارد راه‌اندازی را باز می‌کند. هر چه را بپرسد می‌توانید بعداً عوض کنید؛ تنظیم مدل را در قدم بعد با فایل انجام می‌دهیم.

وصل کردن به ایران‌روتر

برای OpenClaw آن دو متغیر همیشگی کافی نیست. مدل پیش‌فرضش gpt-6-astra است و بدون پیشوند فرستاده می‌شود، پس خطای ۴۰۴ می‌گیرد. باید ایران‌روتر را در ~/.openclaw/openclaw.json به‌عنوان یک provider تعریف کنید، در primary مدل را به شکل iranrouter/ و بعد شناسهٔ کامل بنویسید و هر مدل را با شناسهٔ کاملش در فهرست بیاورید:

JSON
{
  "agents": { "defaults": { "model": { "primary": "iranrouter/anthropic/claude-sonnet-5" } } },
  "models": {
    "providers": {
      "iranrouter": {
        "baseUrl": "https://iranrouter.com/v1",
        "apiKey": "ir-...",
        "api": "openai-completions",
        "models": [{ "id": "anthropic/claude-sonnet-5", "name": "Claude Sonnet 5", "contextWindow": 1000000, "maxTokens": 8000 }]
      }
    }
  }
}

مراقب کلیدتان باشید. حافظهٔ OpenClaw برای embedding به‌طور پیش‌فرض سراغ api.openai.com می‌رود. اگر یکی از دو تنظیم زیر را نگذارید، کلید ir- شما برای آن سرویس فرستاده می‌شود. راه اول: embedding را هم از ایران‌روتر بگیرید. این بخش را به همان فایل اضافه کنید و شناسهٔ یک مدل embedding فعال را از صفحهٔ مدل‌ها بردارید:

JSON
{
  "memory": {
    "search": {
      "provider": "openai-compatible",
      "model": "openai/text-embedding-3-small",
      "remote": { "baseUrl": "https://iranrouter.com/v1", "apiKey": "ir-..." }
    }
  }
}

راه دوم: اگر مدل embedding فعالی پیدا نکردید یا جست‌وجو در حافظه را نمی‌خواهید، خاموشش کنید:

JSON
{ "memory": { "search": { "enabled": false } } }

عددهای contextWindow و maxTokens را از صفحهٔ همان مدل بردارید. بعد از ذخیرهٔ فایل، gateway را دوباره راه بیندازید و داشبورد را باز کنید:

Shell
openclaw gateway restart
openclaw dashboard

در چت داشبورد یک پیام بنویسید. جواب که آمد، در «مصرف و لاگ‌ها» همان درخواست را با نام مدل ببینید.

پیش از اینکه ایجنت را به حال خودش بگذارید

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

  1. برای هر ایجنت یک کلید جدا بسازید تا اگر لازم شد یکی را ببندید، بقیه از کار نیفتند.
  2. روی همان کلید سقف روزانه بگذارید. سقف یعنی حتی اگر کد اشتباه کند، خرج از عدد شما بالاتر نمی‌رود.

ایجنت خوب پیش از هر کار سنگین می‌پرسد چقدر از سقفش مانده است.

برای همین مسیر GET /v1/key هست: سقف‌ها، مصرف جاری و باقی‌مانده را برمی‌گرداند.

Shell
curl https://iranrouter.com/v1/key -H "Authorization: Bearer ir-..."

یک کار کوچک به آن بسپارید۰ از ۳ قدم

  1. OpenClaw را با کلید جدا و سقف روزانه راه بیندازید.
  2. یک کار کوچک به آن بدهید، مثلاً خلاصه کردن یک پوشه از فایل‌های متنی.
  3. در تب «نشست‌ها» ببینید این کار چند درخواست زد و چقدر خرج داشت.

خلاصهٔ درس

  • OpenClaw با فایل openclaw.json و شناسهٔ کامل مدل به ایران‌روتر وصل می‌شود.
  • embedding حافظه را به ایران‌روتر وصل یا خاموش کنید، وگرنه کلیدتان به سرویس دیگری می‌رود.
  • هر ایجنت کلید جدا و سقف روزانهٔ خودش را می‌خواهد.
  • GET /v1/key ظرفیت باقی‌مانده را می‌گوید.
پریست و فایلچرا برای عوض کردن مدل یا تنظیمات کد را دست بزنید، وقتی از پنل هم می‌شود؟تمام کردم، درس بعد