- name
- discord-chat
- description
- Send messages, reply to messages, and search message history in Discord channels using the message tool. Use when the user wants to communicate with Discord (send/reply/search messages), check Discord activity, or interact with Discord channels.
Discord Chat
Interact with Discord channels using Clawdbot's message tool.
Core Actions
Send Messages
Send a message to a Discord channel:
message action=send channel=discord target="#channel-name" message="Your message here"Or by channel ID:
message action=send channel=discord target="1234567890" message="Your message here"Tips:
- Use channel names with
#prefix or channel IDs - For multiple links, wrap in
<>to suppress embeds:<https://example.com> - No markdown tables! Use bullet lists instead
- Support effects with
effect=balloonsoreffectId=invisible-ink
Reply to Messages
Reply to a specific message:
message action=send channel=discord target="#channel-name" message="Reply text" replyTo="message-id"The replyTo parameter creates a threaded reply to the specified message ID.
Search Messages
Search for messages in a channel:
message action=search channel=discord channelId="1234567890" query="search terms" limit=50Search options:
query: Search termsauthorId: Filter by authorbefore/after/around: Message ID for paginationlimit: Max results (default 25)
See SEARCH.md for advanced search patterns.
Other Actions
Read messages:
message action=read channel=discord target="#channel-name" limit=20React to messages:
message action=react channel=discord messageId="1234567890" emoji="👍"Edit messages:
message action=edit channel=discord messageId="1234567890" message="Updated text"Delete messages:
message action=delete channel=discord messageId="1234567890"Quick Reference
Common patterns:
- Announce to channel:
action=send target="#announcements" - Reply in thread:
action=send replyTo="msg-id" - Recent activity:
action=read limit=10 - Find mentions:
action=search query="@username" - Acknowledge:
action=react emoji="✅"
Channel Management
List channels:
message action=channel-list channel=discord guildId="server-id"Get channel info:
message action=channel-info channel=discord channelId="1234567890"For creating/editing channels, see CHANNELS.md.
Best Practices
- Use target names when possible -
target="#general"is clearer than IDs - Batch reactions - One emoji per message, pick the best fit
- Format for Discord - Bullets not tables,
<link>to suppress embeds - Search before asking - Check history before requesting info
- React > Reply - Use reactions for simple acknowledgments
Configuration
Your Discord bot configuration should be in the gateway config. The message tool routes to the configured Discord plugin automatically when channel=discord is specified.
For setup help, see CONFIG.md.