บรรทัด

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 แล้วเพิ่ม channel ของ Messaging API
3. คัดลอก Channel access token และ Channel secret จากการตั้งค่า channel
4. เปิดใช้งาน Use webhook ในการตั้งค่า Messaging API
5. ตั้งค่า URL ของ Webhook เป็น endpoint ของ Gateway ของคุณ (ต้องใช้ HTTPS):

https://gateway-host/line/webhook

• การตรวจสอบ signature ของ LINE ขึ้นอยู่กับ body (HMAC บน raw body) ดังนั้น OpenClaw จึงใช้ขีดจำกัด body ก่อนการยืนยันตัวตนและ timeout แบบเข้มงวดก่อนการตรวจสอบ
• OpenClaw ประมวลผลเหตุการณ์ Webhook จากไบต์คำขอ raw ที่ผ่านการตรวจสอบแล้ว ค่า req.body ที่ถูก middleware ต้นทางแปลงจะถูกละเว้นเพื่อความปลอดภัยของความสมบูรณ์ของ signature

​

กำหนดค่า

{
  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 user IDs ที่อยู่ใน allowlist สำหรับ DMs; dmPolicy: "open" ต้องใช้ ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: LINE user IDs ที่อยู่ใน allowlist สำหรับกลุ่ม
• การ override รายกลุ่ม: channels.line.groups.<groupId>.allowFrom
• กลุ่มการเข้าถึงผู้ส่งแบบ static สามารถอ้างอิงได้จาก allowFrom, groupAllowFrom และ allowFrom รายกลุ่มด้วย accessGroup:<name>
• หมายเหตุ runtime: หาก channels.line หายไปทั้งหมด runtime จะ fallback เป็น groupPolicy="allowlist" สำหรับการตรวจสอบกลุ่ม (แม้จะตั้งค่า channels.defaults.groupPolicy ไว้ก็ตาม)

• ผู้ใช้: U + อักขระ hex 32 ตัว
• กลุ่ม: C + อักขระ hex 32 ตัว
• ห้อง: R + อักขระ hex 32 ตัว

​

พฤติกรรมของข้อความ

• ข้อความจะถูกแบ่งเป็นช่วงละ 5000 อักขระ
• การจัดรูปแบบ Markdown จะถูกลบออก; code blocks และตารางจะถูกแปลงเป็นการ์ด Flex เมื่อทำได้
• การตอบกลับแบบ streaming จะถูก buffer; LINE จะได้รับ chunk แบบเต็มพร้อมแอนิเมชัน loading ขณะที่ agent ทำงาน
• การดาวน์โหลดสื่อถูกจำกัดโดย channels.line.mediaMaxMb (ค่าเริ่มต้น 10)
• สื่อขาเข้าจะถูกบันทึกไว้ใต้ ~/.openclaw/media/inbound/ ก่อนส่งต่อ ไปยัง agent ให้ตรงกับ media store ร่วมที่ใช้โดย Plugin channel แบบ bundled อื่นๆ

​

ข้อมูล channel (ข้อความแบบ rich)

{
  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 โดยไม่สร้าง child thread
• binding ACP ที่กำหนดค่าไว้และเซสชัน ACP ที่ผูกกับการสนทนาที่ active ทำงานบน LINE ได้เหมือน channel การสนทนาอื่นๆ

​

สื่อขาออก

• รูปภาพ: ส่งเป็นข้อความรูปภาพ LINE พร้อมการสร้าง preview อัตโนมัติ
• วิดีโอ: ส่งพร้อมการจัดการ preview และ content-type แบบชัดเจน
• เสียง: ส่งเป็นข้อความเสียง LINE

​

การแก้ไขปัญหา

• การตรวจสอบ Webhook ล้มเหลว: ตรวจสอบให้แน่ใจว่า URL ของ Webhook เป็น HTTPS และ channelSecret ตรงกับ LINE console
• ไม่มีเหตุการณ์ขาเข้า: ยืนยันว่า path ของ Webhook ตรงกับ channels.line.webhookPath และ Gateway สามารถเข้าถึงได้จาก LINE
• ข้อผิดพลาดในการดาวน์โหลดสื่อ: เพิ่ม channels.line.mediaMaxMb หากสื่อเกิน ขีดจำกัดเริ่มต้น

​

ที่เกี่ยวข้อง

• ภาพรวม Channels — channel ทั้งหมดที่รองรับ
• การจับคู่ — การยืนยันตัวตน DM และขั้นตอนการจับคู่
• กลุ่ม — พฤติกรรมแชทกลุ่มและการควบคุมด้วยการ mention
• การกำหนดเส้นทาง Channel — การกำหนดเส้นทาง session สำหรับข้อความ
• ความปลอดภัย — โมเดลการเข้าถึงและการ hardening