اگر شما قبلاً OpenClaw را روی سرور ابری مستقر کردهاید، فرآیند کلی اتصال به QQ واقعاً پیچیده نیست: ابتدا به پلتفرم باز QQ بروید و یک ربات QQ ایجاد کنید، سپس AppID 和 AppSecret، دوباره به پنل مدیریت OpenClaw در ابر برگردید تا پیکربندی مدل و کانال را تکمیل کنید، و در نهایت در QQ بررسی کنید که آیا ربات میتواند به طور عادی پاسخ دهد یا خیر. این روش دسترسی Tencent Cloud از طریق پنل بصری است و نیازی به اجرای دستورات بومی اضافی ندارد.
1. پیش از آغاز، این چند چیز را آماده کنید
پیش از آغاز عملیات رسمی، ابتدا تأیید کنید که شما شرایط زیر را دارید:
- یک حساب QQ با احراز هویت واقعی تکمیل شده است.
- پیش از این در سرور برنامه سبک Lighthouse، OpenClaw را مستقر کردهام.
- اگر نمونه OpenClaw شما در نسخه قدیمیتر ایجاد شده است، بهتر است ابتدا آن را به نسخه جدیدتر برنامه بهروزرسانی کنید و سپس پیکربندی را ادامه دهید.
- اگر قصد دارید برای مدت طولانی از کانال QQ استفاده کنید، اولویت را به سرورهای داخلی و خدمات مدلی که به طور پایدار قابل فراخوانی هستند، بدهید.
2. ثبت نام و ورود به پلتفرم باز QQ

اول برو داخل پلتفرم باز کیکیو, با اپلیکیشن موبایل QQ کد QR را اسکن کنید تا وارد شوید. اگر قبلاً ثبتنام نکردهاید، پس از اسکن کد و اعطای مجوز، پلتفرم بهطور خودکار فرایند ثبتنام را برای شما تکمیل کرده و حساب QQ فعلی شما را به پلتفرم باز متصل میکند. پس از انجام این کار، به صفحه مدیریت ربات QQ هدایت خواهید شد.

3. د خپل QQ روبات جوړول

داخل صفحه ربات QQ، روی “ایجاد ربات” کلیک کنید و طبق راهنمای صفحه یک ربات جدید بسازید. پس از ایجاد، سیستم دو پارامتر بسیار حیاتی تولید خواهد کرد:
AppIDAppSecret

دواړه ارزښتونه فوراً کاپي او خوندي کړئ، وروسته د OpenClaw تنظیم کولو لپاره باید کارول شي. دلته په ځانګړې توګه پاملرنه وکړئ،AppSecret دلایل امنیتی معمولاً برای مدت طولانی به صورت متن ساده نمایش داده نمیشود و ممکن است هنگام مشاهده بعدی نیاز به تنظیم مجدد داشته باشد، بنابراین در اولین بار باید به درستی ذخیره شود.

پس از ایجاد، شما معمولاً میتوانید این ربات را در فهرست پیامهای کلاینت QQ مشاهده کنید. با این حال، در این مرحله معمولاً هنوز نمیتواند به درستی کار کند، زیرا فقط “ایجاد شده” است و هنوز به طور واقعی به نمونه OpenClaw شما متصل نشده است. در متن اصلی ذکر شده است که اگر پیکربندی ابری هنوز تکمیل نشده باشد، ممکن است هنگام گفتگو با ربات، پیامی مانند “این ربات به مریخ رفته است، لطفاً بعداً دوباره امتحان کنید” مشاهده کنید.

4. به صفحه مدیریت OpenClaw وارد شوید
بعد از آن به کنسول Tencent Cloud برگردید، نمونه Lighthouse که OpenClaw را در آن مستقر کردهاید پیدا کنید، وارد جزئیات نمونه شوید، سپس به صفحه “مدیریت برنامه” بروید. تنظیمات مدل و تنظیمات کانال QQ بعداً در اینجا انجام میشود.

۵. نخست مدل را تنظیم کنید

QQ تنها درگاه ورود و خروج پیامهاست، آنچه واقعاً مسئول درک و پاسخ به محتواست، مدلی است که برای OpenClaw پیکربندی کردهاید. بنابراین قبل از اتصال QQ، مطمئن شوید که کلید API مدل به درستی پر شده و خود مدل نیز قابل فراخوانی است.

این نکته بسیار مهم است، زیرا بسیاری از مردم فکر میکنند که “عدم پاسخ QQ” به دلیل تنظیم نادرست کانال است، در حالی که در واقع یکی از دلایل رایجتر، عدم اتصال صحیح مدل، اشتباه در وارد کردن کلید، یا عدم دسترسی به سرویس مدل است. متن اصلی نیز به طور ویژه تأکید کرده است که پیکربندی مدل یک مرحله ضروری است.د مودلونو وګورئ د مودلونو د ثبت پته。
6. تنظیم کانال QQ
پس از تایید مدل، تنظیمات کانال را انجام دهید.
در صفحه “مدیریت برنامهها” پیدا کنید Channel منطقه تنظیمات، یک کانال QQ جدید اضافه کنید، سپس آنچه را که قبلاً ذخیره کردید AppID 和 AppSecret داخل آن بنویسید، تنظیمات را ذخیره و اعمال کنید. پس از پردازش سیستم، اگر صفحه "ذخیره موفقیتآمیز" را نشان دهد، به این معنی است که کانال QQ رسماً به OpenClaw متصل شده است.

