آموزش OpenClaw؛ نصب، اتصال به API هوش مصنوعی و تلگرام

مرحله دوم: ساخت کلید API محدود در پاستا

1. در پنل پاستا صفحه کلیدهای API را باز کنید.
2. یک کلید مستقل با نام OpenClaw بسازید؛ از کلید برنامه production دیگری استفاده نکنید.
3. فقط مدل انتخابی را مجاز کنید و سقف روزانه و Rate Limit متناسب با آزمایش بگذارید.
4. کلید را همان لحظه در Password Manager یا Secret محیط ذخیره کنید؛ مقدار کامل دوباره نمایش داده نمی‌شود.

OpenClaw ممکن است برای یک مأموریت چند درخواست پیاپی بفرستد. محدودیت روزانه پاستا مانع ادامه مصرف خارج از بودجه تعیین‌شده می‌شود و گزارش مصرف ورودی و خروجی را به تومان نشان می‌دهد.

مرحله سوم: اتصال OpenClaw به API هوش مصنوعی پاستا

فایل اصلی تنظیمات در مسیر ~/.openclaw/openclaw.json قرار دارد و JSON5 را می‌پذیرد. مقدار YOUR_MODEL_ID را از کاتالوگ زنده مدل‌ها بردارید:

{
  agents: {
    defaults: { model: { primary: "paasta/YOUR_MODEL_ID" } }
  },
  models: {
    mode: "merge",
    providers: {
      paasta: {
        baseUrl: "https://console.paasta.cloud/api/ai/v1",
        apiKey: "${PAASTA_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "YOUR_MODEL_ID", name: "Paasta model", input: ["text"] }
        ]
      }
    }
  }
}

کلید را داخل فایل Git یا متن قابل اشتراک نگذارید. OpenClaw را از همان محیطی اجرا کنید که متغیر زیر در آن تعریف شده است:

Windows PowerShell

$env:PAASTA_API_KEY="کلید-دریافتی-از-پاستا"
openclaw gateway

macOS و Linux

export PAASTA_API_KEY="کلید-دریافتی-از-پاستا"
openclaw gateway

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

openclaw config validate
openclaw models list
openclaw doctor

مرحله چهارم: اولین تست کنترل‌شده

قبل از اتصال ایمیل، مرورگر یا ابزار Shell، یک درخواست بدون دسترسی حساس اجرا کنید:

قابلیت‌هایی که اکنون در اختیار داری فهرست کن.
هیچ فایل، فرمان یا سرویس بیرونی را تغییر نده.
برای هر اقدام عملی ابتدا از من تأیید بگیر.

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

مرحله پنجم: اتصال امن OpenClaw به تلگرام

1. در تلگرام حساب رسمی @BotFather را باز کنید و با /newbot یک بات بسازید.
2. توکن را در Git، اسکرین‌شات یا چت عمومی قرار ندهید.
3. کانال تلگرام را اضافه کنید: openclaw channels add --channel telegram --token <BOT_TOKEN>.
4. Gateway را restart کنید و یک پیام به بات بفرستید.
5. درخواست را با openclaw pairing list telegram ببینید و فقط کد خودتان را با openclaw pairing approve telegram <CODE> تأیید کنید.

Pairing پیش‌فرض باعث می‌شود پیام فرستنده ناشناس قبل از تأیید شما به مدل نرسد. برای یک Agent دارای ابزار، DM را روی حالت عمومی و allowlist را روی * نگذارید.

امنیت OpenClaw و خطر Prompt Injection

خصوصی‌بودن بات به‌تنهایی کافی نیست. یک صفحه وب، ایمیل، فایل یا متن Pasteشده می‌تواند دستور مخربی داخل خود داشته باشد و مدل را به افشای اطلاعات یا اجرای ابزار ترغیب کند. محتوای بیرونی را ورودی غیرقابل‌اعتماد در نظر بگیرید.

• ابزارهای exec، مرورگر و دسترسی فایل را فقط هنگام نیاز فعال کنید.
• Secretها را خارج از Workspace قابل‌خواندن Agent نگه دارید.
• Skill و Plugin شخص ثالث را مثل کد اجرایی بررسی کنید.
• برای ورودی بیرونی از Sandbox، دسترسی فقط‌خواندنی و تأیید عملیات استفاده کنید.
• پس از هر تغییر تنظیمات، openclaw security audit --deep را اجرا کنید.

راهنمای رسمی نیز تأکید می‌کند یک Gateway مرز اعتماد یک اپراتور یا تیم مورداعتماد است؛ برای کاربران با سطح اعتماد متفاوت، Gateway و Credential جدا بسازید.

رفع خطاهای رایج

مدل پیدا نمی‌شود

مدل سفارشی باید هم در models.providers.paasta.models ثبت شده باشد و هم مسیر پیش‌فرض به‌شکل paasta/MODEL_ID نوشته شود. فقط افزودن نام به تنظیم Agent، Provider را ثبت نمی‌کند.

خطای 401 یا Unauthorized

متغیر PAASTA_API_KEY در محیط Gateway وجود ندارد یا کلید لغو و منقضی شده است. کلید را چاپ نکنید؛ Gateway را از محیط درست restart کنید یا یک کلید تازه بسازید.

خطای 429 یا توقف به‌خاطر بودجه

Rate Limit یا سقف روزانه رسیده است. گزارش مصرف را بررسی کنید، مأموریت را کوچک‌تر کنید و فقط در صورت نیاز سقف را افزایش دهید.

تلگرام پاسخ نمی‌دهد

وضعیت Gateway، Token و درخواست Pairing را بررسی کنید. افزودن کانال بدون restart یا تأییدنکردن کد Pairing از علت‌های رایج است.

چرا API پاستا برای OpenClaw مناسب است؟

OpenClaw به شما اجازه می‌دهد Provider سفارشی سازگار با OpenAI تعریف کنید. پاستا همان قرارداد را با قیمت تومانی، فهرست مدل‌های قابل‌تعویض، کلید جدا برای هر Agent، محدودیت مدل، Rate Limit، انقضا و سقف هزینه ارائه می‌کند.

به این ترتیب لازم نیست یک کلید اصلی و بدون محدودیت را به Agent بدهید. می‌توانید OpenClaw را با بودجه کم شروع کنید، مصرف واقعی هر مأموریت را ببینید و بعد مدل یا سقف را آگاهانه تغییر دهید. جزئیات endpoint و خطاهای API در مستندات API هوش مصنوعی پاستا آمده است.