---
read_when:
    - می‌خواهید یک پیشنهاد تبلیغاتی رایگان برای مدل را از ClawHub امتحان کنید
    - در حال پیکربندی یک ارائه‌دهنده از طریق یک طرح تشویقی به‌جای فرایند راه‌اندازی اولیه هستید
summary: مرجع CLI برای `openclaw promos` (فهرست‌کردن و دریافت پیشنهادهای تبلیغاتی مدل)
title: تبلیغات ترویجی
x-i18n:
    generated_at: "2026-07-27T14:00:38Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 779eab2e9500b7376fabf9accb333e83ff5f84b085d51b7d551b5507b1e73adb
    source_path: cli/promos.md
    workflow: 16
---

# `openclaw promos`

پیشنهادهای تبلیغاتی مدل منتشرشده در ClawHub را پیدا و دریافت کنید. دریافت یک
پیشنهاد تبلیغاتی، ارائه‌دهنده را پیکربندی می‌کند (احراز هویت و Plugin، در صورت نیاز) و مدل‌های
پیشنهاد را ثبت می‌کند — بدون اجرای دوباره راه‌اندازی اولیه و بدون تغییر
مدل پیش‌فرض شما، مگر اینکه خودتان چنین بخواهید.

مرتبط:

- مدل پیش‌فرض و مدل‌های جایگزین: [مدل‌ها](/fa/cli/models)
- راه‌اندازی احراز هویت ارائه‌دهنده: [شروع به کار](/fa/start/getting-started)

## فرمان‌ها

```bash
openclaw promos list
openclaw promos claim <slug>
openclaw promos claim <slug> --api-key <key> --set-default
```

## `openclaw promos list`

پیشنهادهای تبلیغاتی فعال فعلی را همراه با مدل‌های آن‌ها، گزینه پیش‌فرض پیشنهادی،
زمان باقی‌مانده و فرمان دقیق دریافت فهرست می‌کند. `--json` داده خام
را چاپ می‌کند.

## `openclaw promos claim <slug>`

یک پیشنهاد تبلیغاتی فعال را دریافت می‌کند:

1. پیشنهاد تبلیغاتی را از ClawHub دریافت می‌کند و بررسی می‌کند که در بازه زمانی خود قرار داشته باشد.
2. ارائه‌دهنده، روش احراز هویت و بسته‌های Plugin اعلام‌شده پیشنهاد را
   در برابر نسخه نصب‌شده OpenClaw شما اعتبارسنجی می‌کند. شناسه‌های ناشناخته یا عدم تطابق بسته‌ها
   رد می‌شوند — یک پیشنهاد تبلیغاتی هرگز نمی‌تواند CLI را وادار به اجرای چیزی کند که از قبل
   روش انجام آن را نمی‌داند.
3. اگر اعتبارنامه‌های فعلی ارائه‌دهنده را داشته باشید، دوباره از آن‌ها استفاده می‌کند. در غیر این صورت،
   فرایند عادی احراز هویت ارائه‌دهنده را طی می‌کند (ابتدا URL ثبت‌نام پیشنهاد تبلیغاتی
   را برای دریافت کلید رایگان چاپ می‌کند). `--api-key <key>` احراز هویت با کلید API را بدون
   اعلان‌های تعاملی تکمیل می‌کند و با پرچم‌های غیرتعاملی `openclaw onboard` مطابقت دارد؛ برای اینکه
   کلید در خط فرمان قرار نگیرد، به‌جای آن متغیر محیطی ارائه‌دهنده را
   صادر کنید (برای مثال `OPENROUTER_API_KEY`) — اعتبارنامه‌های موجود در محیط به‌طور
   خودکار شناسایی می‌شوند و نیازی به پرچم نیست.
4. مدل‌های پیشنهاد تبلیغاتی را همراه با نام‌های مستعارشان ثبت می‌کند. نام‌های مستعار موجود
   هرگز بازنویسی نمی‌شوند.
5. پیشنهاد می‌دهد مدل توصیه‌شده پیشنهاد تبلیغاتی به‌عنوان مدل پیش‌فرض شما تنظیم شود —
   `--set-default` این پرسش را رد می‌کند؛ در غیر این صورت، هیچ‌چیز در تنظیمات پیش‌فرض شما
   تغییر نمی‌کند.

وقتی بازه زمانی پیشنهاد تبلیغاتی پایان می‌یابد، ارائه‌دهنده عرضه مدل‌های رایگان را متوقف می‌کند؛
پیکربندی و اعتبارنامه‌های شما دست‌نخورده باقی می‌مانند. هر زمان خواستید با
`openclaw models set <model>` به مدل قبلی برگردید.

## کشف غیرفعال در `models list`

`openclaw models list` همچنین بدون اینکه مستقیماً از ClawHub درخواست کنید، پیشنهادهای تبلیغاتی را نمایش می‌دهد:

- پیشنهادهای فعالی که مدل‌هایشان را پیکربندی نکرده‌اید، در گروه
  «قابل‌دسترسی از طریق پیشنهاد تبلیغاتی» زیر جدول ظاهر می‌شوند و هرکدام فرمان دریافت
  خود را دارند.
- مدل‌هایی که از طریق `promos claim` ثبت کرده‌اید، برچسب `promo` دارند که
  پس از پایان بازه زمانی پیشنهاد به `promo ended` تغییر می‌کند.
- نخستین باری که پیشنهاد جدیدی دیده می‌شود، یک اعلان یک‌باره به
  `openclaw promos list` اشاره می‌کند. پیشنهادهایی که قبلاً فهرست یا دریافت کرده‌اید، هرگز
  دوباره اعلام نمی‌شوند.

این قابلیت یک نسخه ذخیره‌شده محلی از خوراک پیشنهادهای تبلیغاتی میزبانی‌شده ClawHub را می‌خواند
(که معمولاً روزی یک‌بار با یک درخواست مشروط تازه‌سازی می‌شود، یا اگر
تصویر لحظه‌ای ذخیره‌شده منقضی شود، زودتر تازه‌سازی می‌شود؛ شکست‌های تازه‌سازی بدون اطلاع نادیده گرفته می‌شوند). یک
تازه‌سازی نسخه قدیمی حداکثر 2.5 ثانیه منتظر می‌ماند و هرگز فهرست را مختل نمی‌کند. خروجی‌های
`--json` و `--plain` برای پردازش ماشینی پاک باقی می‌مانند: بدون بخش‌ها یا اعلان‌های پیشنهاد تبلیغاتی.
دریافت همیشه دوباره در برابر API زنده ClawHub اعتبارسنجی می‌شود؛ بنابراین پیشنهادی که
زودتر پس گرفته شده باشد، حتی اگر نسخه ذخیره‌شده همچنان آن را نشان دهد، رد می‌شود.