منصات المراسلة

Nextcloud Talk

الحالة: مدعوم عبر إضافة (بوت ويب هوك). الرسائل المباشرة، الغرف، التفاعلات، والرسائل بتنسيق Markdown مدعومة.

الإضافة مطلوبة

يتم توزيع Nextcloud Talk كإضافة وليست مضمنة في التثبيت الأساسي. قم بالتثبيت عبر سطر الأوامر (سجل npm):

openclaw plugins install @openclaw/nextcloud-talk

التثبيت المحلي (عند التشغيل من مستودع git):

openclaw plugins install ./extensions/nextcloud-talk

إذا اخترت Nextcloud Talk أثناء التكوين/التهيئة وتم اكتشاف نسخة git محلية، فسيعرض OpenClaw مسار التثبيت المحلي تلقائيًا. التفاصيل: الإضافات

الإعداد السريع (للمبتدئين)

  1. قم بتثبيت إضافة Nextcloud Talk.

  2. على خادم Nextcloud الخاص بك، أنشئ بوتًا:

    نسخ

    ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction

  3. قم بتمكين البوت في إعدادات الغرفة المستهدفة.

  4. قم بتكوين OpenClaw:

    • التكوين: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
    • أو متغيرات البيئة: NEXTCLOUD_TALK_BOT_SECRET (الحساب الافتراضي فقط)

  5. أعد تشغيل البوابة (أو أكمل عملية التهيئة).

الحد الأدنى للتكوين:

{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing",
    },
  },
}

ملاحظات

  • لا يمكن للبوتات بدء الرسائل المباشرة. يجب على المستخدم مراسلة البوت أولاً.
  • يجب أن يكون عنوان URL لـ webhook قابلاً للوصول من قبل البوابة؛ قم بتعيين webhookPublicUrl إذا كنت خلف وكيل.
  • رفع الوسائط غير مدعوم بواسطة واجهة برمجة تطبيقات البوت؛ يتم إرسال الوسائط كعناوين URL.
  • لا يميز حمولة webhook بين الرسائل المباشرة والغرف؛ قم بتعيين apiUser + apiPassword لتمكين البحث عن نوع الغرفة (وإلا يتم التعامل مع الرسائل المباشرة كغرف).

التحكم في الوصول (الرسائل المباشرة)

  • الافتراضي: channels.nextcloud-talk.dmPolicy = "pairing". المرسلون غير المعروفين يحصلون على رمز إقران.
  • الموافقة عبر:
    • openclaw pairing list nextcloud-talk
    • openclaw pairing approve nextcloud-talk <CODE>
  • الرسائل المباشرة العامة: channels.nextcloud-talk.dmPolicy="open" بالإضافة إلى channels.nextcloud-talk.allowFrom=["*"].
  • allowFrom يطابق معرّفات مستخدم Nextcloud فقط؛ يتم تجاهل أسماء العرض.

الغرف (المجموعات)

  • الافتراضي: channels.nextcloud-talk.groupPolicy = "allowlist" (مقيد بالذكر).
  • قائمة الغرف المسموح بها باستخدام channels.nextcloud-talk.rooms:
{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}
  • لعدم السماح بأي غرف، اترك قائمة السماح فارغة أو عيّن channels.nextcloud-talk.groupPolicy="disabled".

الإمكانيات

الميزةالحالة
الرسائل المباشرةمدعومة
الغرفمدعومة
السلاسل النصيةغير مدعوم
الوسائطعنوان URL فقط
التفاعلاتمدعومة
الأوامر الأصليةغير مدعوم

مرجع التكوين (Nextcloud Talk)

التكوين الكامل: التكوين خيارات المزود:

  • channels.nextcloud-talk.enabled: تمكين/تعطيل بدء تشغيل القناة.
  • channels.nextcloud-talk.baseUrl: عنوان URL لنسخة Nextcloud.
  • channels.nextcloud-talk.botSecret: السر المشترك للبوت.
  • channels.nextcloud-talk.botSecretFile: مسار ملف السر.
  • channels.nextcloud-talk.apiUser: مستخدم واجهة برمجة التطبيقات للبحث عن الغرف (كشف الرسائل المباشرة).
  • channels.nextcloud-talk.apiPassword: كلمة مرور واجهة برمجة التطبيقات/التطبيق للبحث عن الغرف.
  • channels.nextcloud-talk.apiPasswordFile: مسار ملف كلمة مرور واجهة برمجة التطبيقات.
  • channels.nextcloud-talk.webhookPort: منفذ مستمع webhook (الافتراضي: 8788).
  • channels.nextcloud-talk.webhookHost: مضيف webhook (الافتراضي: 0.0.0.0).
  • channels.nextcloud-talk.webhookPath: مسار webhook (الافتراضي: /nextcloud-talk-webhook).
  • channels.nextcloud-talk.webhookPublicUrl: عنوان URL لـ webhook يمكن الوصول إليه خارجيًا.
  • channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
  • channels.nextcloud-talk.allowFrom: قائمة السماح للرسائل المباشرة (معرّفات المستخدم). open تتطلب "*".
  • channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
  • channels.nextcloud-talk.groupAllowFrom: قائمة السماح للمجموعات (معرّفات المستخدم).
  • channels.nextcloud-talk.rooms: إعدادات وقائمة السماح لكل غرفة.
  • channels.nextcloud-talk.historyLimit: حد سجل المجموعة (0 يعطّل).
  • channels.nextcloud-talk.dmHistoryLimit: حد سجل الرسائل المباشرة (0 يعطّل).
  • channels.nextcloud-talk.dms: تجاوزات لكل رسالة مباشرة (historyLimit).
  • channels.nextcloud-talk.textChunkLimit: حجم تجزئة النص الصادر (أحرف).
  • channels.nextcloud-talk.chunkMode: length (الافتراضي) أو newline للتقسيم على الأسطر الفارغة (حدود الفقرات) قبل التجزئة حسب الطول.
  • channels.nextcloud-talk.blockStreaming: تعطيل بث الكتل لهذه القناة.
  • channels.nextcloud-talk.blockStreamingCoalesce: ضبط دمج بث الكتل.
  • channels.nextcloud-talk.mediaMaxMb: الحد الأقصى للوسائط الواردة (ميغابايت).

Microsoft TeamsNostr