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

Regional platforms

LINE

LINE, LINE Messaging API aracılığıyla OpenClaw'a bağlanır. Plugin, Gateway üzerinde bir Webhook alıcısı olarak çalışır ve kimlik doğrulama için kanal erişim belirtecinizi + kanal gizli anahtarınızı kullanır.

Durum: Ayrı olarak kurulan resmî 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 çalışma kopyası (bir git deposundan çalıştırırken):

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

Ayarlama

  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ız olarak ayarlayın (HTTPS gereklidir):
text
https://gateway-host/line/webhook

Gateway, LINE'ın Webhook doğrulamasını (GET) yanıtlar ve imza ile veri yükü doğrulamasının hemen ardından imzalı gelen olayları (POST) kabul eder; agent işlemesi eşzamansız olarak devam eder. Özel bir yola ihtiyacınız varsa channels.line.webhookPath veya channels.line.accounts.<id>.webhookPath değerini ayarlayın ve URL'yi buna göre güncelleyin.

Güvenlik notları:

  • LINE imza doğrulaması gövdeye bağlıdır (ham gövde üzerinden HMAC), bu nedenle OpenClaw doğrulamadan önce katı bir kimlik doğrulama öncesi gövde sınırı (64 KB) ve okuma zaman aşımı uygular.
  • OpenClaw, Webhook olaylarını doğrulanmış ham istek baytlarından işler. Üst katman ara yazılımı tarafından dönüştürülen 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: ["*"],    },  },}

Ortam değişkenleri (yalnızca varsayılan hesap):

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

Belirteç/gizli anahtar 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. Satır içi yapılandırma değerleri dosyalara göre önceliklidir; ortam değişkenleri varsayılan hesap için son geri dönüş seçeneğidir.

Birden fazla hesap:

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

Erişim denetimi

Doğrudan mesajlar varsayılan olarak eşleştirmeyi kullanır. Bilinmeyen gönderenler bir eşleştirme kodu alır ve onaylanana kadar mesajları yok sayılır:

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

İzin listeleri ve ilkeler:

  • channels.line.dmPolicy: pairing | allowlist | open | disabled (varsayılan pairing)
  • channels.line.allowFrom: DM'ler için izin listesindeki LINE kullanıcı kimlikleri; dmPolicy: "open" için ["*"] gereklidir
  • channels.line.groupPolicy: allowlist | open | disabled (varsayılan allowlist)
  • channels.line.groupAllowFrom: gruplar için izin listesindeki LINE kullanıcı kimlikleri
  • Grup başına geçersiz kılmalar: channels.line.groups.<groupId>.allowFrom (ayrıca enabled, requireMention, systemPrompt, skills)
  • Statik gönderen erişim gruplarına allowFrom, groupAllowFrom ve grup başına allowFrom içinden accessGroup:<name> ile başvurulabilir; bkz. Erişim grupları.
  • Çalışma zamanı notu: channels.line tamamen eksikse çalışma zamanı, grup denetimleri için (channels.defaults.groupPolicy ayarlanmış olsa bile) groupPolicy="allowlist" değerine geri döner.

LINE kimlikleri büyük/küçük harfe duyarlıdır. Geçerli kimlikler şu biçimdedir:

  • Kullanıcı: U + 32 onaltılık karakter
  • Grup: C + 32 onaltılık karakter
  • Oda: R + 32 onaltılık karakter

Mesaj davranışı

  • Metin, 5000 karakterlik parçalara bölünü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.
  • Akış yanıtları arabelleğe alınır; agent çalışırken LINE, bir yükleme animasyonuyla tam parçaları alır.
  • Medya indirmeleri channels.line.mediaMaxMb ile sınırlandırılır (varsayılan 10).
  • Gelen medya, diğer kanal Plugin'lerinin kullandığı ortak medya deposuyla uyumlu şekilde agent'a iletilmeden önce ~/.openclaw/media/inbound/ altına kaydedilir.

Kanal verileri (zengin mesajlar)

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

json5
{  text: "İşte burada",  channelData: {    line: {      quickReplies: ["Durum", "Yardım"],      location: {        title: "Ofis",        address: "123 Ana Cadde",        latitude: 35.681236,        longitude: 139.767125,      },      flexMessage: {        altText: "Durum kartı",        contents: {/* Flex veri yükü */},      },      templateMessage: {        type: "confirm",        text: "Devam edilsin mi?",        confirmLabel: "Evet",        confirmData: "yes",        cancelLabel: "Hayır",        cancelData: "no",      },    },  },}

LINE Plugin'i ayrıca Flex mesajı ön ayarları için bir /card komutuyla gelir:

text
/card info "Hoş geldiniz" "Katıldığınız için teşekkürler!"

ACP desteği

LINE, ACP (Agent İletişim Protokolü) konuşma bağlamalarını destekler:

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

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

Giden medya

LINE Plugin'i, agent mesaj aracı üzerinden görüntü, video ve ses gönderir:

  • Görüntüler: LINE görüntü mesajları olarak gönderilir; önizleme görüntüsü varsayılan olarak medya URL'sini kullanır.
  • Videolar: Bir önizleme görüntüsü gerektirir; channelData.line.previewImageUrl değerini bir görüntü URL'si olarak ayarlayın.
  • Ses: LINE ses mesajları olarak gönderilir; channelData.line.durationMs ayarlanmadığı sürece süre varsayılan olarak 60 saniyedir.

Medya türü, ayarlanmışsa channelData.line.mediaKind değerinden alınır; aksi takdirde diğer LINE seçeneklerinden veya URL dosya uzantısından çıkarılır ve geri dönüş olarak görüntü kullanılır.

Giden medya URL'leri, en fazla 2000 karakter uzunluğunda, herkese açık HTTPS URL'leri olmalıdır. OpenClaw, URL'yi LINE'a vermeden önce hedef ana bilgisayar adını doğrular ve local loopback, bağlantı-yerel ve özel ağ hedeflerini reddeder.

LINE'a özgü seçenekler olmadan yapılan genel medya gönderimleri görüntü yolunu kullanır.

Sorun giderme

  • Webhook doğrulaması başarısız oluyor: Webhook URL'sinin HTTPS kullandığından ve channelSecret değerinin LINE Console ile eşleştiğinden emin olun.
  • Gelen olay yok: Webhook yolunun channels.line.webhookPath ile eşleştiğini ve Gateway'e LINE'dan erişilebildiğini 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?
On this page

On this page