---
read_when:
    - می‌خواهید یک پیشنهاد تبلیغاتی رایگان برای مدل را از ClawHub امتحان کنید
    - شما به‌جای راه‌اندازی اولیه، در حال پیکربندی یک ارائه‌دهنده از طریق یک طرح تبلیغاتی هستید
summary: مرجع CLI برای `openclaw promos` (فهرست‌کردن و دریافت پیشنهادهای تبلیغاتی مدل)
title: تبلیغات
x-i18n:
    generated_at: "2026-07-12T09:53:34Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    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. اگر اعتبارنامه‌های ارائه‌دهنده را از قبل داشته باشید، از آن‌ها دوباره استفاده می‌کند. در غیر این صورت، فرایند عادی احراز هویت ارائه‌دهنده را طی می‌کند (ابتدا نشانی ثبت‌نام پیشنهاد برای دریافت کلید رایگان را چاپ می‌کند). `--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 را می‌خواند (که معمولاً روزی یک‌بار با یک درخواست مشروط، یا در صورت انقضای زودتر نسخه ذخیره‌شده، به‌روزرسانی می‌شود؛ شکست در به‌روزرسانی بدون نمایش خطا نادیده گرفته می‌شود). به‌روزرسانی داده منقضی‌شده حداکثر ۲٫۵ ثانیه منتظر می‌ماند و هرگز فهرست‌کردن را مختل نمی‌کند. خروجی `--json` و `--plain` برای پردازش ماشینی پاک باقی می‌ماند: بدون بخش‌ها یا اعلان‌های تبلیغاتی. هنگام دریافت، همیشه اعتبار پیشنهاد دوباره از طریق API زنده ClawHub بررسی می‌شود؛ بنابراین پیشنهادی که زودتر از موعد پس گرفته شده باشد، حتی اگر نسخه ذخیره‌شده همچنان آن را نشان دهد، رد می‌شود.