ContextQMD
Back to Eliza

Nextcloud Talk Connector

packages/docs/connectors/nextcloud-talk.md

2.0.12.7 KB
Original Source

Nextcloud Talk Connector

Connect your agent to Nextcloud Talk for self-hosted collaboration messaging using the @elizaos/plugin-nextcloud-talk package.

Prerequisites

The Nextcloud Talk connector is an elizaOS plugin that bridges your agent to Nextcloud Talk rooms. It supports DM and group conversations on self-hosted Nextcloud instances. This connector is available from the plugin registry.

Package Info

FieldValue
Package@elizaos/plugin-nextcloud-talk
Config keyconnectors.nextcloud-talk
Installeliza plugins install @elizaos/plugin-nextcloud-talk

Setup

1. Configure Your Nextcloud Instance

  1. Ensure Nextcloud Talk is installed and enabled on your Nextcloud instance
  2. Create a bot user or use an existing account for the agent
  3. Note the Nextcloud server URL and bot credentials

2. Configure Eliza

json
{
  "connectors": {
    "nextcloud-talk": {
      "enabled": true
    }
  }
}

Set credentials via environment variables:

bash
export NEXTCLOUD_URL=https://your-nextcloud-instance.example.com
export NEXTCLOUD_BOT_SECRET=YOUR_BOT_SECRET

Environment Variables

VariableRequiredDescription
NEXTCLOUD_URLYesNextcloud server URL
NEXTCLOUD_BOT_SECRETYesBot secret for authentication
NEXTCLOUD_WEBHOOK_HOSTNoHost address for webhook listener
NEXTCLOUD_WEBHOOK_PORTNoPort for webhook listener
NEXTCLOUD_WEBHOOK_PATHNoWebhook endpoint path
NEXTCLOUD_WEBHOOK_PUBLIC_URLNoPublic-facing webhook URL
NEXTCLOUD_ALLOWED_ROOMSNoComma-separated list of allowed room IDs

Install the plugin from the registry:

bash
eliza plugins install nextcloud-talk

Configure in ~/.eliza/eliza.json:

json
{
  "connectors": {
    "nextcloud-talk": {
      "enabled": true,
      "url": "https://your-nextcloud.example.com",
      "botSecret": "YOUR_BOT_SECRET",
      "webhookPath": "/nextcloud-talk",
      "allowedRooms": "room1,room2"
    }
  }
}

Setup

  1. Ensure your Nextcloud server has Talk enabled.
  2. Create a bot or obtain credentials for the Nextcloud instance.
  3. Install the plugin: eliza plugins install nextcloud-talk.
  4. Set the NEXTCLOUD_URL and NEXTCLOUD_BOT_SECRET environment variables or configure them inline.
  5. Start your agent.

Features

  • Room-based messaging with Talk conversations
  • DM and group conversation support
  • Webhook-based message delivery
  • Room allowlisting