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

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

3. ایجاد ربات QQ خود

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

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

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

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

5. ابتدا پیکربندی مدل را انجام دهید

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 خود تبدیل کنید. پس از آن، چه برای دستیار شخصی، پردازش فایل، پرسش و پاسخ متنی و تصویری، یا یادآوریهای زمانبندی شده، همه بر اساس این پایه گسترش مییابند.
