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.

​

Plugin đóng gói kèm

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 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 raw body), nên OpenClaw áp dụng giới hạn body trước xác thực nghiêm ngặt và timeout trước khi xác minh.
• OpenClaw xử lý sự kiện webhook từ các byte yêu cầu raw đã xác minh. Các giá trị req.body đã bị middleware 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",
    },
  },
}

• 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
• 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 bị 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ỏ; code blocks và bảng được chuyển thành Flex cards khi có thể.
• Phản hồi streaming được buffer; LINE nhận các đoạn đầy đủ kèm hoạt ảnh loading 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).
• Media đầu vào được lưu trong ~/.openclaw/media/inbound/ trước khi được chuyển cho agent, khớp với kho media dùng chung được các Plugin kênh đóng gói kèm 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 bind cuộc trò chuyện LINE hiện tại với một phiên ACP mà không tạo thread con.
• Các binding ACP đã cấu hình và phiên ACP đang hoạt động được bind với hội thoại hoạt động trên LINE như các kênh hội thoại khác.

​

Media gửi đi

• 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 thất bại: hãy bảo đảm URL webhook là HTTPS và channelSecret khớp với console LINE.
• Không có sự kiện đầu vào: xác nhận đường dẫn webhook khớp với channels.line.webhookPath và Gateway có thể truy cập được 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.

​

Liên quan

• Tổng quan về kênh — tất 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 mention
• Đị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ố