DÒNG

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.

​

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 kênh Messaging API.
3. Sao chép Channel access token và Channel secret từ phần cài đặt kênh.
4. Bật Use webhook trong 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 phần thân (HMAC trên phần thân thô), vì vậy OpenClaw áp dụng giới hạn phần thân 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ô đã xác minh. Các giá trị req.body đã bị middleware thượng nguồn biến đổi sẽ bị bỏ qua để bảo đảm tính 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 trong danh sách 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 trong danh sách cho phép cho nhóm
• Ghi đè theo nhóm: channels.line.groups.<groupId>.allowFrom
• Ghi chú runtime: nếu channels.line hoàn toàn không có, runtime sẽ quay về groupPolicy="allowlist" cho các 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 phát trực tiếp đượ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 gửi vào được lưu trong ~/.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 đóng gói 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 liên kết 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 liên kết ACP đã cấu hình và phiên ACP đang hoạt động được liên kết với hội thoại hoạt động trên LINE giống như các kênh hội thoại khác.

​

Phương tiện gửi ra

• Hình ảnh: được gửi dưới dạng tin nhắn hình ảnh LINE với tính năng tự động tạo bản xem trước.
• Video: được gửi với xử lý bản xem trước và loại nội dung 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 thất bại: bảo đảm URL Webhook dùng HTTPS và channelSecret khớp với console LINE.
• Không có sự kiện gửi vào: 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 kênh — tất cả các kênh được hỗ trợ
• Ghép đôi — xác thực DM và luồng ghép đôi
• Nhóm — hành vi trò chuyện nhóm và cổng kiểm tra 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ố