What It Does
It connects through your bot token configured for Clawdbot, and every action group can be individually enabled or disabled via `discord.actions.*` flags. Roles and moderation actions are disabled by default for safety, requiring explicit opt-in.
The Discord skill gives your AI agent full programmatic control over Discord — sending and editing messages, reacting to posts, creating threads, running polls, uploading custom emojis and stickers, and performing moderation actions.
Key Features
- Message Management — Send, edit, delete, and read messages in channels or DMs using `channel:<id>` or `user:<id>` targeting. Supports media attachments via local `file:///` paths or remote `https://` URLs, and optional reply threading with `replyTo`.
- Reactions & Emoji — React to any message with any emoji, list reactions and the users who made them, and upload custom server emojis (PNG/JPG/GIF, ≤256KB) with optional role restrictions.
- Polls — Create native Discord polls with 2–10 answer options, optional multi-select, and configurable duration up to 32 days (768 hours). Useful for async team decisions without leaving your workflow.
- Threads, Pins & Search — Create threads from messages, list all active threads in a guild, reply within threads, pin or unpin messages, and search message history across multiple channels by keyword.
- Sticker Support — Send existing stickers (up to 3 per message) in channels or DMs, and upload new custom stickers (PNG/APNG/Lottie JSON, ≤512KB) to a guild with name, description, and tag metadata.
- Granular Action Gating — Every action group — reactions, stickers, polls, moderation, roles, member info, and more — can be enabled or disabled independently via `discord.actions.*` flags. Moderation and role changes are off by default for safety.
Requirements
- **Discord Bot Token** — Required. Configured as the bot token for Clawdbot. The bot must be added to your server with appropriate permissions for the actions you enable.
Use Cases
- Automated deployment notifications — After a successful deploy, have your agent post a message to a `#deployments` channel, react with ✅, and send a celebratory sticker — all without manual intervention.
- Team decision polls — Trigger a poll in your `#team` channel for sprint priorities or release timing. The agent creates the poll with your options, sets a 24-hour window, and posts a reminder message.
- Server asset management — Upload new custom emojis or stickers to your guild programmatically — useful when launching a new product, event, or inside joke that deserves a permanent emoji.
- Moderation assistance — With moderation actions explicitly enabled, your agent can timeout, kick, or ban disruptive users, and manage member roles as part of an automated trust or onboarding workflow.