AutoGPT-Discord

A plugin to enable you to control and watch your AutoGPT instance from Discord!

📚 Requirements

Python Package: Install the discord Python package:

pip install discord

Discord Bot Token: Visit the link https://discord.com/developers/docs/getting-started

Press the Create App button and log in with your Discord account.
Name the app anything you want, I like to name it AutoGPT for readability.
Navigate to the Bot tab on the left side of the screen, and scroll down to the Priviliged Gateway Intents section.
Enable the Server Members Intent and the Message Content Intent.
Then, press the OAuth2 -> URL Generator tab.
Press bot in the scopes section. Then, in bot permissions, check send messages and read message history.
Scroll down and copy the link. Paste the link into a new tab, and invite the bot to a server of your choosing! (You must have admin access to this server)
Go back to the bot tab, and press Reset Token. Copy this token, and keep this safe, as you will use this to configure the plugin later on.

⚙️ Installation

Follow these steps to configure the AutoGPT Discord Plugin:

1. Clone this Repository

cd into a folder that you can find easily. For example: cd desktop. Then, paste this command: git clone https://github.com/gravelBridge/AutoGPT-Discord.git

2. Navigate to the folder

Navigate to the folder where you ran the cd command

3. Zip the discord_plugin folder

On MacOS, right click the discord_plugin folder and press Compress. On windows, right click the folder, and press Send to > Compressed (zipped).

4. Move the zip file

Move the new discord_plugin.zip file to the AutoGPT plugins directory, there should already be a file there titled __PUT_PLUGIN_ZIPS_HERE__.

🔧 Configuration

Update the .env file: Add the following lines to your .env file:

################################################################################
### DISCORD PLUGIN SETTINGS
################################################################################

DISCORD_BOT_TOKEN=sadfJHo3h4h3heof
AUTHORIZED_USER_IDS=111111,222222,333333
BOT_PREFIX=!
CHANNEL_ID=123456789
ASK_FOR_INPUT=True

DISCORD_BOT_TOKEN: This is the bot token that you received from Step Two.
AUTHORIZED_USER_IDS: A list of comma separated Discord User IDS that will have access to control AutoGPT. If you don't know how to get this, search up "How to get Discord User Id"
BOT_PREFIX: The prefix to use when using commands with the Discord Bot.
CHANNEL_ID: The channel id in which the bot will be giving information, and requesting input. If you don't know how to get this, search up "How to get Discord Channel Id"
ASK_FOR_INPUT: Whether to ask for user confirmation and/or feedback before running a command.

Run the bot in continuous mode: Run AutoGPT with the extra argument --continuous

Without this, the plugin is useless as you still have to manually confirm commands in the actual AutoGPT instance.
You can configure if you want AutoGPT to be truly continuous with the ASK_FOR_INPUT env variable. If this is False, then AutoGPT will be truly continuous: running commands without consulting you. If this is True, AutoGPT will ask you in Discord to approve, deny, or to provide feedback on the command.

Allowlist Plugin: In your .env file, search for ALLOWLISTED_PLUGINS and add this plugin:

################################################################################
ALLOWLISTED PLUGINS
################################################################################

#ALLOWLISTED_PLUGINS - Sets the listed plugins that are allowed (Example: plugin1,plugin2,plugin3)
ALLOWLISTED_PLUGINS=AutoGPTDiscord

🤖 Commands

Remember to use your bot prefix directly before running any commands!

shutdown: Shuts down the entire AutoGPT instance.

Shoutout to @CTHULHUCTHULHU for reworking most of the plugin, really amazing work <3

🚀 That's it! Congratulations!

Make sure to leave a star on this repository! Thank you!

gravelBridge / AutoGPT-Discord