راهنمای کامل اتصال ربات QQ به Tencent Cloud OpenClaw: از صفر تا گفتگو

اگر قبلاً OpenClaw را روی سرور ابری مستقر کردهاید، فرآیند کلی اتصال به QQ چندان پیچیده نیست: ابتدا به پلتفرم باز QQ بروید و یک ربات QQ ایجاد کنید، سپس AppID 和 AppSecret، سپس به پنل مدیریت OpenClaw در ابر بازگردید تا پیکربندی مدل و کانال را تکمیل کنید، و در نهایت در QQ بررسی کنید که آیا ربات می‌تواند به درستی پاسخ دهد یا خیر. این روش دسترسی Tencent Cloud از طریق پنل بصری است و نیازی به اجرای دستورات بومی اضافی ندارد.

با پیکربندی خسته‌کننده خداحافظی کنید: راهنمای استقرار یک‌کلیکی از ۱ ترابایت تا ۵۳ ترابایت در ابری تِن‌سنت

این مقاله مراحل راه‌اندازی OpenClaw روی Tencent Cloud با یک کلیک را با استفاده از سرورهای تازه خریداری‌شده یا موجود تشریح می‌کند. این مقاله گزینه‌های پیکربندی سرور و تنظیمات مدل API را پوشش می‌دهد تا به کاربران کمک کند سریعاً یک سرویس دستیار هوش مصنوعی پایدار و ایزوله راه‌اندازی کنند.

۱. قبل از شروع، این موارد را آماده کنید

قبل از شروع عملیات رسمی، مطمئن شوید که شرایط زیر را دارید:

1. یک حساب QQ با احراز هویت کامل دارید.
2. قبلاً OpenClaw در سرور برنامه سبک Lighthouse مستقر شده است.
3. اگر نمونه OpenClaw شما در نسخه‌های قدیمی‌تر ایجاد شده است، بهتر است ابتدا به نسخه جدیدتر برنامه به‌روزرسانی کنید و سپس پیکربندی را ادامه دهید.
4. اگر قصد استفاده طولانی مدت از کانال QQ را دارید، اولویت را به سرورهای داخلی و خدمات مدلی که به طور پایدار قابل فراخوانی هستند، بدهید.

2. ثبت‌نام و ورود به پلتفرم باز QQ

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

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

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

• AppID
• AppSecret

این دو مقدار را فوراً کپی کرده و ذخیره کنید، بعداً هنگام پیکربندی 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، هسته آن فقط چهار مرحله است:

1. استقرار OpenClaw
2. ایجاد ربات در پلتفرم باز QQ
3. ذخیره کنید AppID 和 AppSecret
4. پیکربندی مدل و تنظیم کانال QQ را در پنل ابری انجام دهید

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