OmeniaClaw channels

إدارة حسابات قنوات الدردشة وحالة تشغيلها على Gateway.

المستندات ذات الصلة:

• أدلة القنوات: القنوات
• إعداد Gateway: الإعداد

الأوامر الشائعة

OmeniaClaw channels listOmeniaClaw channels list --allOmeniaClaw channels statusOmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123OmeniaClaw channels capabilities --channel discord --target channel:<voice-channel-id>OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels logs --channel all

يعرض channels list قنوات الدردشة فقط: الحسابات المضبوطة افتراضيًا، مع وسوم حالة installed وconfigured وenabled لكل حساب. مرّر --all لإظهار القنوات المضمّنة التي لا تملك حسابًا مضبوطًا بعد، وقنوات الفهرس القابلة للتثبيت التي لم تصبح موجودة على القرص بعد. لم تعد موفّرات المصادقة (OAuth + مفاتيح API) ولقطات استخدام/حصة موفّر النموذج تُطبع هنا؛ استخدم OmeniaClaw models auth list لملفات تعريف مصادقة الموفّرين وOmeniaClaw status أو OmeniaClaw models list للاستخدام.

الحالة / الإمكانات / الحل / السجلات

• channels status: --channel <name>, --probe, --timeout <ms>, --json
• channels capabilities: --channel <name>, --account <id> (فقط مع --channel)، --target <dest>, --timeout <ms>, --json
• channels resolve: <entries...>, --channel <name>, --account <id>, --kind <auto|user|group>, --json
• channels logs: --channel <name|all>, --lines <n>, --json

channels status --probe هو المسار الحي: على Gateway يمكن الوصول إليه، يشغّل فحوصات probeAccount وفحوصات auditAccount الاختيارية لكل حساب، لذلك يمكن أن يتضمن الإخراج حالة النقل إضافة إلى نتائج الفحص مثل works أو probe failed أو audit ok أو audit failed. إذا تعذر الوصول إلى Gateway، يعود channels status إلى ملخصات مبنية على الإعداد فقط بدلًا من إخراج الفحص الحي.

لا تستخدم OmeniaClaw sessions أو sessions.list في Gateway أو أداة sessions_list الخاصة بالوكيل كإشارة إلى صحة مقبس القناة. هذه الواجهات تعرض صفوف المحادثات المخزنة، لا حالة تشغيل الموفّر. بعد إعادة تشغيل موفّر Discord، قد يكون الحساب المتصل لكن الهادئ سليمًا بينما لا يظهر صف جلسة Discord حتى حدث المحادثة الواردة أو الصادرة التالي.

إضافة / إزالة الحسابات

OmeniaClaw channels add --channel telegram --token <bot-token>OmeniaClaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"OmeniaClaw channels remove --channel telegram --delete

يعمل channels remove فقط على Plugins القنوات المثبتة/المضبوطة. استخدم channels add أولًا لقنوات الفهرس القابلة للتثبيت. بالنسبة إلى Plugins القنوات المدعومة بالتشغيل، يطلب channels remove أيضًا من Gateway الجاري إيقاف الحساب المحدد قبل أن يحدّث الإعداد، بحيث لا يترك تعطيل حساب أو حذفه المستمع القديم نشطًا حتى إعادة التشغيل.

تشمل واجهات الإضافة غير التفاعلية الشائعة:

• قنوات رمز البوت: --token, --bot-token, --app-token, --token-file
• حقول نقل Signal/iMessage: --signal-number, --cli-path, --http-url, --http-host, --http-port, --db-path, --service, --region
• حقول Google Chat: --webhook-path, --webhook-url, --audience-type, --audience
• حقول Matrix: --homeserver, --user-id, --access-token, --password, --device-name, --initial-sync-limit
• حقول Nostr: --private-key, --relay-urls
• حقول Tlon: --ship, --url, --code, --group-channels, --dm-allowlist, --auto-discover-channels
• --use-env لمصادقة الحساب الافتراضي المدعومة بالبيئة حيث تكون مدعومة

إذا كان Plugin قناة يحتاج إلى التثبيت أثناء أمر إضافة موجّه بالأعلام، يستخدم OmeniaClaw مصدر التثبيت الافتراضي للقناة دون فتح موجه تثبيت Plugin التفاعلي.

عند تشغيل OmeniaClaw channels add دون أعلام، يمكن للمعالج التفاعلي أن يطلب:

• معرّفات الحسابات لكل قناة محددة
• أسماء عرض اختيارية لتلك الحسابات
• Route these channel accounts to agents now?

إذا أكدت الربط الآن، يسأل المعالج أي وكيل يجب أن يملك كل حساب قناة مضبوط ويكتب ارتباطات التوجيه محددة الحساب.

يمكنك أيضًا إدارة قواعد التوجيه نفسها لاحقًا باستخدام OmeniaClaw agents bindings وOmeniaClaw agents bind وOmeniaClaw agents unbind (راجع الوكلاء).

