Discord Bot Skill
Alma can connect to Discord via a bot and participate in guild channels.
Setup
- Create a Discord bot at https://discord.com/developers/applications
- Enable MESSAGE CONTENT intent in Bot settings
- Generate a bot token
- Add the bot to your server with these permissions: Send Messages, Read Message History, Add Reactions, Attach Files
- Configure in Alma settings:
# Set Discord settings via API
curl -X PUT http://localhost:23001/api/settings \
-H "Content-Type: application/json" \
-d '{
"discord": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN",
"allowedGuildIds": [],
"allowedChannelIds": []
}
}'Sending Messages
# Send a text message to a Discord channel
curl -s http://localhost:23001/api/discord/send \
-H "Content-Type: application/json" \
-d '{"channelId": "CHANNEL_ID", "message": "Hello from Alma!"}'
# Send a photo
curl -s http://localhost:23001/api/discord/send-photo \
-H "Content-Type: application/json" \
-d '{"channelId": "CHANNEL_ID", "filePath": "/path/to/image.jpg", "caption": "Check this out!"}'
# Send a file
curl -s http://localhost:23001/api/discord/send-file \
-H "Content-Type: application/json" \
-d '{"channelId": "CHANNEL_ID", "filePath": "/path/to/doc.pdf", "caption": "Here you go"}'Stickers
# List all stickers from all servers the bot is in
alma discord sticker-list
# List stickers from a specific server
alma discord sticker-list <guildId>
# Search stickers by name
alma discord sticker-find <query>
# Send a sticker to a channel
alma discord sticker <channelId> <stickerId>Direct Messages (DM)
# Send a DM to a Discord user
alma discord dm <userId> "Hello, this is a private message!"- The user must share a server with the bot, or have DMs enabled
- userId is the Discord numeric user ID (find in people profiles under
discord_id)
Delete Messages
# Delete (retract) a message
alma discord delete <channelId> <messageId>- Bot can only delete its own messages, or messages in channels where it has Manage Messages permission
Bot Commands (in Discord)
Users can use these commands in Discord:
/helpor!help— Show help/new [title]— Start a new conversation/stop— Stop current generation/model— Show current model
Notes
- The bot requires MESSAGE_CONTENT intent to read message content
- Discord has a 2000 character limit per message — long responses are automatically split
- File attachments (images, documents) sent by users are downloaded and passed to Alma
- The bot responds to: direct mentions (@Alma), replies to bot messages, messages containing "alma", and DMs
- Group chat history is tracked per channel for context-aware responses