OpenClawSkills
GitHub
Canales • 5 min de lectura

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.

Tutorial.step

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):

Bash
openclaw plugins install @openclaw/nextcloud-talk

Instalación local (cuando se ejecuta desde un repositorio git):

Bash
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''

Tutorial.step

Configuración Rápida

1. Instalar plugin de Nextcloud Talk.

2. Crear un bot en tu servidor Nextcloud:

Json5
{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.ejemplo.com",
      botSecret: "secreto-compartido",
      dmPolicy: "pairing",
    },
  },
}
Tutorial.step

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).

Tutorial.step

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 &lt;CÓDIGO&gt;</code>

- DMs abiertos: <code>channels.nextcloud-talk.dmPolicy="open"</code> y <code>channels.nextcloud-talk.allowFrom=["*"]</code>.

Tutorial.step

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:

Json5
{
  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>.

Tutorial.step

Capacidades

| Característica | Estado |

| -- |

| DMs | Soportado|

| Salas | Soportado|

| Hilos | No soportado|

| Medios | Solo URL|

| Reacciones | Soportado|

| Comandos nativos | No soportado|

Tutorial.step

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