Conecta Nextcloud Talk a OpenClaw: Guía de configuración

¿Alguna vez has intentado conectar tus herramientas de automatización con tu propia infraestructura y te has encontrado con muros de configuración interminables? Configurar un bot que respete la privacidad y se integre bien con tu nube personal no debería ser un proceso frustrante ni requerir horas de depuración.

Si usas Nextcloud para gestionar tus datos, integrar sus capacidades de chat en tu flujo de trabajo es el siguiente paso lógico. Aquí tienes cómo poner en marcha el plugin de Nextcloud Talk para que tu Gateway empiece a procesar mensajes sin complicaciones.

Nextcloud Talk (plugin)

Estado: soportado mediante plugin (webhook bot). Soporta mensajes directos, salas, reacciones y mensajes en markdown.

Plugin requerido

Nextcloud Talk funciona como un plugin y no viene incluido en la instalación core.

Instalación mediante CLI (npm registry):

openclaw plugins install @openclaw/nextcloud-talk

Local checkout (cuando ejecutas desde un repositorio git):

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

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

Detalles: Plugins

Configuración rápida (principiantes)

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. Activa el bot en los ajustes de la sala de destino.

4. Configura OpenClaw:

   • Config: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • O env: NEXTCLOUD_TALK_BOT_SECRET (solo para la cuenta por defecto)

5. Reinicia el Gateway (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 DMs. El usuario debe enviar un mensaje al bot primero.
• La URL del webhook debe ser accesible por el Gateway; configura webhookPublicUrl si estás detrás de un proxy.
• La API del bot no soporta la subida de archivos multimedia; los archivos se envían como URLs.
• El payload del webhook no distingue entre DMs y salas; configura apiUser + apiPassword para permitir la búsqueda del tipo de sala (de lo contrario, los DMs se tratan como salas).

Control de acceso (DMs)

• Por defecto: channels.nextcloud-talk.dmPolicy = "pairing". Los remitentes desconocidos reciben un código de emparejamiento.
• Aprobar mediante:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• DMs 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 de pantalla se ignoran.

Salas (grupos)

• Por defecto: channels.nextcloud-talk.groupPolicy = "allowlist" (restringido por mención).
• Añade salas a la allowlist con channels.nextcloud-talk.rooms:

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

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

Capacidades

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

Referencia de configuración (Nextcloud Talk)

Configuración completa: Configuration

Opciones del proveedor:

• 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.
• channels.nextcloud-talk.botSecretFile: ruta al archivo del secreto. Se rechazan los symlinks.
• channels.nextcloud-talk.apiUser: usuario de la API para búsqueda de salas (detección de DM).
• channels.nextcloud-talk.apiPassword: contraseña de aplicación o API para búsqueda de salas.
• channels.nextcloud-talk.apiPasswordFile: ruta al archivo de contraseña de la API.
• channels.nextcloud-talk.webhookPort: puerto de escucha del webhook (por defecto: 8788).
• channels.nextcloud-talk.webhookHost: host del webhook (por defecto: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: ruta del webhook (por defecto: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: URL del webhook accesible externamente.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom: allowlist para DM (IDs de usuario). open requiere "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: allowlist para grupos (IDs de usuario).
• channels.nextcloud-talk.rooms: ajustes por sala y allowlist.
• channels.nextcloud-talk.historyLimit: límite de historial de grupo (0 lo desactiva).
• channels.nextcloud-talk.dmHistoryLimit: límite de historial de DM (0 lo desactiva).
• channels.nextcloud-talk.dms: sobrescrituras por DM (historyLimit).
• channels.nextcloud-talk.textChunkLimit: tamaño de fragmento de texto de salida (caracteres).
• channels.nextcloud-talk.chunkMode: length (por defecto) o newline para dividir en líneas en blanco antes de fragmentar por longitud.
• channels.nextcloud-talk.blockStreaming: desactiva el streaming de bloques para este canal.
• channels.nextcloud-talk.blockStreamingCoalesce: ajuste de unión de streaming de bloques.
• channels.nextcloud-talk.mediaMaxMb: límite de archivos multimedia entrantes (MB).

Relacionado

• Vista general de canales — todos los canales soportados
• Emparejamiento — flujo de autenticación de DM y pairing
• Grupos — comportamiento de chats grupales y restricción por mención
• Enrutamiento de canales — enrutamiento de sesiones para mensajes
• Seguridad — modelo de acceso y endurecimiento

AI Setup Assistant