WeChat

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

وضعیت: Plugin خارجی. چت‌های مستقیم و رسانه پشتیبانی می‌شوند. چت‌های گروهی در فراداده قابلیت‌های Plugin فعلی تبلیغ نشده‌اند.

# نام‌گذاری

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

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

# سازوکار

کد WeChat در مخزن هسته OpenClaw قرار ندارد. OpenClaw قرارداد عمومی Plugin کانال را فراهم می‌کند، و Plugin خارجی runtime ویژه 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 ذخیره می‌کند.
6. هنگام شروع Gateway، Plugin پایشگر Weixin خود را برای هر حساب پیکربندی‌شده شروع می‌کند.
7. پیام‌های ورودی WeChat از طریق قرارداد کانال نرمال‌سازی می‌شوند، به عامل انتخاب‌شده OpenClaw هدایت می‌شوند، و از مسیر خروجی Plugin برگردانده می‌شوند.

این جداسازی مهم است: هسته OpenClaw باید نسبت به کانال‌ها بی‌طرف بماند. ورود WeChat، فراخوانی‌های Tencent iLink API، بارگذاری/دریافت رسانه، توکن‌های زمینه، و پایش حساب تحت مالکیت 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

# کنترل دسترسی

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

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

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

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

# سازگاری

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

خط Plugin	نسخه OpenClaw	برچسب npm
2.x	>=2026.3.22	latest
1.x	>=2026.1.0 <2026.3.22	legacy

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

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

# فرایند جانبی

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

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

# عیب‌یابی

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

openclaw plugins list
openclaw channels status --probe
openclaw --version

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

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

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

npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart

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

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

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

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

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