عند إضافة حساب غير افتراضي إلى قناة ما زالت تستخدم إعدادات المستوى الأعلى لحساب واحد، يرقّي OmeniaClaw قيم المستوى الأعلى محددة الحساب إلى خريطة حسابات القناة قبل كتابة الحساب الجديد. تستقر هذه القيم في معظم القنوات في channels.<channel>.accounts.default، لكن القنوات المضمّنة يمكنها بدلًا من ذلك الحفاظ على حساب مرقّى مطابق موجود. Matrix هو المثال الحالي: إذا كان هناك حساب مسمّى واحد موجود بالفعل، أو كان defaultAccount يشير إلى حساب مسمّى موجود، يحافظ الترقية على ذلك الحساب بدلًا من إنشاء accounts.default جديد.

يبقى سلوك التوجيه متسقًا:

• تستمر الارتباطات الحالية الخاصة بالقناة فقط (بدون accountId) في مطابقة الحساب الافتراضي.
• لا ينشئ channels add ارتباطات تلقائيًا ولا يعيد كتابتها في الوضع غير التفاعلي.
• يمكن للإعداد التفاعلي اختياريًا إضافة ارتباطات محددة الحساب.

إذا كان إعدادك موجودًا بالفعل في حالة مختلطة (حسابات مسماة موجودة وقيم حساب واحد في المستوى الأعلى ما زالت مضبوطة)، شغّل OmeniaClaw doctor --fix لنقل القيم محددة الحساب إلى الحساب المرقّى المختار لتلك القناة. تترقى معظم القنوات إلى accounts.default؛ يمكن لـ Matrix بدلًا من ذلك الحفاظ على هدف مسمّى/افتراضي موجود.

تسجيل الدخول وتسجيل الخروج (تفاعلي)

OmeniaClaw channels login --channel whatsappOmeniaClaw channels logout --channel whatsapp

• يدعم channels login الخيار --verbose.
• يمكن لـ channels login وlogout استنتاج القناة عندما يكون هدف تسجيل دخول مدعوم واحد فقط مضبوطًا.
• يفضّل channels logout مسار Gateway الحي عندما يكون قابلًا للوصول، لذلك يوقف تسجيل الخروج أي مستمع نشط قبل مسح حالة مصادقة القناة. إذا كان Gateway محلي غير قابل للوصول، يعود إلى تنظيف المصادقة المحلي.
• شغّل channels login من طرفية على مضيف Gateway. يحظر exec الخاص بالوكيل تدفق تسجيل الدخول التفاعلي هذا؛ يجب استخدام أدوات تسجيل الدخول الأصلية للقناة الخاصة بالوكيل، مثل whatsapp_login، من الدردشة عندما تكون متاحة.

استكشاف الأخطاء وإصلاحها

• شغّل OmeniaClaw status --deep لفحص واسع.
• استخدم OmeniaClaw doctor للإصلاحات الموجّهة.
• لم يعد OmeniaClaw channels list يطبع لقطات استخدام/حصة موفّر النموذج. لذلك، استخدم OmeniaClaw status (نظرة عامة) أو OmeniaClaw models list (لكل موفّر).
• يعود OmeniaClaw channels status إلى ملخصات مبنية على الإعداد فقط عندما يتعذر الوصول إلى Gateway. إذا كان اعتماد قناة مدعومة مضبوطًا عبر SecretRef لكنه غير متاح في مسار الأمر الحالي، فإنه يبلّغ ذلك الحساب كمضبوط مع ملاحظات تدهور بدلًا من إظهاره كغير مضبوط.

فحص الإمكانات

اجلب تلميحات إمكانات الموفّر (النوايا/النطاقات حيثما توفرت) إضافة إلى دعم الميزات الثابت:

OmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123

ملاحظات:

• --channel اختياري؛ احذفه لسرد كل قناة (بما في ذلك الامتدادات).
• --account صالح فقط مع --channel.
• يقبل --target القيمة channel:<id> أو معرّف قناة رقميًا خامًا وينطبق فقط على Discord. بالنسبة إلى قنوات Discord الصوتية، يعلّم فحص الأذونات الأذونات الناقصة ViewChannel وConnect وSpeak وSendMessages وReadMessageHistory.
• الفحوصات خاصة بالموفّر: نوايا Discord + أذونات قناة اختيارية؛ نطاقات بوت Slack + المستخدم؛ أعلام بوت Telegram + Webhook؛ إصدار عفريت Signal؛ رمز تطبيق Microsoft Teams + أدوار/نطاقات Graph (مع توضيح حيث تكون معروفة). القنوات التي لا تملك فحوصات تبلّغ Probe: unavailable.

حل الأسماء إلى معرّفات

حل أسماء القنوات/المستخدمين إلى معرّفات باستخدام دليل الموفّر:

OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels resolve --channel discord "My Server/#support" "@someone"OmeniaClaw channels resolve --channel matrix "Project Room"

ملاحظات:

• استخدم --kind user|group|auto لفرض نوع الهدف.
• يفضّل الحل المطابقات النشطة عندما تتشارك إدخالات متعددة الاسم نفسه.
• channels resolve للقراءة فقط. إذا كان الحساب المحدد مضبوطًا عبر SecretRef لكن ذلك الاعتماد غير متاح في مسار الأمر الحالي، يعيد الأمر نتائج غير محلولة متدهورة مع ملاحظات بدلًا من إجهاض التشغيل بالكامل.
• لا يثبّت channels resolve Plugins القنوات. استخدم channels add --channel <name> قبل حل الأسماء لقناة فهرس قابلة للتثبيت.

ذات صلة

• مرجع CLI
• نظرة عامة على القنوات