وی‌چت

OpenClaw از طریق Plugin خارجی کانال @tencent-weixin/openclaw-weixin متعلق به Tencent به WeChat متصل می‌شود.

وضعیت: Plugin خارجی، نگه‌داری‌شده توسط تیم Tencent Weixin. گفت‌وگوهای مستقیم و رسانه پشتیبانی می‌شوند. گفت‌وگوهای گروهی در فراداده قابلیت‌های Plugin اعلام نشده‌اند (این فراداده فقط گفت‌وگوهای مستقیم را اعلام می‌کند).

نام‌گذاری

• WeChat نامی است که در این مستندات به کاربران نمایش داده می‌شود.
• Weixin نامی است که بسته Tencent و شناسه Plugin از آن استفاده می‌کنند.
• openclaw-weixin شناسه کانال OpenClaw است (weixin و wechat به‌عنوان نام مستعار کار می‌کنند).
• @tencent-weixin/openclaw-weixin بسته npm است.

در فرمان‌های CLI و مسیرهای پیکربندی از openclaw-weixin استفاده کنید.

نحوه کار

کد WeChat در مخزن هسته OpenClaw قرار ندارد. OpenClaw قرارداد عمومی Plugin کانال را فراهم می‌کند و Plugin خارجی، زمان اجرای ویژه WeChat را ارائه می‌دهد:

1. openclaw plugins install، @tencent-weixin/openclaw-weixin را نصب می‌کند.
2. Gateway مانیفست Plugin را شناسایی و نقطه ورود Plugin را بارگذاری می‌کند.
3. Plugin شناسه کانال openclaw-weixin را ثبت می‌کند.
4. openclaw channels login --channel openclaw-weixin ورود با کد QR را آغاز می‌کند.
5. Plugin اعتبارنامه‌های حساب را در پوشه وضعیت OpenClaw ذخیره می‌کند (به‌طور پیش‌فرض ~/.openclaw).
6. هنگام راه‌اندازی Gateway، Plugin پایشگر Weixin خود را برای هر حساب پیکربندی‌شده راه‌اندازی می‌کند.
7. پیام‌های ورودی WeChat از طریق قرارداد کانال نرمال‌سازی می‌شوند، به عامل منتخب OpenClaw هدایت می‌شوند و از مسیر خروجی Plugin بازگردانده می‌شوند.

این جداسازی اهمیت دارد: هسته OpenClaw مستقل از کانال باقی می‌ماند. ورود WeChat، فراخوانی‌های API مربوط به Tencent iLink، بارگذاری و دریافت رسانه، توکن‌های زمینه و پایش حساب بر عهده Plugin خارجی هستند.

نصب

نصب سریع:

npx -y @tencent-weixin/openclaw-weixin-cli install

نصب دستی:

openclaw plugins install "@tencent-weixin/openclaw-weixin"openclaw config set plugins.entries.openclaw-weixin.enabled true

پس از نصب، Gateway را بازراه‌اندازی کنید:

openclaw gateway restart

ورود

ورود با کد QR را روی همان دستگاهی اجرا کنید که Gateway روی آن اجرا می‌شود:

openclaw channels login --channel openclaw-weixin

کد QR را با WeChat روی تلفن خود اسکن و ورود را تأیید کنید. پس از اسکن موفق، Plugin توکن حساب را به‌صورت محلی ذخیره می‌کند.

برای افزودن یک حساب WeChat دیگر، همان فرمان ورود را دوباره اجرا کنید. برای چند حساب، نشست‌های پیام مستقیم را بر اساس حساب، کانال و فرستنده تفکیک کنید:

openclaw config set session.dmScope per-account-channel-peer

کنترل دسترسی

پیام‌های مستقیم از مدل معمول جفت‌سازی و فهرست مجاز OpenClaw برای Pluginهای کانال استفاده می‌کنند.

فرستندگان جدید را تأیید کنید:

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

برای مشاهده مدل کامل کنترل دسترسی، به جفت‌سازی مراجعه کنید.

سازگاری

Plugin هنگام راه‌اندازی، نسخه OpenClaw میزبان را بررسی می‌کند.

اگر Plugin گزارش داد که نسخه OpenClaw شما بیش‌ازحد قدیمی است، OpenClaw را به‌روزرسانی کنید یا سری قدیمی Plugin را نصب کنید:

openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

فرایند جانبی

Plugin مربوط به WeChat می‌تواند هنگام پایش API مربوط به Tencent iLink، کارهای کمکی را در کنار Gateway اجرا کند. در ایشوی #68451، این مسیر کمکی یک باگ را در پاک‌سازی عمومی Gateway منقضی‌شده در OpenClaw آشکار کرد: یک فرایند فرزند می‌توانست برای پاک‌سازی فرایند والد Gateway تلاش کند و در مدیران فرایندی مانند systemd باعث ایجاد چرخه‌های بازراه‌اندازی شود.

پاک‌سازی کنونی هنگام راه‌اندازی OpenClaw، فرایند فعلی و فرایندهای والد آن را مستثنا می‌کند؛ بنابراین یک فرایند کمکی کانال نمی‌تواند Gateway راه‌انداز خود را متوقف کند. این اصلاح عمومی است و مسیر ویژه WeChat در هسته نیست.

عیب‌یابی

نصب و وضعیت را بررسی کنید:

openclaw plugins listopenclaw channels status --probeopenclaw --version

اگر کانال نصب‌شده نمایش داده می‌شود اما متصل نمی‌شود، مطمئن شوید Plugin فعال است و آن را بازراه‌اندازی کنید:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

اگر Gateway پس از فعال‌سازی WeChat به‌طور مکرر بازراه‌اندازی می‌شود، هم OpenClaw و هم Plugin را به‌روزرسانی کنید:

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

اگر هنگام راه‌اندازی گزارش شد که بسته Plugin نصب‌شده requires compiled runtime output for TypeScript entry، بسته npm بدون فایل‌های کامپایل‌شده زمان اجرای JavaScript موردنیاز OpenClaw منتشر شده است. پس از انتشار بسته اصلاح‌شده توسط ناشر Plugin، آن را به‌روزرسانی یا دوباره نصب کنید؛ یا موقتاً Plugin را غیرفعال یا حذف کنید.

غیرفعال‌سازی موقت:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

مستندات مرتبط

• نمای کلی کانال: کانال‌های گفت‌وگو
• جفت‌سازی: جفت‌سازی
• مسیریابی کانال: مسیریابی کانال
• معماری Plugin: معماری Plugin
• SDK مربوط به Plugin کانال: SDK مربوط به Plugin کانال
• بسته خارجی: @tencent-weixin/openclaw-weixin