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.
Interact with Discord channels using Clawdbot's message tool.
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:
# prefix or channel IDs<> to suppress embeds: <https://example.com>effect=balloons or effectId=invisible-inkReply 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 for messages in a channel:
message action=search channel=discord channelId="1234567890" query="search terms" limit=50
Search options:
query: Search termsauthorId: Filter by authorbefore/after/around: Message ID for paginationlimit: Max results (default 25)See SEARCH.md for advanced search patterns.
Read messages:
message action=read channel=discord target="#channel-name" limit=20
React 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"
Common patterns:
action=send target="#announcements"action=send replyTo="msg-id"action=read limit=10action=search query="@username"action=react emoji="✅"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.
target="#general" is clearer than IDs<link> to suppress embedsYour 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.