Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

LINE kết nối với OpenClaw qua LINE Messaging API. Plugin chạy như một trình nhận Webhook trên Gateway và sử dụng channel access token + channel secret của bạn để xác thực. Trạng thái: Plugin có thể tải xuống. Tin nhắn trực tiếp, trò chuyện nhóm, phương tiện, vị trí, Flex messages, template messages và quick replies được hỗ trợ. Reactions và threads không được hỗ trợ.

​
Cài đặt

Cài đặt LINE trước khi cấu hình kênh: 
openclaw plugins install @openclaw/line
Bản checkout cục bộ (khi chạy từ một git repo): 
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 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
Gateway phản hồi xác minh Webhook của LINE (GET) và các sự kiện đến (POST). Nếu bạn cần một đường dẫn tùy chỉnh, hãy đặt channels.line.webhookPath hoặc channels.line.accounts.<id>.webhookPath và cập nhật URL tương ứng. Lưu ý bảo mật:
  • 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 tiền xác thực nghiêm ngặt và timeout trước khi xác minh.
  • OpenClaw xử lý sự kiện Webhook từ byte request raw đã được xác minh. Các giá trị req.body đã bị middleware upstream biến đổi sẽ bị bỏ qua để bảo đảm an toàn tính toàn vẹn chữ ký.

​
Cấu hình

Cấu hình tối thiểu: 
{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "pairing",
    },
  },
}
Cấu hình DM công khai: 
{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "open",
      allowFrom: ["*"],
    },
  },
}
Biến môi trường (chỉ tài khoản mặc định):
  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET
Tệp token/secret: 
{
  channels: {
    line: {
      tokenFile: "/path/to/line-token.txt",
      secretFile: "/path/to/line-secret.txt",
    },
  },
}
tokenFile và secretFile phải trỏ đến các tệp thông thường. Symlink bị từ chối. Nhiều tài khoản: 
{
  channels: {
    line: {
      accounts: {
        marketing: {
          channelAccessToken: "...",
          channelSecret: "...",
          webhookPath: "/line/marketing",
        },
      },
    },
  },
}

​
Kiểm soát truy cập

Tin nhắn trực tiếp mặc định dùng ghép đôi. Người gửi không xác định nhận được mã ghép đôi và tin nhắn của họ bị bỏ qua cho đến khi được phê duyệt. 
openclaw pairing list line
openclaw pairing approve line <CODE>
Danh sách cho phép và chính sách:
  • 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 nhóm: channels.line.groups.<groupId>.allowFrom
  • Nhóm truy cập người gửi tĩnh có thể được tham chiếu từ allowFrom, groupAllowFrom và allowFrom theo nhóm bằng accessGroup:<name>.
  • Lưu ý runtime: nếu channels.line hoàn toàn bị thiếu, runtime sẽ quay về groupPolicy="allowlist" cho kiểm tra nhóm (ngay cả khi channels.defaults.groupPolicy được đặt).
ID LINE phân biệt chữ hoa chữ thường. ID hợp lệ có dạng:
  • 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 block và bảng được chuyển đổi thành Flex cards khi có thể.
  • Phản hồi streaming được đệm; LINE nhận các đoạn hoàn chỉnh 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 đến được lưu trong ~/.openclaw/media/inbound/ trước khi được truyề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ú)

Dùng channelData.line để gửi quick replies, vị trí, Flex cards hoặc template messages. 
{
  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",
      },
    },
  },
}
Plugin LINE cũng cung cấp lệnh /card cho các preset Flex message: 
/card info "Welcome" "Thanks for joining!"

​
Hỗ trợ ACP

LINE hỗ trợ liên kết hội thoại ACP (Agent Communication Protocol):
  • /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 thread 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.
Xem ACP agents để biết chi tiết.

​
Phương tiện gửi đi

Plugin LINE hỗ trợ gửi hình ảnh, video và tệp âm thanh thông qua công cụ tin nhắn agent. Phương tiện được gửi qua đường dẫn phân phối riêng của LINE với xử lý xem trước và theo dõi phù hợp:
  • Hình ảnh: 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: gửi với xử lý bản xem trước và content-type rõ ràng.
  • Âm thanh: gửi dưới dạng tin nhắn âm thanh LINE.
URL phương tiện gửi đi phải là URL HTTPS công khai. OpenClaw xác thực hostname đích trước khi chuyển URL cho LINE và từ chối các mục tiêu local loopback, link-local và mạng riêng. Lượt gửi phương tiện chung quay về tuyến chỉ hình ảnh hiện có khi không có đường dẫn riêng cho LINE.

​
Khắc phục sự cố

  • Xác minh Webhook thất bại: bảo đảm URL Webhook là HTTPS và channelSecret khớp với console LINE.
  • Không có sự kiện đến: 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