Configuration for Collab.Land bot with minimal permissions

Trung
2 min readMar 16, 2021

The guided configuration provided by Collab.Land simply requests the Administrator permssion on inviting the bot to simplify the configuration process, but it’s not actually needed.

As a discord server owner/manager, you should know that it’s not recommended to assign the Administrator permission unless it’s absolutely necessary.

This guide will show you how to configure your server to allow the bot to run and limit its accessibility — something that you can’t do when the bot has Administrator privilege.

Invite the bot and Initial set up

Invite the bot to your server with the Administrator permission, to start with so that it can create the private channel, #collabland-config channel, the only place configuration commands are accepted. It also creates the Collab.Land role that is directly linked to the bot integration (self delete on bot removal).

Side note: if you don’t want to invite the bot with Administrator permission, you can create the role and channel yourself, since it won’t have permissions to do this.

Bot invite link:
https://discord.com/oauth2/authorize?client_id=704521096837464076&scope=bot&permissions=8

Custom Configuration to remove Administrator permissions

Go to Roles management in Server Settings and find the Collab.Land role to edit it. Disable all its permissions and only allow:

- Manage Roles.

If you have already created the Roles that you want the bot to manage based on token permissions, ensure that these roles are listed under Collab.Land. Otherwise drag and sort as required.

Custom Configuration for setup channel

Now we need to give the bot access to the configuration channel. Edit #collabland-config channel and add the Collab.Land role to permissions. Select Collab.Land role and it only enable permissions for:

- View Channel
- Send Messages

In the user list on the right, you should now see the Collab.Land bot.

Custom Configuration for channels to enable/disable bot commands for users

By default, a discord server is set up to allow @everyone role the View Channels permission. This applies to the bot as well, so user commands would be available in all channels that are not private.

If you wish to disable the commands for any channel, just add the Collab.Land role and disable the View Channels permission.

If you changed the @everyone role so that it does not have the View Channels permission, then you just do the opposite — enable channel(s) where you want user commands available to.

--

--