Nextcloud Talk

​

Instalación

openclaw plugins install @openclaw/nextcloud-talk

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

​

Configuración rápida (principiantes)

1. Instale el plugin (consulte la sección anterior).
2. En el servidor Nextcloud, cree un bot:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
   Mantenga --feature response: sin esta opción, las respuestas salientes fallan con el código 401. Repare un bot existente con ./occ talk:bot:state --feature webhook --feature response --feature reaction <botId> 1.
3. Active el bot en la configuración de la sala de destino.
4. Configure OpenClaw:
   • Configuración: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • O mediante variables de entorno: NEXTCLOUD_TALK_BOT_SECRET (solo para la cuenta predeterminada)
   Configuración mediante la CLI (--url/--token son alias de los campos explícitos; nc-talk y nc funcionan como alias del canal):
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   Campos explícitos equivalentes:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   Secreto almacenado en un archivo:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-secret
   
5. Reinicie el Gateway (o finalice la configuración).

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

​

Notas

• Los bots no pueden iniciar mensajes directos. El usuario debe enviar primero un mensaje al bot.
• La URL del Webhook debe ser accesible desde el servidor Nextcloud; establezca webhookPublicUrl cuando el Gateway se encuentre detrás de un proxy. Las solicitudes del Webhook se firman mediante HMAC-SHA256 con el secreto del bot; las firmas no válidas se rechazan y se someten a limitación de frecuencia.
• La API del bot no admite la carga de archivos multimedia; los archivos multimedia salientes se añaden como una línea Attachment: <url>.
• La carga útil del Webhook no distingue los mensajes directos de las salas; establezca apiUser + apiPassword para activar las consultas del tipo de sala (se almacenan en caché durante unos 5 minutos). Sin estas opciones, todas las conversaciones se tratan como salas.
• Las solicitudes salientes pasan por la protección contra SSRF. Para un host Nextcloud situado en una red privada o interna de confianza, habilítelo con channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: true.
• Cuando se establecen apiUser/apiPassword y webhookPublicUrl, openclaw channels status comprueba el bot y advierte si falta la función response.

​

Control de acceso (mensajes directos)

• Valor predeterminado: channels.nextcloud-talk.dmPolicy = "pairing". Los remitentes desconocidos reciben un código de emparejamiento.
• Apruebe mediante:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Mensajes directos públicos: channels.nextcloud-talk.dmPolicy="open" junto con channels.nextcloud-talk.allowFrom=["*"].
• allowFrom solo coincide con identificadores de usuario de Nextcloud (en minúsculas); los nombres para mostrar se ignoran.

​

Salas (grupos)

• Valor predeterminado: channels.nextcloud-talk.groupPolicy = "allowlist" (requiere una mención).
• Añada salas a la lista de permitidas con channels.nextcloud-talk.rooms, usando el token de la sala como clave; "*" establece un valor predeterminado comodín:

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

• Claves por sala: requireMention (valor predeterminado: true), enabled (false desactiva la sala), allowFrom (lista de remitentes permitidos por sala), tools (anulaciones de herramientas para permitir o denegar), skills (limita las Skills cargadas), systemPrompt.
• Para no permitir ninguna sala, mantenga vacía la lista de permitidas o establezca channels.nextcloud-talk.groupPolicy="disabled".

​

Capacidades

​

Referencia de configuración (Nextcloud Talk)

• channels.nextcloud-talk.enabled: activa o desactiva el inicio del canal.
• channels.nextcloud-talk.baseUrl: URL de la instancia de Nextcloud.
• channels.nextcloud-talk.botSecret: secreto compartido del bot (cadena o referencia a un secreto).
• channels.nextcloud-talk.botSecretFile: ruta del secreto en un archivo normal. Se rechazan los enlaces simbólicos.
• channels.nextcloud-talk.apiUser: usuario de la API para consultar salas (detección de mensajes directos) y comprobar el estado.
• channels.nextcloud-talk.apiPassword: contraseña de la API o de la aplicación para consultar salas.
• channels.nextcloud-talk.apiPasswordFile: ruta del archivo de la contraseña de la API.
• channels.nextcloud-talk.webhookPort: puerto del receptor del Webhook (valor predeterminado: 8788).
• channels.nextcloud-talk.webhookHost: host del Webhook (valor predeterminado: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: ruta del Webhook (valor predeterminado: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: URL del Webhook accesible externamente.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled (valor predeterminado: pairing). open requiere allowFrom=["*"].
• channels.nextcloud-talk.allowFrom: lista de mensajes directos permitidos (identificadores de usuario).
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled (valor predeterminado: allowlist).
• channels.nextcloud-talk.groupAllowFrom: lista de remitentes permitidos en las salas (identificadores de usuario); recurre a allowFrom si no se establece.
• channels.nextcloud-talk.rooms: configuración y lista de permitidos por sala (consulte la sección anterior).
• Se puede hacer referencia a grupos estáticos de acceso de remitentes desde allowFrom y groupAllowFrom mediante accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: límite del historial de grupos (0 lo desactiva).
• channels.nextcloud-talk.dmHistoryLimit: límite del historial de mensajes directos (0 lo desactiva).
• channels.nextcloud-talk.dms: anulaciones por mensaje directo, usando el identificador de usuario como clave (historyLimit).
• channels.nextcloud-talk.textChunkLimit: tamaño de los fragmentos de texto salientes en caracteres (valor predeterminado: 4000).
• channels.nextcloud-talk.streaming.chunkMode: length (valor predeterminado) o newline para dividir por líneas en blanco (límites de párrafos) antes de fragmentar por longitud.
• channels.nextcloud-talk.streaming.block.enabled: activa o desactiva la transmisión por bloques para este canal.
• channels.nextcloud-talk.streaming.block.coalesce: ajuste de la combinación de bloques durante la transmisión.
• channels.nextcloud-talk.responsePrefix: prefijo de las respuestas salientes.
• channels.nextcloud-talk.markdown.tables: modo de representación de tablas de Markdown (off | bullets | code | block).
• channels.nextcloud-talk.mediaMaxMb: límite de archivos multimedia entrantes (MB).
• channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: permite que los hosts privados o internos de Nextcloud superen la protección contra SSRF.
• channels.nextcloud-talk.accounts.<id>: anulaciones por cuenta (las mismas claves); defaultAccount selecciona la cuenta predeterminada. Las variables de entorno NEXTCLOUD_TALK_BOT_SECRET / NEXTCLOUD_TALK_API_PASSWORD solo se aplican a la cuenta predeterminada.

​

Contenido relacionado

• Descripción general de los canales — todos los canales compatibles
• Emparejamiento — autenticación de mensajes directos y flujo de emparejamiento
• Grupos — comportamiento de los chats grupales y requisito de menciones
• Enrutamiento de canales — enrutamiento de sesiones para mensajes
• Seguridad — modelo de acceso y refuerzo de la seguridad