English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Regional platforms

SATIR

LINE, OpenClaw'a LINE Messaging API üzerinden bağlanır. Plugin, gateway üzerinde bir webhook alıcısı olarak çalışır ve kimlik doğrulama için channel access token + channel secret değerlerinizi kullanır.

Durum: indirilebilir Plugin. Doğrudan mesajlar, grup sohbetleri, medya, konumlar, Flex mesajları, şablon mesajlar ve hızlı yanıtlar desteklenir. Tepkiler ve ileti dizileri desteklenmez.

Kurulum

Kanalı yapılandırmadan önce LINE'ı kurun:

bash
openclaw plugins install @openclaw/line

Yerel checkout (bir git repo'sundan çalıştırırken):

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

Kurulum

  1. Bir LINE Developers hesabı oluşturun ve Console'u açın: https://developers.line.biz/console/
  2. Bir Provider oluşturun (veya seçin) ve bir Messaging API kanalı ekleyin.
  3. Kanal ayarlarından Channel access token ve Channel secret değerlerini kopyalayın.
  4. Messaging API ayarlarında Use webhook seçeneğini etkinleştirin.
  5. Webhook URL'sini gateway uç noktanıza ayarlayın (HTTPS gerekir):
Code
https://gateway-host/line/webhook

Gateway, LINE'ın webhook doğrulamasına (GET) ve gelen olaylara (POST) yanıt verir. Özel bir path gerekiyorsa channels.line.webhookPath veya channels.line.accounts.<id>.webhookPath ayarlayın ve URL'yi buna göre güncelleyin.

Güvenlik notu:

  • LINE imza doğrulaması gövdeye bağlıdır (ham gövde üzerinde HMAC), bu nedenle OpenClaw doğrulamadan önce katı pre-auth gövde sınırları ve timeout uygular.
  • OpenClaw, webhook olaylarını doğrulanmış ham istek baytlarından işler. Upstream middleware tarafından dönüştürülmüş req.body değerleri, imza bütünlüğü güvenliği için yok sayılır.

Yapılandırma

En küçük yapılandırma:

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

Herkese açık DM yapılandırması:

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

Env vars (yalnızca varsayılan hesap):

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

Token/secret dosyaları:

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

tokenFile ve secretFile normal dosyalara işaret etmelidir. Sembolik bağlantılar reddedilir.

Birden çok hesap:

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

Erişim kontrolü

Doğrudan mesajlar varsayılan olarak pairing kullanır. Bilinmeyen gönderenler bir pairing kodu alır ve onaylanana kadar mesajları yok sayılır.

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

Allowlist'ler ve politikalar:

  • channels.line.dmPolicy: pairing | allowlist | open | disabled
  • channels.line.allowFrom: DM'ler için allowlist'e alınmış LINE kullanıcı ID'leri; dmPolicy: "open" için ["*"] gerekir
  • channels.line.groupPolicy: allowlist | open | disabled
  • channels.line.groupAllowFrom: gruplar için allowlist'e alınmış LINE kullanıcı ID'leri
  • Grup başına geçersiz kılmalar: channels.line.groups.<groupId>.allowFrom
  • Statik gönderen erişim gruplarına allowFrom, groupAllowFrom ve grup başına allowFrom içinden accessGroup:<name> ile başvurulabilir.
  • Runtime notu: channels.line tamamen eksikse runtime, grup denetimleri için groupPolicy="allowlist" değerine geri döner (channels.defaults.groupPolicy ayarlanmış olsa bile).

LINE ID'leri büyük/küçük harfe duyarlıdır. Geçerli ID'ler şöyle görünür:

  • Kullanıcı: U + 32 hex chars
  • Grup: C + 32 hex chars
  • Oda: R + 32 hex chars

Mesaj davranışı

  • Metin 5000 karakterde parçalara ayrılır.
  • Markdown biçimlendirmesi kaldırılır; kod blokları ve tablolar mümkün olduğunda Flex kartlarına dönüştürülür.
  • Streaming yanıtları arabelleğe alınır; agent çalışırken LINE tam parçaları bir yükleme animasyonuyla alır.
  • Medya indirmeleri channels.line.mediaMaxMb ile sınırlandırılır (varsayılan 10).
  • Gelen medya, agent'a iletilmeden önce ~/.openclaw/media/inbound/ altında kaydedilir; bu, diğer paketlenmiş kanal Plugin'leri tarafından kullanılan paylaşılan medya deposuyla eşleşir.

Kanal verileri (zengin mesajlar)

Hızlı yanıtlar, konumlar, Flex kartları veya şablon mesajları göndermek için channelData.line kullanın.

json5
{  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 ayrıca Flex mesaj ön ayarları için bir /card komutu sağlar:

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

ACP desteği

LINE, ACP (Agent Communication Protocol) konuşma bağlamalarını destekler:

  • /acp spawn <agent> --bind here, geçerli LINE sohbetini bir alt ileti dizisi oluşturmadan bir ACP oturumuna bağlar.
  • Yapılandırılmış ACP bağlamaları ve aktif konuşmaya bağlı ACP oturumları, diğer konuşma kanallarında olduğu gibi LINE üzerinde çalışır.

Ayrıntılar için ACP agent'ları bölümüne bakın.

Giden medya

LINE Plugin, agent mesaj aracı üzerinden resim, video ve ses dosyaları göndermeyi destekler. Medya, uygun önizleme ve izleme işlemleriyle LINE'a özgü teslimat path'i üzerinden gönderilir:

  • Resimler: otomatik önizleme oluşturma ile LINE resim mesajları olarak gönderilir.
  • Videolar: açık önizleme ve content-type işleme ile gönderilir.
  • Ses: LINE ses mesajları olarak gönderilir.

Giden medya URL'leri herkese açık HTTPS URL'leri olmalıdır. OpenClaw, URL'yi LINE'a teslim etmeden önce hedef hostname'i doğrular ve loopback, link-local ve private-network hedeflerini reddeder.

Genel medya gönderimleri, LINE'a özgü bir path kullanılamadığında mevcut yalnızca resim rotasına geri döner.

Sorun giderme

  • Webhook doğrulaması başarısız oluyor: webhook URL'sinin HTTPS olduğundan ve channelSecret değerinin LINE console ile eşleştiğinden emin olun.
  • Gelen olay yok: webhook path'inin channels.line.webhookPath ile eşleştiğini ve gateway'in LINE'dan erişilebilir olduğunu doğrulayın.
  • Medya indirme hataları: medya varsayılan sınırı aşıyorsa channels.line.mediaMaxMb değerini yükseltin.

İlgili

Was this useful?