LINE

​

Cài đặt

openclaw plugins install @openclaw/line

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

​

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 API nhắn tin.
3. Sao chép Channel access token và Channel secret từ phần cài đặt kênh.
4. Bật Use webhook trong phần cài đặt Messaging API.
5. Đặt URL Webhook thành endpoint Gateway của bạn (bắt buộc HTTPS):

https://gateway-host/line/webhook

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

​

Cấu hình

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

​

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: ID người dùng LINE được cho phép cho DM; dmPolicy: "open" yêu cầu ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: ID người dùng LINE được cho phép cho nhóm
• Ghi đè theo từng nhóm: channels.line.groups.<groupId>.allowFrom
• Có thể tham chiếu nhóm truy cập người gửi tĩnh từ allowFrom, groupAllowFrom và allowFrom theo từng nhóm bằng accessGroup:<name>.
• Ghi chú runtime: nếu channels.line hoàn toàn thiếu, runtime sẽ fallback về 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 thành các đoạn 5000 ký tự.
• Định dạng Markdown bị loại bỏ; 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 đoạn đầy đủ kèm hoạt ảnh tải trong khi agent làm việc.
• Tải xuống phương tiện bị giới hạn bởi channels.line.mediaMaxMb (mặc định 10).
• Phương tiện inbound được lưu dưới ~/.openclaw/media/inbound/ trước khi được chuyển cho agent, khớp với kho phương tiện dùng chung được các Plugin kênh tích hợp khác sử dụng.

​

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

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

​

Hỗ trợ ACP

• /acp spawn <agent> --bind here ràng buộc cuộc trò chuyện LINE hiện tại với một phiên ACP mà không tạo luồng con.
• Các ràng buộc ACP đã cấu hình và phiên ACP đang hoạt động được ràng buộc với cuộc trò chuyện hoạt động trên LINE giống các kênh hội thoại khác.

​

Phương tiện outbound

• Hình ảnh: được gửi dưới dạng tin nhắn hình ảnh LINE với tạo bản xem trước tự động.
• Video: được gửi với xử lý bản xem trước và content-type rõ ràng.
• Âm thanh: được gửi dưới dạng tin nhắn âm thanh LINE.

​

Khắc phục sự cố

• Xác minh Webhook không thành công: đả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ể được LINE truy cập.
• Lỗi tải xuống phương tiện: tăng channels.line.mediaMaxMb nếu phương tiện vượt quá giới hạn mặc định.

​

Liên quan

• Tổng quan về kênh — tất cả kênh được hỗ trợ
• Ghép nối — xác thực DM và luồng ghép nối
• Nhóm — hành vi trò chuyện nhóm và kiểm soát nhắc đến
• Định tuyến kênh — định tuyến phiên cho tin nhắn
• Bảo mật — mô hình truy cập và gia cố