OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Regional platforms

LINE

Status: plugin oficial, instalado separadamente. Há suporte a mensagens diretas, conversas em grupo, mídia,

O LINE se conecta ao OpenClaw por meio da API de mensagens do LINE. O plugin funciona como um receptor de Webhook no Gateway e usa o token de acesso do canal + o segredo do canal para autenticação.

Status: plugin oficial, instalado separadamente. Há suporte a mensagens diretas, conversas em grupo, mídia, localizações, mensagens Flex, mensagens de modelo e respostas rápidas. Não há suporte a reações nem threads.

Instalação

Instale o LINE antes de configurar o canal:

bash
openclaw plugins install @openclaw/line

Checkout local (ao executar de um repositório git):

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

Configuração inicial

  1. Crie uma conta do LINE Developers e abra o Console: https://developers.line.biz/console/
  2. Crie (ou escolha) um Provider e adicione um canal de Messaging API.
  3. Copie o Channel access token e o Channel secret das configurações do canal.
  4. Ative Use webhook nas configurações da Messaging API.
  5. Defina a URL do Webhook como o endpoint do seu Gateway (HTTPS obrigatório):
text
https://gateway-host/line/webhook

O Gateway responde à verificação do Webhook do LINE (GET) e confirma imediatamente os eventos de entrada assinados (POST) após a validação da assinatura e do payload; o processamento pelo agente continua de forma assíncrona. Se precisar de um caminho personalizado, defina channels.line.webhookPath ou channels.line.accounts.<id>.webhookPath e atualize a URL de acordo.

Observações de segurança:

  • A verificação de assinatura do LINE depende do corpo (HMAC sobre o corpo bruto), portanto, o OpenClaw aplica um limite estrito de corpo antes da autenticação (64 KB) e um tempo limite de leitura antes da verificação.
  • O OpenClaw processa os eventos do Webhook a partir dos bytes brutos da solicitação verificada. Valores req.body transformados por middleware upstream são ignorados para preservar a integridade da assinatura.

Configuração

Configuração mínima:

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

Configuração de mensagens diretas públicas:

