LINE

​

Kurulum

openclaw plugins install @openclaw/line

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ıza ayarlayın (HTTPS gereklidir):

https://gateway-host/line/webhook

• 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. İmza bütünlüğü güvenliği için üst katman ara yazılımı tarafından dönüştürülen req.body değerleri yok sayılır.

​

Yapılandırma

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

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

• LINE_CHANNEL_ACCESS_TOKEN
• LINE_CHANNEL_SECRET

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

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

​

Erişim denetimi

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled (varsayılan pairing)
• channels.line.allowFrom: DM’ler için izin verilen LINE kullanıcı kimlikleri; dmPolicy: "open", ["*"] gerektirir
• channels.line.groupPolicy: allowlist | open | disabled (varsayılan allowlist)
• channels.line.groupAllowFrom: gruplar için izin verilen LINE kullanıcı kimlikleri; DM allowFrom girdileri grup gönderenlerine izin vermez
• Grup başına geçersiz kılmalar: channels.line.groups.<groupId>.allowFrom (ayrıca enabled, requireMention, systemPrompt, skills). groupPolicy: "allowlist" ile groupAllowFrom veya grup başına allowFrom değerini ayarlayın; boş bir grup izin listesi, DM’ler açık olsa bile grup mesajlarını engeller.
• 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ı, channels.defaults.groupPolicy ayarlanmış olsa bile grup denetimleri için groupPolicy="allowlist" değerine geri döner.

• 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; ajan çalışırken LINE, yükleme animasyonuyla birlikte tam parçalar alır.
• Medya indirmeleri channels.line.mediaMaxMb ile sınırlandırılır (varsayılan 10).
• Gelen medya, ajana aktarılmadan önce ~/.openclaw/media/inbound/ altına kaydedilir; bu, diğer kanal Plugin’lerinin kullandığı ortak medya deposuyla aynıdır.

​

Kanal verileri (zengin mesajlar)

{
  text: "Buyurun",
  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 yükü */},
      },
      templateMessage: {
        type: "confirm",
        text: "Devam edilsin mi?",
        confirmLabel: "Evet",
        confirmData: "yes",
        cancelLabel: "Hayır",
        cancelData: "no",
      },
    },
  },
}

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

​

ACP desteği

• /acp spawn <agent> --bind here, 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ı, LINE’da diğer konuşma kanallarındaki gibi çalışır.

​

Giden medya

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

​

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 yolunun channels.line.webhookPath ile eşleştiğini ve Gateway’e LINE tarafından erişilebildiğini doğrulayın.
• Medya indirme hataları: Medya varsayılan sınırı aşıyorsa channels.line.mediaMaxMb değerini artırın.

​

İlgili

• Kanallara Genel Bakış — desteklenen tüm kanallar
• Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar — grup sohbeti davranışı ve bahsetme denetimi
• Kanal Yönlendirme — mesajlar için oturum yönlendirmesi
• Güvenlik — erişim modeli ve güvenliği sağlamlaştırma