줄

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.

​

설치

openclaw plugins install @openclaw/line

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

​

설정

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

https://gateway-host/line/webhook

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

​

구성

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

​

접근 제어

openclaw pairing list line
openclaw pairing approve line <CODE>

• 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
• 정적 발신자 접근 그룹은 allowFrom, groupAllowFrom, 그룹별 allowFrom에서 accessGroup:<name>으로 참조할 수 있습니다.
• 런타임 참고: channels.line이 완전히 없으면, 런타임은 그룹 검사에 대해 groupPolicy="allowlist"로 대체됩니다(channels.defaults.groupPolicy가 설정되어 있어도).

• 사용자: U + 32 hex chars
• 그룹: C + 32 hex chars
• 룸: R + 32 hex chars

​

메시지 동작

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

​

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

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

​

ACP 지원

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

​

아웃바운드 미디어

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

​

문제 해결

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

​

관련 문서

• 채널 개요 — 지원되는 모든 채널
• 페어링 — DM 인증 및 페어링 흐름
• 그룹 — 그룹 채팅 동작 및 멘션 게이팅
• 채널 라우팅 — 메시지의 세션 라우팅
• 보안 — 접근 모델 및 강화