SATIR

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Kurulum

openclaw plugins install @openclaw/line

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

https://gateway-host/line/webhook

• 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

{
  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 kontrolü

openclaw pairing list line
openclaw pairing approve line <CODE>

• 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).

• 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)

{
  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, 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.

​

Giden medya

• 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.

​

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

• Kanallara Genel Bakış — desteklenen tüm kanallar
• Pairing — DM kimlik doğrulaması ve pairing akışı
• Gruplar — grup sohbeti davranışı ve mention gating
• Kanal Yönlendirme — mesajlar için oturum yönlendirme
• Güvenlik — erişim modeli ve hardening