​

Tlon

​

plugin المضمّن

openclaw plugins install @openclaw/tlon

openclaw plugins install ./path/to/local/tlon-plugin

​

الإعداد

1. تأكد من أن plugin Tlon متاح.
   • تتضمن إصدارات OpenClaw المعبأة الحالية هذا plugin بالفعل.
   • يمكن للتثبيتات الأقدم/المخصصة إضافته يدويًا باستخدام الأوامر أعلاه.
2. اجمع عنوان URL الخاص بالسفينة ورمز تسجيل الدخول.
3. قم بتكوين channels.tlon.
4. أعد تشغيل gateway.
5. أرسل رسالة خاصة إلى bot أو أشر إليه في قناة جماعية.

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

​

السفن الخاصة/على LAN

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

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

​

قنوات المجموعات

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

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

​

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

{
  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",
    },
  },
}

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

​

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

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

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

​

أهداف التسليم (CLI/cron)

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

​

Skill المضمّنة

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

​

القدرات

​

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

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

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

​

مرجع التكوين

• channels.tlon.enabled: تمكين/تعطيل بدء تشغيل القناة.
• channels.tlon.ship: اسم سفينة Urbit الخاصة بـ bot ‏(مثل ~sampel-palnet).
• channels.tlon.url: عنوان URL الخاص بالسفينة (مثل https://sampel-palnet.tlon.network).
• channels.tlon.code: رمز تسجيل الدخول للسفينة.
• channels.tlon.allowPrivateNetwork: السماح بعناوين localhost/LAN ‏(تجاوز 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 الأصلي.
• الصور: يتم رفع عناوين URL إلى تخزين Tlon وتضمينها ككتل صور.

​

ذو صلة

• نظرة عامة على القنوات — جميع القنوات المدعومة
• الاقتران — مصادقة الرسائل الخاصة وتدفق الاقتران
• المجموعات — سلوك الدردشة الجماعية وضبط الإشارات
• توجيه القنوات — توجيه الجلسات للرسائل
• الأمان — نموذج الوصول والتقوية