​

LINE (إضافة)

​

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

openclaw plugins install @openclaw/line

openclaw plugins install ./extensions/line

​

الإعداد

1. أنشئ حساب LINE Developers وافتح لوحة التحكم: https://developers.line.biz/console/
2. أنشئ (أو اختر) موفّرًا وأضِف قناة Messaging API.
3. انسخ Channel access token وChannel secret من إعدادات القناة.
4. فعّل Use webhook في إعدادات Messaging API.
5. اضبط عنوان webhook URL على نقطة نهاية الـ Gateway لديك (يتطلب HTTPS):

https://gateway-host/line/webhook

​

التهيئة

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "pairing",
    },
  },
}

• LINE_CHANNEL_ACCESS_TOKEN
• LINE_CHANNEL_SECRET

{
  channels: {
    line: {
      tokenFile: "/path/to/line-token.txt",
      secretFile: "/path/to/line-secret.txt",
    },
  },
}

{
  channels: {
    line: {
      accounts: {
        marketing: {
          channelAccessToken: "...",
          channelSecret: "...",
          webhookPath: "/line/marketing",
        },
      },
    },
  },
}

​

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

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled
• channels.line.allowFrom: مُعرّفات مستخدمي LINE المسموح بها للرسائل المباشرة
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: مُعرّفات مستخدمي LINE المسموح بها للمجموعات
• تجاوزات لكل مجموعة: channels.line.groups.<groupId>.allowFrom

• المستخدم: U + 32 محرفًا سداسيًا
• المجموعة: C + 32 محرفًا سداسيًا
• الغرفة: R + 32 محرفًا سداسيًا

​

سلوك الرسائل

• يتم تقسيم النص عند 5000 محرف.
• تُزال تنسيقات Markdown؛ وتُحوَّل كتل الشيفرة والجداول إلى بطاقات Flex عند الإمكان.
• تُخزَّن الاستجابات المتدفقة مؤقتًا؛ ويتلقى LINE كتلًا كاملة مع رسوم متحركة للتحميل أثناء عمل الوكيل.
• تنزيل الوسائط مقيّد بواسطة channels.line.mediaMaxMb (الافتراضي 10).

​

بيانات القناة (الرسائل الغنية)

{
  text: "Here you go",
  channelData: {
    line: {
      quickReplies: ["Status", "Help"],
      location: {
        title: "Office",
        address: "123 Main St",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Status card",
        contents: {
          /* Flex payload */
        },
      },
      templateMessage: {
        type: "confirm",
        text: "Proceed?",
        confirmLabel: "Yes",
        confirmData: "yes",
        cancelLabel: "No",
        cancelData: "no",
      },
    },
  },
}

/card info "Welcome" "Thanks for joining!"

​

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

• فشل التحقق من webhook: تأكد من أن عنوان webhook URL يستخدم HTTPS وأن channelSecret يطابق إعدادات لوحة تحكم LINE.
• لا توجد أحداث واردة: تحقّق من أن مسار webhook يطابق channels.line.webhookPath وأن الـ Gateway قابل للوصول من LINE.
• أخطاء تنزيل الوسائط: ارفع قيمة channels.line.mediaMaxMb إذا تجاوزت الوسائط الحد الافتراضي.