Before installing the bot, you need to do some set up in your Discord account. Start by opening the Developer Portal and creating a new application. Once you've created it, click on your new application. Then, go to Bot in the sidebar and enable the Presence Intent, Server Members Intent, and Message Content intent.
To get the token that you have to pass to owobot, click on the Reset Token button to generate a new token, and then copy it and store it somewhere safe (you won't be able to see it later).
The latest release contains RPM, Deb, and Arch packages, and owobot is available on the AUR as well. Choose whichever one of those you need and install it with your package manager.
Once it's installed, there should be a default config file at /etc/owobot.toml. You can edit that to add your token, change the activity text, etc. and then run the bot by running sudo systemctl enable --now owobot. Systemd will now start running the bot and monitoring it to make sure it doesn't go down.
That's it! Your bot should be up and running!
This guide will use Docker, but owobot should work with any other OCI-compatible container engine, such as Podman. The container image is hosted on Gitea.
There's a docker-compose.yml file provided in this repo as a starting point. Here's how you can use it:
- First, make sure
dockeranddocker-composeare installed and working - Create a new folder for owobot to use to store its data
- Put the example
docker-compose.ymlfile into the new folder - Edit the
docker-compose.ymlfile to set the token and anything else you may want to change - Make sure the directory can be accessed by the container's user (
sudo chown -R 65532:65532 folder) - Run
docker-compose up -d - That's it! Your bot should now be running.