json5
{  channels: {    line: {      enabled: true,      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",      channelSecret: "LINE_CHANNEL_SECRET",      dmPolicy: "open",      allowFrom: ["*"],    },  },}

Variáveis de ambiente (somente para a conta padrão):

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

Arquivos de token/segredo:

json5
{  channels: {    line: {      tokenFile: "/path/to/line-token.txt",      secretFile: "/path/to/line-secret.txt",    },  },}

tokenFile e secretFile devem apontar para arquivos comuns. Links simbólicos são rejeitados. Os valores de configuração embutidos têm precedência sobre os arquivos; as variáveis de ambiente são o último fallback para a conta padrão.

Várias contas:

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

Controle de acesso

Por padrão, as mensagens diretas usam pareamento. Remetentes desconhecidos recebem um código de pareamento, e suas mensagens são ignoradas até a aprovação:

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

Listas de permissões e políticas:

  • channels.line.dmPolicy: pairing | allowlist | open | disabled (padrão: pairing)
  • channels.line.allowFrom: IDs de usuário do LINE permitidos para mensagens diretas; dmPolicy: "open" exige ["*"]
  • channels.line.groupPolicy: allowlist | open | disabled (padrão: allowlist)
  • channels.line.groupAllowFrom: IDs de usuário do LINE permitidos para grupos; as entradas allowFrom de mensagens diretas não autorizam remetentes de grupos
  • Substituições por grupo: channels.line.groups.<groupId>.allowFrom (além de enabled, requireMention, systemPrompt, skills). Com groupPolicy: "allowlist", defina groupAllowFrom ou o allowFrom específico do grupo; uma lista de permissões de grupo vazia bloqueia mensagens de grupo mesmo quando as mensagens diretas estão abertas.
  • Grupos estáticos de acesso de remetentes podem ser referenciados em allowFrom, groupAllowFrom e no allowFrom específico do grupo com accessGroup:<name>; consulte Grupos de acesso.
  • Observação sobre o runtime: se channels.line estiver completamente ausente, o runtime usará groupPolicy="allowlist" como fallback para as verificações de grupo (mesmo que channels.defaults.groupPolicy esteja definido).

Os IDs do LINE diferenciam maiúsculas de minúsculas. IDs válidos têm a seguinte aparência:

  • Usuário: U + 32 caracteres hexadecimais
  • Grupo: C + 32 caracteres hexadecimais
  • Sala: R + 32 caracteres hexadecimais

Comportamento das mensagens

  • O texto é dividido em blocos de 5000 caracteres.
  • A formatação Markdown é removida; blocos de código e tabelas são convertidos em cartões Flex quando possível.
  • As respostas em streaming são armazenadas em buffer; o LINE recebe blocos completos com uma animação de carregamento enquanto o agente trabalha.
  • Os downloads de mídia são limitados por channels.line.mediaMaxMb (padrão: 10).
  • A mídia recebida é salva em ~/.openclaw/media/inbound/ antes de ser encaminhada ao agente, correspondendo ao armazenamento de mídia compartilhado usado por outros plugins de canal.

Dados do canal (mensagens avançadas)

Use channelData.line para enviar respostas rápidas, localizações, cartões Flex ou mensagens de modelo.

json5
{  text: "Aqui está",  channelData: {    line: {      quickReplies: ["Status", "Ajuda"],      location: {        title: "Escritório",        address: "123 Main St",        latitude: 35.681236,        longitude: 139.767125,      },      flexMessage: {        altText: "Cartão de status",        contents: {/* Payload Flex */},      },      templateMessage: {        type: "confirm",        text: "Continuar?",        confirmLabel: "Sim",        confirmData: "yes",        cancelLabel: "Não",        cancelData: "no",      },    },  },}

O plugin do LINE também inclui um comando /card para predefinições de mensagens Flex:

text
/card info "Boas-vindas" "Agradecemos por participar!"

Suporte a ACP

O LINE oferece suporte a vinculações de conversas ACP (Agent Communication Protocol):

  • /acp spawn <agent> --bind here vincula a conversa atual do LINE a uma sessão ACP sem criar uma thread secundária.
  • As vinculações ACP configuradas e as sessões ACP ativas vinculadas a conversas funcionam no LINE como em outros canais de conversa.

Consulte Agentes ACP para obter detalhes.

Mídia de saída

O plugin do LINE envia imagens, vídeos e áudio por meio da ferramenta de mensagens do agente:

  • Imagens: enviadas como mensagens de imagem do LINE; por padrão, a imagem de pré-visualização usa a URL da mídia.
  • Vídeos: exigem uma imagem de pré-visualização; defina channelData.line.previewImageUrl como uma URL de imagem.
  • Áudio: enviado como mensagens de áudio do LINE; a duração padrão é de 60 segundos, a menos que channelData.line.durationMs esteja definido.

O tipo de mídia é obtido de channelData.line.mediaKind quando definido; caso contrário, ele é inferido das outras opções do LINE ou do sufixo do arquivo na URL, usando imagem como fallback.

As URLs de mídia de saída devem ser URLs HTTPS públicas com no máximo 2000 caracteres. O OpenClaw valida o nome do host de destino antes de encaminhar a URL ao LINE e rejeita destinos de loopback, link-local e de redes privadas.

Envios genéricos de mídia sem opções específicas do LINE usam a rota de imagem.

Solução de problemas

  • A verificação do Webhook falha: verifique se a URL do Webhook usa HTTPS e se channelSecret corresponde ao Console do LINE.
  • Nenhum evento de entrada: confirme se o caminho do Webhook corresponde a channels.line.webhookPath e se o Gateway pode ser acessado pelo LINE.
  • Erros no download de mídia: aumente channels.line.mediaMaxMb se a mídia exceder o limite padrão.

Conteúdo relacionado

Was this useful?
On this page

On this page