​

LINE (plugin)

​

Yêu cầu plugin

openclaw plugins install @openclaw/line

openclaw plugins install ./extensions/line

​

Thiết lập

1. Tạo tài khoản LINE Developers và mở Console: https://developers.line.biz/console/
2. Tạo (hoặc chọn) một Provider và thêm một kênh Messaging API.
3. Sao chép Channel access token và Channel secret từ cài đặt kênh.
4. Bật Use webhook trong cài đặt Messaging API.
5. Đặt URL webhook đến endpoint của gateway (yêu cầu HTTPS):

https://gateway-host/line/webhook

• Xác minh chữ ký của LINE phụ thuộc vào nội dung (HMAC trên nội dung gốc), do đó OpenClaw áp dụng giới hạn và thời gian chờ trước khi xác minh.
• OpenClaw xử lý các sự kiện webhook từ byte yêu cầu gốc đã được xác minh. Các giá trị req.body đã được middleware biến đổi sẽ bị bỏ qua để đảm bảo tính toàn vẹn của chữ ký.

​

Cấu hình

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

​

Kiểm soát truy cập

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled
• channels.line.allowFrom: danh sách cho phép ID người dùng LINE cho DMs
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: danh sách cho phép ID người dùng LINE cho nhóm
• Ghi đè theo nhóm: channels.line.groups.<groupId>.allowFrom
• Lưu ý khi chạy: nếu channels.line hoàn toàn thiếu, runtime sẽ quay lại groupPolicy="allowlist" cho kiểm tra nhóm (ngay cả khi channels.defaults.groupPolicy đã được đặt).

• Người dùng: U + 32 ký tự hex
• Nhóm: C + 32 ký tự hex
• Phòng: R + 32 ký tự hex

​

Hành vi tin nhắn

• Văn bản được chia nhỏ ở 5000 ký tự.
• Định dạng Markdown bị loại bỏ; các khối mã và bảng được chuyển thành thẻ Flex khi có thể.
• Phản hồi streaming được đệm; LINE nhận các khối đầy đủ với hoạt ảnh tải trong khi agent làm việc.
• Tải xuống media bị giới hạn bởi channels.line.mediaMaxMb (mặc định 10).

​

Dữ liệu kênh (tin nhắn phong phú)

{
  text: "Đây là thông tin của bạn",
  channelData: {
    line: {
      quickReplies: ["Trạng thái", "Trợ giúp"],
      location: {
        title: "Văn phòng",
        address: "123 Main St",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Thẻ trạng thái",
        contents: {
          /* Payload Flex */
        },
      },
      templateMessage: {
        type: "confirm",
        text: "Tiếp tục?",
        confirmLabel: "Có",
        confirmData: "yes",
        cancelLabel: "Không",
        cancelData: "no",
      },
    },
  },
}

/card info "Chào mừng" "Cảm ơn bạn đã tham gia!"

​

Khắc phục sự cố

• Xác minh webhook thất bại: đảm bảo URL webhook là HTTPS và channelSecret khớp với console LINE.
• Không có sự kiện inbound: xác nhận đường dẫn webhook khớp với channels.line.webhookPath và gateway có thể truy cập từ LINE.
• Lỗi tải xuống media: tăng channels.line.mediaMaxMb nếu media vượt quá giới hạn mặc định.