Discord 聊天

使用 Clawdbot 的 message 工具与 Discord 频道进行交互。

核心操作

发送消息

向 Discord 频道发送消息：

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

或通过频道 ID：

message action=send channel=discord target="1234567890" message="Your message here"

提示：

• 使用带 # 前缀的频道名，或直接使用频道 ID
• 若需发送多个链接，请用 <> 包裹以禁用嵌入（suppress embeds）：例如
• 不支持 Markdown 表格！请改用项目符号列表
• 支持添加效果，如 effect=balloons 或 effectId=invisible-ink

回复消息

回复某条特定消息：

message action=send channel=discord target="#channel-name" message="Reply text" replyTo="message-id"

replyTo 参数将创建对指定消息 ID 的线程化回复（threaded reply）。

搜索消息

在频道中搜索消息：

message action=search channel=discord channelId="1234567890" query="search terms" limit=50

搜索选项：

• query：搜索关键词
• authorId：按作者 ID 过滤
• before/after/around：使用消息 ID 实现分页
• limit：最大返回结果数（默认为 25）

高级搜索模式详见 SEARCH.md。

其他操作

读取消息：

message action=read channel=discord target="#channel-name" limit=20

给消息添加反应（React）：

message action=react channel=discord messageId="1234567890" emoji="👍"

编辑消息：

message action=edit channel=discord messageId="1234567890" message="Updated text"

删除消息：

message action=delete channel=discord messageId="1234567890"

速查表

常用操作模式：

• 向频道发布公告：action=send target="#announcements"
• 在线程中回复：action=send replyTo="msg-id"
• 查看最近活动：action=read limit=10
• 查找提及（@）记录：action=search query="@username"
• 确认已读/已处理：action=react emoji="✅"

频道管理

列出频道：

message action=channel-list channel=discord guildId="server-id"

获取频道信息：

message action=channel-info channel=discord channelId="1234567890"

关于创建或编辑频道的操作，请参阅 CHANNELS.md。

最佳实践

1. 优先使用频道名称作为 target —— 如 target="#general" 比使用 ID 更清晰易懂
2. 批量添加反应时保持克制 —— 每条消息仅使用一个最贴切的表情符号
3. 适配 Discord 的格式习惯 —— 使用项目符号而非表格；用 包裹链接以禁用嵌入
4. 提问前先搜索 —— 在请求新信息前，应先查阅历史消息
5. 优先使用 Reaction 而非 Reply —— 对于简单确认类操作，推荐使用 reaction

配置说明

您的 Discord 机器人配置应置于 gateway 配置中。message 工具在指定 channel=discord 时，会自动路由至已配置的 Discord 插件。

如需配置帮助，请参阅 CONFIG.md。