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=balloons
```
or
```
effectId=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=50

Search options:

```
query
```
: Search terms
```
authorId
```
: Filter by author
```
before
```
/
```
after
```
/
```
around
```
: Message ID for pagination
```
limit
```
: Max results (default 25)

See SEARCH.md for advanced search patterns.

Other Actions

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"

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.

Discord Chat

AI Skill Market Insights

Be Part of the 0+ Developer Community

Discord Chat

Core Actions

Send Messages

Reply to Messages

Search Messages

Other Actions

Quick Reference

Channel Management

Best Practices

Configuration

Quick Start

Manual Installation

TEAR & SHARE

Tags

README

OpenClaw WhatsApp

Gotify

Reflect Notes

Farcaster Agent

Channels

Learn

Compare

Company