Documentation Index
Fetch the complete documentation index at: https://docs.openpawz.ai/llms.txt
Use this file to discover all available pages before exploring further.
Nextcloud
Connect to Nextcloud Talk so users on your Nextcloud instance can chat with Pawz agents. Like Mattermost, Nextcloud is self-hosted — your conversations never leave your server.Setup
- Create a dedicated bot user on your Nextcloud instance (admin panel → Users)
- Generate an app password for the bot user (user settings → Security → Devices & sessions)
- In Pawz, go to Settings → Channels
- Select Nextcloud
- Enter:
- Server URL — e.g.,
https://cloud.yourcompany.com - Username — Nextcloud bot user
- Password — app password (not the main password)
- Server URL — e.g.,
- Start the channel
Configuration
| Field | Required | Description |
|---|---|---|
| Server URL | Yes | Nextcloud instance URL |
| Username | Yes | Bot account username |
| Password | Yes | App password for the bot account |
| DM policy | Yes | Who can message the bot (open, allowlist, or pairing) |
| Allowed users | For allowlist | Nextcloud usernames |
How it works
Pawz polls the Nextcloud Talk API for new messages. When a message arrives in a conversation the bot has joined, it’s processed through the agent pipeline — prompt injection scan → agent routing → response → reply posted back to the conversation.Features
- Nextcloud Talk conversations and DMs — the bot participates in any conversation it’s invited to
- Group conversations — the bot can respond in group chats when mentioned or when DM policy allows
- Per-user sessions with persistent memory across conversations
- Prompt injection scanning on all incoming messages
- Agent routing via channel routing rules
- Channel-specific context — lean context for fast, affordable responses
Troubleshooting
| Problem | Fix |
|---|---|
| Authentication fails | Use an app password, not the user’s main password. Generate one in user settings → Security. |
| Bot doesn’t see messages | Invite the bot user to the Talk conversation first |
| Connection refused | Verify the server URL is correct and includes https://. Check that Nextcloud Talk is enabled. |
| Slow responses | Nextcloud Talk uses polling (not WebSocket). Response time depends on poll interval. |
Tips
:::tip- Always use an app password instead of the main account password — it’s more secure and can be revoked independently.
- The bot joins conversations when invited — add it to specific Talk rooms via the Nextcloud UI.
- Ideal for organizations already on Nextcloud — no additional infrastructure needed, just add a bot user. :::