How to Connect Openclaw to Nextcloud Talk

Table of contents: [Show]

Quick Start

Connect your Openclaw agent to Nextcloud Talk in minutes. This integration lets your team interact with AI directly in your Nextcloud chat channels.

Prerequisites

Running Openclaw Gateway
Nextcloud instance with Talk app installed
Admin access to create bot credentials

Step-by-Step Setup

1. Install the Nextcloud Talk Plugin

Nextcloud Talk support is provided via a plugin. Install it using the CLI:

Openclaw plugins install @Openclaw/nextcloud-talk

Note: If running Openclaw from a git repository, use Openclaw plugins install ./extensions/nextcloud-talk instead.

2. Configure Your Nextcloud Bot

In your Nextcloud admin panel, create a bot and generate a shared secret. You'll need:

Your Nextcloud base URL (e.g., https://cloud.example.com)
The shared secret from your bot configuration

3. Update Openclaw Configuration

Edit your ~/.Openclaw/Openclaw.json file to add the Nextcloud Talk channel:

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

Alternatively, provide the secret via environment variable:

export NEXTCLOUD_TALK_BOT_SECRET="shared-secret"

Testing Your Integration

Once configured, restart your Openclaw Gateway:

Openclaw gateway restart

Send a message in your Nextcloud Talk channel. The bot should respond to mentions and direct messages based on your dmPolicy setting.

For more deployment options, check out our guide on Flyio Deployment. If you're new to Openclaw, you might also want to read about Elevated Mode for advanced permissions.

Configuration Options

Option	Description	Default
enabled	Enable/disable the channel	false
baseUrl	Your Nextcloud instance URL	Required
botSecret	Shared secret from bot config	Required
dmPolicy	Direct message handling: pairing, allowlist, or open	pairing

Troubleshooting

Bot not responding: Verify the baseUrl includes https:// and has no trailing slash
Authentication errors: Double-check your shared secret matches exactly in both Nextcloud and Openclaw config
Gateway won't start: Validate your JSON syntax with jq or an online validator

Best Practices

Use pairing policy for production to control who can DM the bot
Store secrets in environment variables rather than config files when possible
Monitor gateway logs with Openclaw gateway logs for debugging

Your Nextcloud Talk integration is now active. Team members can @mention the bot or send direct messages to get AI assistance right where they collaborate.