Regional platforms

줄

LINE은 LINE Messaging API를 통해 OpenClaw에 연결됩니다. 이 Plugin은 Gateway에서 Webhook 수신기로 실행되며 인증에 채널 액세스 토큰 + 채널 시크릿을 사용합니다.

상태: 다운로드 가능한 Plugin. 다이렉트 메시지, 그룹 채팅, 미디어, 위치, Flex 메시지, 템플릿 메시지, 빠른 답장이 지원됩니다. 반응과 스레드는 지원되지 않습니다.

설치

채널을 구성하기 전에 LINE을 설치하세요.

openclaw plugins install @openclaw/line

로컬 체크아웃(git 리포지토리에서 실행하는 경우):

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

설정

LINE Developers 계정을 만들고 콘솔을 엽니다. https://developers.line.biz/console/
Provider를 만들거나 선택한 뒤 Messaging API 채널을 추가합니다.
채널 설정에서 Channel access token과 Channel secret을 복사합니다.
Messaging API 설정에서 Use webhook을 활성화합니다.
Webhook URL을 Gateway 엔드포인트로 설정합니다(HTTPS 필요).

https://gateway-host/line/webhook

Gateway는 LINE의 Webhook 검증(GET)과 인바운드 이벤트(POST)에 응답합니다. 사용자 지정 경로가 필요하면 channels.line.webhookPath 또는 channels.line.accounts.<id>.webhookPath를 설정하고 그에 맞게 URL을 업데이트하세요.

보안 참고:

LINE 서명 검증은 본문에 의존하므로(raw body에 대한 HMAC), OpenClaw는 검증 전에 엄격한 사전 인증 본문 제한과 시간 제한을 적용합니다.
OpenClaw는 검증된 원시 요청 바이트에서 Webhook 이벤트를 처리합니다. 서명 무결성 안전을 위해 업스트림 미들웨어가 변환한 req.body 값은 무시됩니다.

구성

최소 구성:

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "pairing",
    },
  },
}

공개 DM 구성:

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

tokenFile과 secretFile은 일반 파일을 가리켜야 합니다. 심볼릭 링크는 거부됩니다.

여러 계정:

{
  channels: {
    line: {
      accounts: {
        marketing: {
          channelAccessToken: "...",
          channelSecret: "...",
          webhookPath: "/line/marketing",
        },
      },
    },
  },
}

액세스 제어

다이렉트 메시지는 기본적으로 페어링을 사용합니다. 알 수 없는 발신자는 페어링 코드를 받고, 승인될 때까지 해당 메시지는 무시됩니다.

openclaw pairing list line
openclaw pairing approve line &lt;CODE&gt;

허용 목록과 정책:

channels.line.dmPolicy: pairing | allowlist | open | disabled
channels.line.allowFrom: DM에 허용된 LINE 사용자 ID. dmPolicy: "open"에는 ["*"]가 필요합니다.
channels.line.groupPolicy: allowlist | open | disabled
channels.line.groupAllowFrom: 그룹에 허용된 LINE 사용자 ID
그룹별 재정의: channels.line.groups.<groupId>.allowFrom
런타임 참고: channels.line이 완전히 누락된 경우, 런타임은 그룹 검사에 대해 groupPolicy="allowlist"로 대체합니다(channels.defaults.groupPolicy가 설정되어 있어도).

LINE ID는 대소문자를 구분합니다. 유효한 ID는 다음과 같습니다.

사용자: U + 32개의 16진수 문자
그룹: C + 32개의 16진수 문자
룸: R + 32개의 16진수 문자

메시지 동작

텍스트는 5000자 단위로 분할됩니다.
Markdown 서식은 제거됩니다. 가능한 경우 코드 블록과 표는 Flex 카드로 변환됩니다.
스트리밍 응답은 버퍼링됩니다. 에이전트가 작업하는 동안 LINE은 로딩 애니메이션과 함께 전체 청크를 받습니다.
미디어 다운로드는 channels.line.mediaMaxMb로 제한됩니다(기본값 10).
인바운드 미디어는 에이전트에 전달되기 전에 ~/.openclaw/media/inbound/ 아래에 저장되며, 다른 번들 채널 Plugin에서 사용하는 공유 미디어 저장소와 일치합니다.

채널 데이터(리치 메시지)

channelData.line을 사용하여 빠른 답장, 위치, Flex 카드 또는 템플릿 메시지를 보냅니다.

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

LINE Plugin은 Flex 메시지 프리셋을 위한 /card 명령도 제공합니다.

/card info "Welcome" "Thanks for joining!"

ACP 지원

LINE은 ACP(Agent Communication Protocol) 대화 바인딩을 지원합니다.

/acp spawn <agent> --bind here는 자식 스레드를 만들지 않고 현재 LINE 채팅을 ACP 세션에 바인딩합니다.
구성된 ACP 바인딩과 활성 대화 바인딩 ACP 세션은 다른 대화 채널과 마찬가지로 LINE에서 작동합니다.

자세한 내용은 ACP 에이전트를 참조하세요.

아웃바운드 미디어

LINE Plugin은 에이전트 메시지 도구를 통해 이미지, 동영상, 오디오 파일 전송을 지원합니다. 미디어는 적절한 미리보기와 추적 처리를 포함해 LINE 전용 전달 경로를 통해 전송됩니다.

이미지: 자동 미리보기 생성과 함께 LINE 이미지 메시지로 전송됩니다.
동영상: 명시적인 미리보기와 콘텐츠 유형 처리와 함께 전송됩니다.
오디오: LINE 오디오 메시지로 전송됩니다.

아웃바운드 미디어 URL은 공개 HTTPS URL이어야 합니다. OpenClaw는 URL을 LINE에 넘기기 전에 대상 호스트 이름을 검증하고 loopback, link-local, private-network 대상을 거부합니다.

일반 미디어 전송은 LINE 전용 경로를 사용할 수 없는 경우 기존 이미지 전용 경로로 대체됩니다.

문제 해결

Webhook 검증 실패: Webhook URL이 HTTPS이고 channelSecret이 LINE 콘솔과 일치하는지 확인하세요.
인바운드 이벤트 없음: Webhook 경로가 channels.line.webhookPath와 일치하고 Gateway가 LINE에서 접근 가능한지 확인하세요.
미디어 다운로드 오류: 미디어가 기본 제한을 초과하면 channels.line.mediaMaxMb를 높이세요.

줄

설치

설정

구성

액세스 제어

메시지 동작

채널 데이터(리치 메시지)

ACP 지원

아웃바운드 미디어

문제 해결

관련 항목

Ask OpenClaw

# 설치

# 설정

# 구성

# 액세스 제어

# 메시지 동작

# 채널 데이터(리치 메시지)

# ACP 지원

# 아웃바운드 미디어

# 문제 해결

# 관련 항목

설치

설정

구성

액세스 제어

메시지 동작

채널 데이터(리치 메시지)

ACP 지원

아웃바운드 미디어

문제 해결

관련 항목