1. Skill Overview
discord-clawd is an official built-in communication skill for OpenClaw. It was initially developed alongside ClawdBot, the project’s early codename. Its core purpose is to connect OpenClaw AI agents with the Discord platform, acting as the standard underlying toolkit for OpenClaw’s Discord integration. The skill is stored at
.agents/skills/discord-clawd, and all cross-platform operations are routed and dispatched via the unified message channel channel: "discord".2. Core Functional Features
Full Lifecycle Message Management
Send, edit and delete channel messages and direct private messages; supports image & file attachments, rich Embed cards, and Discord V2 interactive components. It also supports message pinning, history search, and bulk channel record fetching.
Interaction & Community Utilities
Add emoji reactions to messages, create polls, create and manage discussion threads, mention users/roles, and send custom emojis.
Server & Member Administration
Query user identities, role permissions and channel settings. Lightweight, controllable moderation operations (mute, kick, etc.) are available but disabled by default and require manual enabling. Multi-Discord Bot account switching is supported via the
accountId parameter to differentiate multiple instances.Intelligent Automation
Integrates with OpenClaw’s task scheduler to automatically push build logs, project notifications and daily report summaries. It monitors channel keywords for auto-replies, collects bug tickets, and sends scheduled team reminders.
Status & Gateway Control
Customize bot online status and activity text; fully supports the three mandatory Discord gateway intents: Message Content, Guild Members, and Presence.
3. Underlying Mechanism
This skill wraps the official Discord API and fully complies with OpenClaw Agent calling standards, eliminating the need for developers to integrate standalone Discord SDKs. All operations are distributed through OpenClaw’s standardized message toolkit, with native compatibility for OpenClaw scheduled tasks, file memory storage, and multi-LLM pipelines. It drastically cuts development costs for Discord bot automation.
4. Applicable Scenarios
- Automated operation of Discord communities for open-source projects: auto-welcome new users, aggregate questions, publish version release announcements
- R&D ChatOps: pipeline build result push, error alerts, team voting for scheduling
- Personal/team dedicated AI bots: invoke OpenClaw directly within Discord to process local files, run web searches and generate code
- Lightweight community management: auto-archive discussion threads, search historical questions, generate weekly channel reports
5. Deployment & Security Instructions
- Installation: Built-in skill of OpenClaw; auto-loaded after pulling the main repository, or installed separately via the
clawhubcommand - Prerequisites: Create a Bot on the Discord Developer Portal, configure its Token, enable the three required gateway intents, and grant guild permissions
- Security controls: High-risk operations including role management, guild control and user bans are disabled by default and must be manually enabled in the config file. Multi-account isolation is supported to prevent cross-guild data leakage
II. Short Promotional Copy (for Repository Description / README)
Title
discord-clawd — Discord Integration Skill for OpenClaw AI Agent
Description
A native Discord interaction skill built exclusively for OpenClaw, bridging AI agents and Discord guilds. It supports message sending & receiving, thread management, community automation, DevOps alerts and member permission lookup. Unlock full Discord bot capabilities with one click, optimized for open-source communities, R&D team ChatOps workflows and personal AI assistants.
III. Minimal One-Line Description (for GitHub Directory Introduction)
Official Discord Bot interaction skill bundled with OpenClaw Clawd, delivering full automation for Discord guild messaging, community management and DevOps workflows.
