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

Developer and self-hosted

Nextcloud Talk

Durum: birlikte gelen Plugin (Webhook botu). Doğrudan mesajlar, odalar, reaksiyonlar ve markdown mesajları desteklenir.

Birlikte gelen Plugin

Nextcloud Talk, mevcut OpenClaw sürümlerinde birlikte gelen bir Plugin olarak sunulur; bu nedenle normal paketlenmiş derlemeler ayrı bir kurulum gerektirmez.

Daha eski bir derleme kullanıyorsanız veya Nextcloud Talk’ı hariç tutan özel bir kurulumdaysanız, npm paketini doğrudan kurun:

CLI ile kurulum (npm registry):

openclaw plugins install @openclaw/nextcloud-talk

Mevcut resmi sürüm etiketini takip etmek için yalın paketi kullanın. Kesin bir sürümü yalnızca tekrarlanabilir bir kurulum gerektiğinde sabitleyin.

Yerel checkout (bir git deposundan çalıştırırken):

openclaw plugins install ./path/to/local/nextcloud-talk-plugin

Ayrıntılar: Pluginler

Hızlı kurulum (başlangıç)

  1. Nextcloud Talk Plugininin kullanılabilir olduğundan emin olun.

    • Mevcut paketlenmiş OpenClaw sürümleri bunu zaten birlikte sunar.
    • Daha eski/özel kurulumlar, yukarıdaki komutlarla bunu elle ekleyebilir.

  2. Nextcloud sunucunuzda bir bot oluşturun:

    ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction

  3. Hedef oda ayarlarında botu etkinleştirin.

  4. OpenClaw’ı yapılandırın:

    • Yapılandırma: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
    • Veya env: NEXTCLOUD_TALK_BOT_SECRET (yalnızca varsayılan hesap)

    CLI kurulumu:

    openclaw channels add --channel nextcloud-talk \
  --url https://cloud.example.com \
  --token "<shared-secret>"

    Eşdeğer açık alanlar:

    openclaw channels add --channel nextcloud-talk \
  --base-url https://cloud.example.com \
  --secret "<shared-secret>"

    Dosya destekli gizli değer:

    openclaw channels add --channel nextcloud-talk \
  --base-url https://cloud.example.com \
  --secret-file /path/to/nextcloud-talk-secret

  5. Gateway’i yeniden başlatın (veya kurulumu tamamlayın).

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

{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing",
    },
  },
}

Notlar

  • Botlar DM başlatamaz. Kullanıcı önce bota mesaj göndermelidir.
  • Webhook URL’sine Gateway tarafından erişilebilmelidir; bir proxy arkasındaysa webhookPublicUrl değerini ayarlayın.
  • Medya yüklemeleri bot API’si tarafından desteklenmez; medya URL olarak gönderilir.
  • Webhook yükü DM’leri ve odaları ayırt etmez; oda türü aramalarını etkinleştirmek için apiUser + apiPassword ayarlayın (aksi halde DM’ler oda olarak ele alınır).

Erişim denetimi (DM’ler)

  • Varsayılan: channels.nextcloud-talk.dmPolicy = "pairing". Bilinmeyen göndericiler bir eşleştirme kodu alır.
  • Şununla onaylayın:
    • openclaw pairing list nextcloud-talk
    • openclaw pairing approve nextcloud-talk &lt;CODE&gt;
  • Herkese açık DM’ler: channels.nextcloud-talk.dmPolicy="open" artı channels.nextcloud-talk.allowFrom=["*"].
  • allowFrom yalnızca Nextcloud kullanıcı kimlikleriyle eşleşir; görünen adlar yok sayılır.

Odalar (gruplar)

  • Varsayılan: channels.nextcloud-talk.groupPolicy = "allowlist" (bahsetme gerektirir).
  • channels.nextcloud-talk.rooms ile odaları izin listesine alın:
{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}
  • Hiçbir odaya izin vermemek için izin listesini boş tutun veya channels.nextcloud-talk.groupPolicy="disabled" ayarlayın.

Yetenekler

Özellik Durum
Doğrudan mesajlar Desteklenir
Odalar Desteklenir
Konular Desteklenmez
Medya Yalnızca URL
Reaksiyonlar Desteklenir
Yerel komutlar Desteklenmez

Yapılandırma referansı (Nextcloud Talk)

Tam yapılandırma: Yapılandırma

Sağlayıcı seçenekleri:

  • channels.nextcloud-talk.enabled: kanal başlangıcını etkinleştir/devre dışı bırak.
  • channels.nextcloud-talk.baseUrl: Nextcloud örneği URL’si.
  • channels.nextcloud-talk.botSecret: bot paylaşılan gizli değeri.
  • channels.nextcloud-talk.botSecretFile: normal dosya gizli değer yolu. Sembolik bağlantılar reddedilir.
  • channels.nextcloud-talk.apiUser: oda aramaları için API kullanıcısı (DM algılama).
  • channels.nextcloud-talk.apiPassword: oda aramaları için API/uygulama parolası.
  • channels.nextcloud-talk.apiPasswordFile: API parola dosyası yolu.
  • channels.nextcloud-talk.webhookPort: Webhook dinleyici portu (varsayılan: 8788).
  • channels.nextcloud-talk.webhookHost: Webhook host’u (varsayılan: 0.0.0.0).
  • channels.nextcloud-talk.webhookPath: Webhook yolu (varsayılan: /nextcloud-talk-webhook).
  • channels.nextcloud-talk.webhookPublicUrl: dışarıdan erişilebilir Webhook URL’si.
  • channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
  • channels.nextcloud-talk.allowFrom: DM izin listesi (kullanıcı kimlikleri). open, "*" gerektirir.
  • channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
  • channels.nextcloud-talk.groupAllowFrom: grup izin listesi (kullanıcı kimlikleri).
  • channels.nextcloud-talk.rooms: oda bazlı ayarlar ve izin listesi.
  • channels.nextcloud-talk.historyLimit: grup geçmişi sınırı (0 devre dışı bırakır).
  • channels.nextcloud-talk.dmHistoryLimit: DM geçmişi sınırı (0 devre dışı bırakır).
  • channels.nextcloud-talk.dms: DM bazlı geçersiz kılmalar (historyLimit).
  • channels.nextcloud-talk.textChunkLimit: giden metin parçası boyutu (karakter).
  • channels.nextcloud-talk.chunkMode: uzunluk parçalamadan önce boş satırlarda (paragraf sınırları) bölmek için length (varsayılan) veya newline.
  • channels.nextcloud-talk.blockStreaming: bu kanal için blok akışını devre dışı bırak.
  • channels.nextcloud-talk.blockStreamingCoalesce: blok akışı birleştirme ayarı.
  • channels.nextcloud-talk.mediaMaxMb: gelen medya üst sınırı (MB).

İlgili