Nextcloud AIO: How to list and remove Talk bots by ID

Nextcloud AIO: How to list and remove Talk bots by ID

This short guide explains how to list registered Nextcloud Talk bots and remove specific ones by their ID on a Nextcloud AIO instance.

What this is about

Nextcloud Talk can have multiple bots registered, for example:

  • Call summary bot

  • Agenda bot

  • Assistant Talk Bot

  • Custom webhook/response bots

  • Translated variants of call summary or agenda bots

These bots can also appear inside a Talk conversation under:

Conversation settings → Bots

After testing, upgrades, or reinstalling related apps, you may end up with bots that you no longer need. In Nextcloud AIO, they can be managed through occ inside the nextcloud-aio-nextcloud container.

List all registered Talk bots

Run this on the host where Nextcloud AIO is installed:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ talk:bot:list

Example output:

+----+-----------------------+-------------+-------+-------------------+
| id | name                  | error_count | state | features          |
+----+-----------------------+-------------+-------+-------------------+
| 5  | Call summary          | 0           | 1     | event             |
| 19 | Assistant Talk Bot    | 0           | 1     | webhook, response |
| 13 | Agenda                | 0           | 1     | event, reaction   |
| 17 | Uptime Kuma 2 Bot     | 0           | 1     | response          |
| 20 | Protokoll             | 0           | 1     | event             |
| 21 | Resumen de la llamada | 0           | 1     | event             |
+----+-----------------------+-------------+-------+-------------------+

The important column is:

id

This ID is used when removing a specific bot.

Remove a Talk bot by ID

Use the following command:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ talk:bot:uninstall ID

Replace ID with the actual bot ID from the list.

Example:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ talk:bot:uninstall 20

Verify the result

After removing a bot, list the bots again:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ talk:bot:list

The removed ID should no longer appear in the list.

Be careful

Only remove bots you are sure you no longer use.

For example, custom response/webhook bots may be used by external services such as Uptime Kuma or other monitoring tools. If such a bot is removed, the integration using it will stop working and may need to be configured again.

Useful additional commands

Show available Talk bot commands:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ list talk:bot

Show help for the uninstall command:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ talk:bot:uninstall --help

Summary

For Nextcloud AIO, the two most useful commands are:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ talk:bot:list

and:

sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ talk:bot:uninstall ID

The first command shows all registered Talk bots and their IDs.
The second command removes a selected Talk bot by ID.