Nextcloud Talk

Nextcloud Talk (plugin)

Estado: soportado a través de un plugin (bot de webhook). Los mensajes directos, las salas, las reacciones y los mensajes en markdown están soportados.

Plugin requerido

Nextcloud Talk se distribuye como un plugin y no se incluye con la instalación principal.

Instalar vía CLI (registro npm):

openclaw plugins install @openclaw/nextcloud-talk

Repositorio local (cuando se ejecuta desde un repositorio git):

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

Si eliges Nextcloud Talk durante la configuración y se detecta una comprobación de git, OpenClaw ofrecerá la ruta de instalación local automáticamente.

Detalles: Plugins

Configuración rápida (principiante)

1. Instala el plugin de Nextcloud Talk.

2. En tu servidor Nextcloud, crea un bot:

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

3. Habilita el bot en la configuración de la sala de destino.

4. Configura OpenClaw:

   • Config: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • O env: NEXTCLOUD_TALK_BOT_SECRET (solo cuenta predeterminada)

5. Reinicia la puerta de enlace (o termina la configuración).

Configuración mínima:

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

Notas

• Los bots no pueden iniciar MDs. El usuario debe enviarle un mensaje al bot primero.
• La URL del webhook debe ser accesible por la puerta de enlace (Gateway); establece webhookPublicUrl si está detrás de un proxy.
• Las subidas de medios no están soportadas por la API del bot; los medios se envían como URLs.
• El payload del webhook no distingue entre MDs y salas; establece apiUser + apiPassword para habilitar búsquedas de tipo de sala (de lo contrario, los MDs se tratan como salas).

Control de acceso (MDs)

• Predeterminado: channels.nextcloud-talk.dmPolicy = "pairing". Los remitentes desconocidos reciben un código de emparejamiento.
• Aprobar vía:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• MDs públicos: channels.nextcloud-talk.dmPolicy="open" más channels.nextcloud-talk.allowFrom=["*"].
• allowFrom coincide solo con los IDs de usuario de Nextcloud; los nombres para mostrar se ignoran.

Salas (grupos)

• Predeterminado: channels.nextcloud-talk.groupPolicy = "allowlist" (restringido por mención).
• Permitir salas con channels.nextcloud-talk.rooms:

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

• Para no permitir ninguna sala, mantén la lista de permitidos vacía o establece channels.nextcloud-talk.groupPolicy="disabled".

Capacidades

Característica	Estado
Mensajes directos	Soportado
Salas	Soportado
Hilos	No soportado
Medios	Solo URL
Reacciones	Soportado
Comandos nativos	No compatible

Referencia de configuración (Nextcloud Talk)

Configuración completa: Configuration

Opciones del proveedor:

• channels.nextcloud-talk.enabled: activar/desactivar el inicio del canal.
• channels.nextcloud-talk.baseUrl: URL de la instancia de Nextcloud.
• channels.nextcloud-talk.botSecret: secreto compartido del bot.
• channels.nextcloud-talk.botSecretFile: ruta del archivo secreto regular. Se rechazan los enlaces simbólicos.
• channels.nextcloud-talk.apiUser: usuario de API para búsquedas de salas (detección de MD).
• channels.nextcloud-talk.apiPassword: contraseña de API/aplicación para búsquedas de salas.
• channels.nextcloud-talk.apiPasswordFile: ruta del archivo de contraseña de API.
• channels.nextcloud-talk.webhookPort: puerto de escucha del webhook (predeterminado: 8788).
• channels.nextcloud-talk.webhookHost: host del webhook (predeterminado: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: ruta del webhook (predeterminado: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: URL del webhook accesible externamente.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom: lista de permitidos de MD (IDs de usuario). open requiere "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: lista de permitidos de grupos (IDs de usuario).
• channels.nextcloud-talk.rooms: configuración por sala y lista de permitidos.
• channels.nextcloud-talk.historyLimit: límite de historial de grupos (0 lo desactiva).
• channels.nextcloud-talk.dmHistoryLimit: límite de historial de MD (0 lo desactiva).
• channels.nextcloud-talk.dms: anulaciones por MD (historyLimit).
• channels.nextcloud-talk.textChunkLimit: tamaño del fragmento de texto saliente (caracteres).
• channels.nextcloud-talk.chunkMode: length (predeterminado) o newline para dividir en líneas en blanco (límites de párrafo) antes de la fragmentación por longitud.
• channels.nextcloud-talk.blockStreaming: desactivar la transmisión en bloque para este canal.
• channels.nextcloud-talk.blockStreamingCoalesce: ajuste de fusión de transmisión en bloque.
• channels.nextcloud-talk.mediaMaxMb: límite de medios entrantes (MB).

Relacionado

• Resumen de canales — todos los canales compatibles
• Emparejamiento — autenticación de MD y flujo de emparejamiento
• Grupos — comportamiento del chat de grupo y control de menciones
• Enrutamiento de canales — enrutamiento de sesión para mensajes
• Seguridad — modelo de acceso y endurecimiento