Nextcloud Talk
Nextcloud Talk: estado de soporte, capacidades y configuración.
Estado: Soportado vía plugin (bot webhook). Soporta DMs, salas, reacciones y mensajes Markdown.
Instalación de Plugin Requerida
Nextcloud Talk se proporciona como plugin y no viene incluido con la instalación core.
Instalar vía CLI (registro npm):
openclaw plugins install @openclaw/nextcloud-talk
Instalación local (cuando se ejecuta desde un repositorio git):
openclaw plugins install ./extensions/nextcloud-talk
Si seleccionaste Nextcloud Talk en configure/onboarding y se detecta un checkout git, OpenClaw automáticamente proporcionará la ruta de instalación local.
Detalles: ''/plugin''
Configuración Rápida
1. Instalar plugin de Nextcloud Talk.
2. Crear un bot en tu servidor Nextcloud:
{
channels: {
"nextcloud-talk": {
enabled: true,
baseUrl: "https://cloud.ejemplo.com",
botSecret: "secreto-compartido",
dmPolicy: "pairing",
},
},
}Notas
- El bot no puede iniciar DMs: el usuario debe enviar el primer mensaje al bot.
- La URL del webhook debe ser accesible por el Gateway; si está detrás de proxy reverso, establece <code>webhookPublicUrl</code>.
- La API del bot no soporta subida de medios; los medios se envían como URLs.
- El payload del webhook no distingue "DM vs sala"; para distinguir, establece <code>apiUser</code> + <code>apiPassword</code> para consultas de tipo de sala (de lo contrario los DMs se tratan como salas).
Control de Acceso (DMs)
- Por defecto: <code>channels.nextcloud-talk.dmPolicy = "pairing"</code>. Los remitentes desconocidos reciben un código de emparejamiento.
- Aprobar:
- <code>openclaw pairing list nextcloud-talk</code>
- <code>openclaw pairing approve nextcloud-talk <CÓDIGO></code>
- DMs abiertos: <code>channels.nextcloud-talk.dmPolicy="open"</code> y <code>channels.nextcloud-talk.allowFrom=["*"]</code>.
Salas (Chats de Grupo)
- Por defecto: <code>channels.nextcloud-talk.groupPolicy = "allowlist"</code> (y requiere mención por defecto).
- Usar <code>channels.nextcloud-talk.rooms</code> para lista permitida de salas:
{
channels: {
"nextcloud-talk": {
rooms: {
"token-sala": { requireMention: true },
},
},
},
}- Para no procesar ninguna sala: mantener lista permitida vacía, o establecer <code>channels.nextcloud-talk.groupPolicy="disabled"</code>.
Capacidades
| Característica | Estado |
| -- |
| DMs | Soportado|
| Salas | Soportado|
| Hilos | No soportado|
| Medios | Solo URL|
| Reacciones | Soportado|
| Comandos nativos | No soportado|
Referencia de Configuración (Nextcloud Talk)
Configuración completa: ''/gateway/configuration''
Opciones del proveedor:
- <code>channels.nextcloud-talk.enabled</code>: habilitar/deshabilitar
- <code>channels.nextcloud-talk.baseUrl</code>: URL de instancia Nextcloud
- <code>channels.nextcloud-talk.botSecret</code>: secreto compartido del bot
- <code>channels.nextcloud-talk.botSecretFile</code>: ruta del archivo de secreto
- <code>channels.nextcloud-talk.apiUser</code>: usuario API para búsquedas de sala (identificación DM)
- <code>channels.nextcloud-talk.apiPassword</code>: contraseña API/app para búsquedas de sala
- <code>channels.nextcloud-talk.apiPasswordFile</code>: ruta del archivo de contraseña API
- <code>channels.nextcloud-talk.webhookPort</code>: puerto de escucha del webhook (por defecto 8788)
- <code>channels.nextcloud-talk.webhookHost</code>: host del webhook (por defecto 0.0.0.0)
- <code>channels.nextcloud-talk.webhookPath</code>: ruta del webhook (por defecto <code>/nextcloud-talk-webhook</code>)
- <code>channels.nextcloud-talk.webhookPublicUrl</code>: URL del webhook accesible externamente
- <code>channels.nextcloud-talk.dmPolicy</code>: <code>pairing | allowlist | open | disabled</code>
- <code>channels.nextcloud-talk.allowFrom</code>: lista permitida de DM (IDs de usuario); abierto requiere <code>"*"</code>
- <code>channels.nextcloud-talk.groupPolicy</code>: <code>allowlist | open | disabled</code>
- <code>channels.nextcloud-talk.groupAllowFrom</code>: lista permitida de remitentes de grupo (IDs de usuario)
- <code>channels.nextcloud-talk.rooms</code>: configuración por sala y lista permitida
- <code>channels.nextcloud-talk.historyLimit</code>: contador de historial de grupo (<code>0</code> deshabilita)
- <code>channels.nextcloud-talk.dmHistoryLimit</code>: contador de historial DM (<code>0</code> deshabilita)
ChannelsNextcloudTalkPage.step07.p21
ChannelsNextcloudTalkPage.step07.p22
ChannelsNextcloudTalkPage.step07.p23
ChannelsNextcloudTalkPage.step07.p24
ChannelsNextcloudTalkPage.step07.p25
ChannelsNextcloudTalkPage.step07.p26