راهنمای استفاده از GapGPT در OpenClaw

OpenClaw یک Gateway و دستیار عامل‌محور است که می‌تواند کانال‌ها، ابزارها، حافظه و مدل را در یک پیکربندی واحد مدیریت کند. در این راهنما، OpenClaw را به endpoint سازگار با OpenAI گپ‌جی‌پی‌تی وصل می‌کنیم.

این راهنما از custom provider در OpenClaw استفاده می‌کند. برای جلوگیری از لو رفتن کلید، مقدار کلید در متغیر محیطی قرار می‌گیرد و فقط نام آن در openclaw.json نوشته می‌شود.

۱. پیش‌نیازها

۲. نصب OpenClaw

macOS، Linux و WSL2:

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

Windows PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

بعد از نصب، ویزارد اولیه را اجرا کنید:

openclaw onboard

اگر در ویزارد provider پیش‌فرضی انتخاب کردید، بعداً می‌توانید provider گپ‌جی‌پی‌تی را با پیکربندی زیر اضافه کنید.

۳. تعریف provider گپ‌جی‌پی‌تی

کلید را در محیط اجرای OpenClaw تعریف کنید:

export GAPGPT_API_KEY="YOUR_GAPGPT_API_KEY"

برای ماندگارشدن در macOS یا Linux، این خط را در ~/.zshrc یا ~/.bashrc قرار دهید و سپس shell را reload کنید:

export GAPGPT_API_KEY="YOUR_GAPGPT_API_KEY"

در Windows PowerShell:

$env:GAPGPT_API_KEY = "YOUR_GAPGPT_API_KEY"

سپس در openclaw.json، بخش models و مدل پیش‌فرض agent را اضافه کنید. محل فایل را از تنظیمات نصب خود OpenClaw بردارید؛ معمولاً فایل اصلی در ~/.openclaw/openclaw.json است.

{
  models: {
    mode: "merge",
    providers: {
      gapgpt: {
        baseUrl: "https://api.gapgpt.app/v1",
        apiKey: "${GAPGPT_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.6-sol",
            name: "GPT-5.6 Sol",
            input: ["text"]
          }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "gapgpt/gpt-5.6-sol"
      },
      models: {
        "gapgpt/gpt-5.6-sol": {}
      }
    }
  }
}

در این تنظیمات:

اگر مدل دیگری می‌خواهید، مقدار id و primary را هم‌زمان با شناسه‌ی دقیق آن عوض کنید. برای چند مدل، مدل‌های دیگر را به آرایه‌ی models اضافه کنید و برای هرکدام مسیر gapgpt/<model-id> را در allowlist قرار دهید.

۴. انتخاب و تست مدل

بعد از ذخیره‌ی پیکربندی، مدل provider را بررسی کنید:

openclaw models list --provider gapgpt
openclaw models set gapgpt/gpt-5.6-sol

سپس یک درخواست کوتاه از رابط یا channel فعال OpenClaw بفرستید. برای تست مستقیم endpoint هم می‌توانید از این فرمان استفاده کنید:

curl https://api.gapgpt.app/v1/chat/completions \
  -H "Authorization: Bearer $GAPGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "سلام! خودت را در یک جمله معرفی کن."}]
  }'

۵. استفاده از ابزارها و کانال‌ها

OpenClaw مدل را برای تصمیم‌گیری agent استفاده می‌کند، اما کانال‌ها و ابزارها در Gateway خود OpenClaw اجرا می‌شوند. بعد از موفقیت تست مدل، می‌توانید:

۶. نکات مهم درباره‌ی tool calling

۷. مدیریت هزینه و امنیت

۸. عیب‌یابی سریع

مدل در فهرست OpenClaw دیده نمی‌شود

خطای 401

خطای ابزار یا پاسخ نامعتبر

۹. منابع بیشتر