سطر

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

التثبيت

openclaw plugins install @openclaw/line

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

​

الإعداد

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

https://gateway-host/line/webhook

• يعتمد التحقق من توقيع LINE على المتن (HMAC على المتن الخام)، لذلك يطبّق OpenClaw حدودًا صارمة على المتن قبل المصادقة ومهلة زمنية قبل التحقق.
• يعالج OpenClaw أحداث Webhook من بايتات الطلب الخام التي تم التحقق منها. يتم تجاهل قيم req.body المحوّلة عبر البرمجيات الوسيطة العليا حفاظًا على سلامة التوقيع.

​

التكوين

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

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "open",
      allowFrom: ["*"],
    },
  },
}

• 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 المسموح بها للرسائل المباشرة؛ يتطلب dmPolicy: "open" القيمة ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: معرّفات مستخدمي LINE المسموح بها للمجموعات
• تجاوزات لكل مجموعة: channels.line.groups.<groupId>.allowFrom
• يمكن الرجوع إلى مجموعات وصول المرسلين الثابتة من allowFrom و groupAllowFrom و allowFrom لكل مجموعة باستخدام accessGroup:<name>.
• ملاحظة وقت التشغيل: إذا كان channels.line مفقودًا تمامًا، يعود وقت التشغيل إلى groupPolicy="allowlist" لفحوصات المجموعات (حتى إذا كان channels.defaults.groupPolicy مضبوطًا).

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

​

سلوك الرسائل

• يتم تقسيم النص عند 5000 حرف.
• تتم إزالة تنسيق Markdown؛ ويتم تحويل كتل التعليمات البرمجية والجداول إلى بطاقات Flex عندما يكون ذلك ممكنًا.
• يتم تخزين الاستجابات المتدفقة مؤقتًا؛ يتلقى LINE المقاطع كاملة مع رسم متحرك للتحميل أثناء عمل الوكيل.
• يتم تقييد تنزيلات الوسائط بواسطة channels.line.mediaMaxMb (الافتراضي 10).
• يتم حفظ الوسائط الواردة تحت ~/.openclaw/media/inbound/ قبل تمريرها إلى الوكيل، بما يطابق مخزن الوسائط المشترك الذي تستخدمه Plugins القنوات المضمنة الأخرى.

​

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

{
  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!"

​

دعم ACP

• يربط /acp spawn <agent> --bind here دردشة LINE الحالية بجلسة ACP من دون إنشاء سلسلة فرعية.
• تعمل ارتباطات ACP المكوّنة وجلسات ACP النشطة المرتبطة بالمحادثة على LINE مثل قنوات المحادثة الأخرى.

​

الوسائط الصادرة

• الصور: تُرسل كرسائل صور LINE مع إنشاء معاينة تلقائي.
• مقاطع الفيديو: تُرسل مع معالجة صريحة للمعاينة ونوع المحتوى.
• الصوت: يُرسل كرسائل صوت LINE.

​

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

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

​

ذات صلة

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