الانتقال إلى المحتوى الرئيسي

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

Tlon

Tlon هو رسول لامركزي مبني على Urbit. يتصل OpenClaw بسفينتك Urbit ويمكنه الرد على الرسائل الخاصة ورسائل الدردشة الجماعية. تتطلب الردود الجماعية ذكر المستخدم (@ mention) افتراضيًا ويمكن تقييدها أكثر عبر قوائم السماح. الحالة: مدعوم عبر إضافة. الرسائل الخاصة، والإشارات في المجموعات، وردود المواضيع، وتنسيق النص الغني، ورفع الصور مدعومة. ردود الفعل (Reactions) والاستطلاعات غير مدعومة بعد.

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

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

openclaw plugins install @openclaw/tlon

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

openclaw plugins install ./extensions/tlon

التفاصيل: الإضافات

الإعداد​

  1. قم بتثبيت إضافة Tlon.
  2. اجمع رابط سفينتك (ship URL) ورمز الدخول (login code).
  3. قم بتكوين channels.tlon.
  4. أعد تشغيل البوابة (gateway).
  5. أرسل رسالة خاصة للبوت أو اذكره في قناة جماعية.

التكوين الأدنى (حساب واحد):

{
  channels: {
    tlon: {
      enabled: true,
      ship: "~sampel-palnet",
      url: "https://your-ship-host",
      code: "lidlut-tabwed-pillex-ridrup",
      ownerShip: "~your-main-ship", // موصى به: سفينتك الرئيسية، مسموح لها دائمًا
    },
  },
}

السفن الخاصة/على الشبكة المحلية (LAN)​

افتراضيًا، يحجب OpenClaw أسماء المضافات الداخلية/الخاصة ونطاقات عناوين IP لحماية من هجمات SSRF. إذا كانت سفينتك تعمل على شبكة خاصة (localhost، عنوان IP للشبكة المحلية، أو اسم مضيف داخلي)، يجب عليك الموافقة صراحةً:

{
  channels: {
    tlon: {
      url: "http://localhost:8080",
      allowPrivateNetwork: true,
    },
  },
}

ينطبق هذا على روابط مثل:

  • http://localhost:8080
  • http://192.168.x.x:8080
  • http://my-ship.local:8080

⚠️ قم بتمكين هذا الإعداد فقط إذا كنت تثق بشبكتك المحلية. يقوم هذا الإعداد بتعطيل حماية SSRF للطلبات المرسلة إلى رابط سفينتك.

القنوات الجماعية​

الاكتشاف التلقائي مفعل افتراضيًا. يمكنك أيضًا تثبيت القنوات يدويًا:

{
  channels: {
    tlon: {
      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
    },
  },
}

تعطيل الاكتشاف التلقائي:

{
  channels: {
    tlon: {
      autoDiscoverChannels: false,
    },
  },
}

التحكم في الوصول​

قائمة السماح للرسائل الخاصة (فارغة = لا يُسمح بأي رسائل خاصة، استخدم ownerShip لتدفق الموافقة):

{
  channels: {
    tlon: {
      dmAllowlist: ["~zod", "~nec"],
    },
  },
}

التفويض للمجموعات (مقيد افتراضيًا):

{
  channels: {
    tlon: {
      defaultAuthorizedShips: ["~zod"],
      authorization: {
        channelRules: {
          "chat/~host-ship/general": {
            mode: "restricted",
            allowedShips: ["~zod", "~nec"],
          },
          "chat/~host-ship/announcements": {
            mode: "open",
          },
        },
      },
    },
  },
}

المالك ونظام الموافقة​

قم بتعيين سفينة مالك لتلقي طلبات الموافقة عندما يحاول مستخدمون غير مفوضين التفاعل:

{
  channels: {
    tlon: {
      ownerShip: "~your-main-ship",
    },
  },
}

سفينة المالك مفوضة تلقائيًا في كل مكان — دعوات الرسائل الخاصة مقبولة تلقائيًا ورسائل القنوات مسموح بها دائمًا. لا تحتاج لإضافة المالك إلى dmAllowlist أو defaultAuthorizedShips. عند التعيين، يتلقى المالك إشعارات بالرسائل الخاصة عن:

  • طلبات رسائل خاصة من سفن غير موجودة في قائمة السماح
  • الإشارات في قنوات بدون تفويض
  • طلبات دعوة للمجموعات

إعدادات القبول التلقائي​

القبول التلقائي لدعوات الرسائل الخاصة (للسفن في dmAllowlist):

{
  channels: {
    tlon: {
      autoAcceptDmInvites: true,
    },
  },
}

القبول التلقائي لدعوات المجموعات:

