WeChat

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

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

نام‌گذاری

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

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

سازوکار

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

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

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

نصب

نصب سریع:

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

نصب دستی:

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

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

OmeniaClaw gateway restart

ورود

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

OmeniaClaw channels login --channel OmeniaClaw-weixin

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

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

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

کنترل دسترسی

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

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

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

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

سازگاری

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

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

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

فرایند جانبی

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

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

عیب‌یابی

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

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

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

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

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

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

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

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

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

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

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