Skip to main content

LINE (plugin)

LINE ansluter till OpenClaw via LINE Messaging API. Pluginen körs som en webhook mottagare på gateway och använder din kanal åtkomsttoken + kanal hemlighet för autentisering. Status: stöds via plugin. Direktmeddelanden, gruppchattar, media, platser, Flex meddelanden, mallmeddelanden och snabba svar stöds. Reaktioner och trådar stöds inte.

Plugin krävs

Installera LINE‑pluginen:
Lokal utcheckning (vid körning från ett git‑repo):

Konfigurering

  1. Skapa ett LINE Developers‑konto och öppna konsolen: https://developers.line.biz/console/
  2. Skapa (eller välj) en Provider och lägg till en Messaging API‑kanal.
  3. Kopiera Channel access token och Channel secret från kanalinställningarna.
  4. Aktivera Use webhook i inställningarna för Messaging API.
  5. Ställ in webhook‑URL:en till din gateway‑endpoint (HTTPS krävs):
Gateway svarar på LINE: s webhook verifiering (GET) och inkommande händelser (POST). Om du behöver en anpassad sökväg, ange channels.line.webhookPath eller channels.line.accounts.<id>.webhookPath och uppdatera URL därefter.

Konfiguration

Minimal konfig:
Miljövariabler (endast standardkonto):
  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET
Token-/hemlighetsfiler:
Flera konton:

Åtkomstkontroll

Direktmeddelanden standard att para ihop. Okända avsändare får en parningskod och deras -meddelanden ignoreras tills de godkänts.
Tillåtelselistor och policyer:
  • channels.line.dmPolicy: pairing | allowlist | open | disabled
  • channels.line.allowFrom: tillåtelselista med LINE‑användar‑ID:n för DM
  • channels.line.groupPolicy: allowlist | open | disabled
  • channels.line.groupAllowFrom: tillåtelselista med LINE‑användar‑ID:n för grupper
  • Åsidosätter per grupp: channels.line.groups.<groupId>.allowFrom
LINE-ID är skiftlägeskänsliga. Giltiga ID ser ut som:
  • Användare: U + 32 hex‑tecken
  • Grupp: C + 32 hex‑tecken
  • Rum: R + 32 hex‑tecken

Meddelandebeteende

  • Text delas upp i segment om 5000 tecken.
  • Markdown‑formatering tas bort; kodblock och tabeller konverteras till Flex‑ kort när det är möjligt.
  • Strömmande svar buffras; LINE tar emot hela segment med en laddnings‑ animation medan agenten arbetar.
  • Nedladdning av media begränsas av channels.line.mediaMaxMb (standard 10).

Kanaldata (rika meddelanden)

Använd channelData.line för att skicka snabbsvar, platser, Flex‑kort eller mallmeddelanden.
LINE‑pluginen levereras även med ett /card‑kommando för förinställningar av Flex‑meddelanden:

Felsökning

  • Webhook‑verifiering misslyckas: säkerställ att webhook‑URL:en är HTTPS och att channelSecret matchar LINE‑konsolen.
  • Inga inkommande händelser: bekräfta att webhook‑sökvägen matchar channels.line.webhookPath och att gatewayen är nåbar från LINE.
  • Fel vid nedladdning av media: höj channels.line.mediaMaxMb om media överskrider standardgränsen.