{
  channels: {
    tlon: {
      autoAcceptGroupInvites: true,
    },
  },
}

أهداف التسليم (سطر الأوامر/المهام المجدولة)​

استخدم هذه مع openclaw message send أو التسليم عبر المهام المجدولة (cron):

  • رسالة خاصة: ~sampel-palnet أو dm/~sampel-palnet
  • مجموعة: chat/~host-ship/channel أو group:~host-ship/channel

المهارة المضمنة​

تتضمن إضافة Tlon مهارة مدمجة (@tloncorp/tlon-skill) توفر وصولاً عبر سطر الأوامر لعمليات Tlon:

  • جهات الاتصال: الحصول/تحديث الملفات الشخصية، سرد جهات الاتصال
  • القنوات: السرد، الإنشاء، نشر الرسائل، جلب السجل
  • المجموعات: السرد، الإنشاء، إدارة الأعضاء
  • الرسائل الخاصة: إرسال الرسائل، التفاعل مع الرسائل
  • ردود الفعل: إضافة/إزالة ردود فعل إيموجي للمنشورات والرسائل الخاصة
  • الإعدادات: إدارة أذونات الإضافة عبر أوامر الشرطة المائلة (slash commands)

المهارة متاحة تلقائيًا عند تثبيت الإضافة.

الإمكانيات​

الميزةالحالة
الرسائل الخاصة✅ مدعومة
المجموعات/القنوات✅ مدعومة (مشروطة بالإشارة افتراضيًا)
المواضيع✅ مدعومة (الردود التلقائية داخل الموضوع)
النص الغني✅ يتم تحويل Markdown إلى تنسيق Tlon
الصور✅ يتم رفعها إلى تخزين Tlon
ردود الفعل✅ عبر المهارة المضمنة
الاستطلاعات❌ غير مدعومة بعد
الأوامر الأصلية✅ مدعومة (للمالك فقط افتراضيًا)

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

قم بتشغيل هذا السلم أولاً:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

الإخفاقات الشائعة:

  • تجاهل الرسائل الخاصة: المرسل غير موجود في dmAllowlist ولم يتم تكوين ownerShip لتدفق الموافقة.
  • تجاهل رسائل المجموعات: القناة غير مكتشفة أو المرسل غير مفوض.
  • أخطاء الاتصال: تحقق من إمكانية الوصول لرابط السفينة؛ قم بتمكين allowPrivateNetwork للسفن المحلية.
  • أخطاء المصادقة: تحقق من أن رمز الدخول حديث (رموز الدخول تتغير).

مرجع التكوين​

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

  • channels.tlon.enabled: تمكين/تعطيل بدء تشغيل القناة.
  • channels.tlon.ship: اسم سفينة Urbit الخاصة بالبوت (مثال: ~sampel-palnet).
  • channels.tlon.url: رابط السفينة (مثال: https://sampel-palnet.tlon.network).
  • channels.tlon.code: رمز دخول السفينة.
  • channels.tlon.allowPrivateNetwork: السماح بعناوين URL محلية/للشبكة المحلية (تجاوز حماية SSRF).
  • channels.tlon.ownerShip: سفينة المالك لنظام الموافقة (مفوضة دائمًا).
  • channels.tlon.dmAllowlist: السفن المسموح لها بإرسال رسائل خاصة (فارغة = لا أحد).
  • channels.tlon.autoAcceptDmInvites: القبول التلقائي للرسائل الخاصة من السفن المسموح بها.
  • channels.tlon.autoAcceptGroupInvites: القبول التلقائي لجميع دعوات المجموعات.
  • channels.tlon.autoDiscoverChannels: الاكتشاف التلقائي للقنوات الجماعية (الافتراضي: true).
  • channels.tlon.groupChannels: أعشاش القنوات المثبتة يدويًا.
  • channels.tlon.defaultAuthorizedShips: السفن المفوضة لجميع القنوات.
  • channels.tlon.authorization.channelRules: قواعد التفويض لكل قناة.
  • channels.tlon.showModelSignature: إضافة اسم النموذج إلى الرسائل.

ملاحظات​

  • تتطلب الردود الجماعية إشارة (مثال: ~your-bot-ship) للرد.
  • ردود المواضيع: إذا كانت الرسالة الواردة داخل موضوع، يرد OpenClaw داخل نفس الموضوع.
  • النص الغني: يتم تحويل تنسيق Markdown (عريض، مائل، كود، عناوين، قوائم) إلى التنسيق الأصلي لـ Tlon.
  • الصور: يتم رفع روابط الصور إلى تخزين Tlon وتضمينها ككتل صور.

TelegramTwitch