اگر در این مرحله پارامترها را اشتباه پر کنید، معمولاً پس از بازگشت به QQ، ربات همچنان قادر به پاسخگویی عادی نخواهد بود یا وضعیت غیرعادی را نشان میدهد. بنابراین در صورت شکست، اولین کاری که باید انجام دهید این است که بررسی کنید آیا این دو مقدار به درستی کپی شدهاند، آیا چیزی جا افتاده است یا آیا Secret قدیمی وارد شده است.
7. به QQ برگردید تا بررسی کنید که آیا اتصال موفقیتآمیز بوده است
پس از تکمیل پیکربندی مدل و تنظیم کانال QQ، میتوانید به QQ موبایل یا نسخه کامپیوتری QQ بازگردید و مستقیماً پیامهایی را به ربات ارسال کنید تا آزمایش شود. تا زمانی که بتواند مانند یک دستیار هوش مصنوعی به طور عادی درک کند و پاسخ دهد، نشان میدهد که کل زنجیره راهاندازی شده است.

اینجا یک جزئیات وجود دارد که باید به آن توجه کرد: توصیه نمیشود که این ربات QQ را مستقیماً به گروه اضافه کنید تا با آن تعامل داشته باشید، حداقل در شرایط فعلی، اولویت دادن به تست و استفاده از طریق چت خصوصی امنتر خواهد بود.
8. پس از اتصال موفقیتآمیز چه کاری میتوانید انجام دهید
پس از اتصال به QQ، ربات تنها قادر به ارسال و دریافت متن معمولی نیست. دامنه تواناییهای ارائه شده در متن اصلی نیز شامل موارد زیر است:
- دریافت متن
- دریافت تصویر
- دریافت فایل
- متن پاسخ
- تصویر پاسخ
- پاسخ با فرمت Markdown
- ارسال پیام فعال
- پیام صوتی
- فایل پاسخ
با این حال، “ارجاع به پیامهای تاریخی” در حال حاضر پشتیبانی نمیشود.
یک یادآوری کلیدی دیگر این است: QQ فقط یک کانال است، اینکه آیا واقعاً میتوانید تصاویر را تشخیص دهید، تصاویر تولید کنید یا فایلها را پردازش کنید، هنوز به توانایی مدل پشت سر شما بستگی دارد.

مثلاً اگر میخواهید ربات تصاویر را ببیند، باید مدلهایی را برای OpenClaw پیکربندی کنید که از درک بصری پشتیبانی میکنند؛ اگر میخواهید تصاویر تولید کند، باید مدلهایی را متصل کنید که از تولید تصویر پشتیبانی میکنند.

9. دو نوع از رایجترین مشکلات
9.1. روبات پیغام غیرعادی میدهد، قادر به گفتگو نیست.
اگر روبات جوابی مانند “به مریخ رفتهام، بعداً دوباره امتحان کنید” بدهد، اول دو مورد زیر را بررسی کنید:
- آیا اساساً در OpenClaw ربات QQ را پر نکردهاید؟
AppID和AppSecret - آیا اشتباه وارد شده است؟
AppID或AppSecret
9.2. به نظر میرسد که اتصال برقرار شده است، اما ربات پیامی را بازنمیگرداند
این حالت معمولاً مشکل خود کانال QQ نیست، بلکه ناشی از تنظیمات غیرعادی مدل است. به عنوان مثال، اگر کلید API به درستی تنظیم نشده باشد، مدل در دسترس نباشد یا فراخوانی مدل با شکست مواجه شود، ممکن است ربات پیام را دریافت کند اما نتواند پاسخ دهد. راه حل این است که به صفحه تنظیمات مدل OpenClaw برگردید و وضعیت اتصال مدل را دوباره بررسی کنید.
10. خلاصه
اتصال OpenClaw به QQ، در چهار مرحله اصلی است:
- استقرار OpenClaw
- ایجاد ربات در پلتفرم باز QQ
- ذخیره کردن
AppID和AppSecret - در پنل ابری، پیکربندی مدل و پیکربندی کانال QQ را تکمیل کنید
فقط کافی است این چهار مرحله را درست انجام دهید، اساساً میتوانید ربات QQ را به درگاه گفتگوی OpenClaw خود تبدیل کنید. بعداً، چه برای دستیار شخصی، پردازش فایل، پرسش و پاسخ تصویری یا یادآوری زمانبندی شده، همه بر اساس این پایه گسترش مییابند.
