Regional platforms

LINHA

LINE se conecta ao OpenClaw pela LINE Messaging API. O plugin roda como um receptor de webhook no Gateway e usa seu token de acesso do canal + segredo do canal para autenticação.

Status: plugin baixável. Mensagens diretas, chats em grupo, mídia, localizações, mensagens Flex, mensagens de modelo e respostas rápidas são compatíveis. Reações e threads não são compatíveis.

Instalação

Instale LINE antes de configurar o canal:

openclaw plugins install @openclaw/line

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

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

Configuração

Crie uma conta LINE Developers e abra o Console: https://developers.line.biz/console/
Crie (ou escolha) um provedor e adicione um canal Messaging API.
Copie o Token de acesso do canal e o Segredo do canal nas configurações do canal.
Ative Usar webhook nas configurações da Messaging API.
Defina a URL do webhook para o endpoint do seu Gateway (HTTPS obrigatório):

https://gateway-host/line/webhook

O Gateway responde à verificação de webhook da LINE (GET) e a eventos recebidos (POST). Se precisar de um caminho personalizado, defina channels.line.webhookPath ou channels.line.accounts.<id>.webhookPath e atualize a URL conforme necessário.

Observação de segurança:

A verificação de assinatura da LINE depende do corpo (HMAC sobre o corpo bruto), portanto o OpenClaw aplica limites rígidos de corpo pré-autenticação e timeout antes da verificação.
O OpenClaw processa eventos de webhook a partir dos bytes brutos verificados da requisição. Valores de req.body transformados por middleware upstream são ignorados para segurança da integridade da assinatura.

Configurar

Configuração mínima:

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

Configuração de DM pública:

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

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

LINE_CHANNEL_ACCESS_TOKEN
LINE_CHANNEL_SECRET

Arquivos de token/segredo:

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

tokenFile e secretFile devem apontar para arquivos regulares. Symlinks são rejeitados.

Várias contas:

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

Controle de acesso

Mensagens diretas usam pareamento por padrão. Remetentes desconhecidos recebem um código de pareamento e suas mensagens são ignoradas até serem aprovados.

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

Listas de permissão e políticas:

channels.line.dmPolicy: pairing | allowlist | open | disabled
channels.line.allowFrom: IDs de usuário LINE permitidos para DMs; dmPolicy: "open" exige ["*"]
channels.line.groupPolicy: allowlist | open | disabled
channels.line.groupAllowFrom: IDs de usuário LINE permitidos para grupos
Substituições por grupo: channels.line.groups.<groupId>.allowFrom
Observação de runtime: se channels.line estiver completamente ausente, o runtime recorre a groupPolicy="allowlist" para verificações de grupo (mesmo se channels.defaults.groupPolicy estiver definido).

IDs LINE diferenciam maiúsculas de minúsculas. IDs válidos se parecem com:

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

Comportamento das mensagens

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.
Respostas em streaming são armazenadas em buffer; a LINE recebe blocos completos com uma animação de carregamento enquanto o agente trabalha.
Downloads de mídia são limitados por channels.line.mediaMaxMb (padrão 10).
Mídia recebida é salva em ~/.openclaw/media/inbound/ antes de ser passada ao agente, correspondendo ao armazenamento de mídia compartilhado usado por outros plugins de canal incluídos.

Dados do canal (mensagens avançadas)

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

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

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

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

Suporte a ACP

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

/acp spawn <agent> --bind here vincula o chat LINE atual a uma sessão ACP sem criar uma thread filha.
Vinculações ACP configuradas e sessões ACP ativas vinculadas a conversas funcionam na LINE como em outros canais de conversa.

Consulte agentes ACP para obter detalhes.

Mídia de saída

O plugin LINE oferece suporte ao envio de imagens, vídeos e arquivos de áudio pela ferramenta de mensagens do agente. A mídia é enviada pelo caminho de entrega específico da LINE com tratamento apropriado de pré-visualização e rastreamento:

Imagens: enviadas como mensagens de imagem da LINE com geração automática de pré-visualização.
Vídeos: enviados com tratamento explícito de pré-visualização e tipo de conteúdo.
Áudio: enviado como mensagens de áudio da LINE.

URLs de mídia de saída devem ser URLs HTTPS públicas. O OpenClaw valida o hostname de destino antes de entregar a URL à LINE e rejeita destinos loopback, link-local e de rede privada.

Envios genéricos de mídia recorrem à rota existente somente para imagens quando um caminho específico da LINE não está disponível.

Solução de problemas

A verificação do webhook falha: verifique se a URL do webhook usa HTTPS e se o channelSecret corresponde ao console da LINE.
Nenhum evento recebido: confirme que o caminho do webhook corresponde a channels.line.webhookPath e que o Gateway está acessível pela LINE.
Erros de download de mídia: aumente channels.line.mediaMaxMb se a mídia exceder o limite padrão.

Relacionado

Visão geral dos canais — todos os canais compatíveis
Pareamento — autenticação de DM e fluxo de pareamento
Grupos — comportamento de chat em grupo e bloqueio por menção
Roteamento de canais — roteamento de sessão para mensagens
Segurança — modelo de acesso e hardening

# Instalação

# Configuração

# Configurar

# Controle de acesso

# Comportamento das mensagens

# Dados do canal (mensagens avançadas)

# Suporte a ACP

# Mídia de saída

# Solução de problemas

# Relacionado