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 gerekir):

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 sıkı ön kimlik doğrulama gövde sınırları ve zaman aşımı uygular.
• OpenClaw, webhook olaylarını doğrulanmış ham istek baytlarından işler. Üst katman ara yazılımları 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

{
  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
• channels.line.allowFrom: DM’ler için izin listesindeki LINE kullanıcı kimlikleri; dmPolicy: "open" için ["*"] gerekir
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: gruplar için izin listesindeki LINE kullanıcı kimlikleri
• 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.
• Çalışma zamanı notu: channels.line tamamen eksikse, çalışma zamanı grup denetimleri için groupPolicy="allowlist" değerine geri döner (channels.defaults.groupPolicy ayarlanmış olsa bile).

• 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 karakterde 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 tam parçaları bir yükleme animasyonuyla alır.
• Medya indirmeleri channels.line.mediaMaxMb ile sınırlıdır (varsayılan 10).
• Gelen medya, diğer paketli kanal Plugin’leri tarafından kullanılan paylaşılan medya deposuyla eşleşecek şekilde agent’a aktarılmadan önce ~/.openclaw/media/inbound/ altında kaydedilir.

​

Kanal verileri (zengin mesajlar)

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

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

​

ACP desteği

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

​

Giden medya

• Resimler: otomatik önizleme oluşturmayla LINE resim mesajları olarak gönderilir.
• Videolar: açık önizleme ve içerik türü işleme ile gönderilir.
• Ses: LINE ses mesajları olarak gönderilir.

​

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’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 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 kapısı
• Kanal Yönlendirme — mesajlar için oturum yönlendirme
• Güvenlik — erişim modeli ve sağlamlaştırma