​

Nextcloud Talk

​

Dołączony plugin

openclaw plugins install @openclaw/nextcloud-talk

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

​

Szybka konfiguracja (dla początkujących)

1. Upewnij się, że plugin Nextcloud Talk jest dostępny.
   • Bieżące spakowane wydania OpenClaw już go zawierają.
   • Starsze/niestandardowe instalacje mogą dodać go ręcznie za pomocą powyższych poleceń.
2. Na swoim serwerze Nextcloud utwórz bota:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction
   
3. Włącz bota w ustawieniach docelowego pokoju.
4. Skonfiguruj OpenClaw:
   • Konfiguracja: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Lub zmienna środowiskowa: NEXTCLOUD_TALK_BOT_SECRET (tylko konto domyślne)
5. Uruchom ponownie gateway (lub dokończ konfigurację).

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

​

Uwagi

• Boty nie mogą inicjować wiadomości prywatnych. Użytkownik musi najpierw napisać do bota.
• URL webhooka musi być osiągalny dla Gateway; ustaw webhookPublicUrl, jeśli używasz proxy.
• Przesyłanie multimediów nie jest obsługiwane przez API bota; multimedia są wysyłane jako URL-e.
• Ładunek webhooka nie rozróżnia wiadomości prywatnych i pokoi; ustaw apiUser + apiPassword, aby włączyć sprawdzanie typu pokoju (w przeciwnym razie wiadomości prywatne są traktowane jak pokoje).

​

Kontrola dostępu (wiadomości prywatne)

• Domyślnie: channels.nextcloud-talk.dmPolicy = "pairing". Nieznani nadawcy otrzymują kod parowania.
• Zatwierdzanie przez:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Publiczne wiadomości prywatne: channels.nextcloud-talk.dmPolicy="open" plus channels.nextcloud-talk.allowFrom=["*"].
• allowFrom dopasowuje tylko identyfikatory użytkowników Nextcloud; nazwy wyświetlane są ignorowane.

​

Pokoje (grupy)

• Domyślnie: channels.nextcloud-talk.groupPolicy = "allowlist" (z ograniczaniem do wzmianek).
• Dodaj pokoje do allowlisty za pomocą channels.nextcloud-talk.rooms:

{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}

• Aby nie zezwalać na żadne pokoje, pozostaw allowlistę pustą albo ustaw channels.nextcloud-talk.groupPolicy="disabled".

​

Możliwości

​

Dokumentacja konfiguracji (Nextcloud Talk)

• channels.nextcloud-talk.enabled: włączanie/wyłączanie uruchamiania kanału.
• channels.nextcloud-talk.baseUrl: URL instancji Nextcloud.
• channels.nextcloud-talk.botSecret: współdzielony sekret bota.
• channels.nextcloud-talk.botSecretFile: ścieżka do sekretu w zwykłym pliku. Dowiązania symboliczne są odrzucane.
• channels.nextcloud-talk.apiUser: użytkownik API do sprawdzania pokoi (wykrywanie wiadomości prywatnych).
• channels.nextcloud-talk.apiPassword: hasło API/aplikacji do sprawdzania pokoi.
• channels.nextcloud-talk.apiPasswordFile: ścieżka do pliku z hasłem API.
• channels.nextcloud-talk.webhookPort: port nasłuchiwania webhooków (domyślnie: 8788).
• channels.nextcloud-talk.webhookHost: host webhooka (domyślnie: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: ścieżka webhooka (domyślnie: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: zewnętrznie osiągalny URL webhooka.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom: allowlista wiadomości prywatnych (identyfikatory użytkowników). open wymaga "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: grupowa allowlista (identyfikatory użytkowników).
• channels.nextcloud-talk.rooms: ustawienia i allowlista dla poszczególnych pokoi.
• channels.nextcloud-talk.historyLimit: limit historii grupowej (0 wyłącza).
• channels.nextcloud-talk.dmHistoryLimit: limit historii wiadomości prywatnych (0 wyłącza).
• channels.nextcloud-talk.dms: nadpisania dla poszczególnych wiadomości prywatnych (historyLimit).
• channels.nextcloud-talk.textChunkLimit: rozmiar fragmentu tekstu wychodzącego (znaki).
• channels.nextcloud-talk.chunkMode: length (domyślnie) lub newline, aby dzielić po pustych wierszach (granice akapitów) przed dzieleniem według długości.
• channels.nextcloud-talk.blockStreaming: wyłączanie blokowego streamingu dla tego kanału.
• channels.nextcloud-talk.blockStreamingCoalesce: strojenie scalania blokowego streamingu.
• channels.nextcloud-talk.mediaMaxMb: limit multimediów przychodzących (MB).

​

Powiązane

• Przegląd kanałów — wszystkie obsługiwane kanały
• Parowanie — uwierzytelnianie wiadomości prywatnych i przepływ parowania
• Grupy — zachowanie czatów grupowych i ograniczanie do wzmianek
• Routing kanałów — routing sesji dla wiadomości
• Bezpieczeństwo — model dostępu i utwardzanie