Discord Chat

# Discord Chat

Interact with Discord channels using Clawdbot's `message` tool.

## Core Actions

### Send Messages

Send a message to a Discord channel:

```bash message action=send channel=discord target="#channel-name" message="Your message here" ```

Or by channel ID:

```bash 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:

```bash 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:

```bash 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](references/SEARCH.md) for advanced search patterns.

### Other Actions

**Read messages:** ```bash message action=read channel=discord target="#channel-name" limit=20 ```

**React to messages:** ```bash message action=react channel=discord messageId="1234567890" emoji="👍" ```

**Edit messages:** ```bash message action=edit channel=discord messageId="1234567890" message="Updated text" ```

**Delete messages:** ```bash 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:** ```bash message action=channel-list channel=discord guildId="server-id" ```

**Get channel info:** ```bash message action=channel-info channel=discord channelId="1234567890" ```

For creating/editing channels, see [CHANNELS.md](references/CHANNELS.md).

## Best Practices

1. **Use target names when possible** - `target="#general"` is clearer than IDs 2. **Batch reactions** - One emoji per message, pick the best fit 3. **Format for Discord** - Bullets not tables, `<link>` to suppress embeds 4. **Search before asking** - Check history before requesting info 5. **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](references/CONFIG.md).