name: discord
description: 当需要通过 discord 工具从 Clawdbot 控制 Discord 时使用：发送消息、添加反应、发布或上传贴纸、上传表情符号、发起投票、管理主题/置顶/搜索、获取权限或成员/角色/频道信息，或在 Discord 私信或频道中执行管理操作。

Discord 操作

概述

使用 discord 来管理消息、反应、主题、投票和审核。你可以通过 discord.actions.* 禁用操作组（默认启用，但角色/管理操作除外）。该工具使用为 Clawdbot 配置的机器人令牌。

需要收集的输入

• 反应：需要 channelId、messageId 和一个 emoji。
• 贴纸/投票/发送消息：需要一个 to 目标（channel:<id> 或 user:<id>）。可选的 content 文本。
• 投票：还需要一个 question 和 2-10 个 answers。
• 媒体：需要 mediaUrl，本地文件使用 file:///路径，远程文件使用 https://...。
• 表情符号上传：需要 guildId、name、mediaUrl，可选的 roleIds（限制 256KB，PNG/JPG/GIF）。
• 贴纸上传：需要 guildId、name、description、tags、mediaUrl（限制 512KB，PNG/APNG/Lottie JSON）。

消息上下文行包含 discord message id 和 channel 字段，你可以直接复用。

注意： sendMessage 使用 to: "channel:<id>" 格式，而不是 channelId。其他操作如 react、readMessages、editMessage 则直接使用 channelId。

操作

对消息添加反应

{
  "action": "react",
  "channelId": "123",
  "messageId": "456",
  "emoji": "✅"
}

列出反应及用户

{
  "action": "reactions",
  "channelId": "123",
  "messageId": "456",
  "limit": 100
}

发送贴纸

{
  "action": "sticker",
  "to": "channel:123",
  "stickerIds": ["9876543210"],
  "content": "干得漂亮！"
}

• 每条消息最多 3 个贴纸 ID。
• to 可以是 user:<id> 用于私信。

上传自定义表情符号

{
  "action": "emojiUpload",
  "guildId": "999",
  "name": "party_blob",
  "mediaUrl": "file:///tmp/party.png",
  "roleIds": ["222"]
}

• 表情符号图片必须是 PNG/JPG/GIF 格式且 <= 256KB。
• roleIds 是可选的；省略则使表情符号对所有人生效。

上传贴纸

{
  "action": "stickerUpload",
  "guildId": "999",
  "name": "clawdbot_wave",
  "description": "Clawdbot 挥手打招呼",
  "tags": "👋",
  "mediaUrl": "file:///tmp/wave.png"
}

• 贴纸需要 name、description 和 tags。
• 上传文件必须是 PNG/APNG/Lottie JSON 格式且 <= 512KB。

创建投票

{
  "action": "poll",
  "to": "channel:123",
  "question": "午餐吃什么？",
  "answers": ["披萨", "寿司", "沙拉"],
  "allowMultiselect": false,
  "durationHours": 24,
  "content": "现在投票"
}

• durationHours 默认为 24；最长 32 天（768 小时）。

检查机器人在频道的权限

{
  "action": "permissions",
  "channelId": "123"
}

读取最近的消息

{
  "action": "readMessages",
  "channelId": "123",
  "limit": 20
}

发送/编辑/删除消息

{
  "action": "sendMessage",
  "to": "channel:123",
  "content": "来自 Clawdbot 的问候"
}

附带媒体附件：

{
  "action": "sendMessage",
  "to": "channel:123",
  "content": "听听这个音频！",
  "mediaUrl": "file:///tmp/audio.mp3"
}

• to 使用格式 channel:<id> 或 user:<id> 用于私信（不是 channelId！）
• mediaUrl 支持本地文件（file:///路径/到/文件）和远程 URL（https://...）
• 可选的 replyTo 配合消息 ID 来回复特定消息

{
  "action": "editMessage",
  "channelId": "123",
  "messageId": "456",
  "content": "修正了拼写错误"
}

{
  "action": "deleteMessage",
  "channelId": "123",
  "messageId": "456"
}

主题

{
  "action": "threadCreate",
  "channelId": "123",
  "name": "Bug 分类",
  "messageId": "456"
}

{
  "action": "threadList",
  "guildId": "999"
}

{
  "action": "threadReply",
  "channelId": "777",
  "content": "在主题中回复"
}

置顶

{
  "action": "pinMessage",
  "channelId": "123",
  "messageId": "456"
}

{
  "action": "listPins",
  "channelId": "123"
}

搜索消息

{
  "action": "searchMessages",
  "guildId": "999",
  "content": "发布说明",
  "channelIds": ["123", "456"],
  "limit": 10
}

成员与角色信息

{
  "action": "memberInfo",
  "guildId": "999",
  "userId": "111"
}

{
  "action": "roleInfo",
  "guildId": "999"
}

列出可用自定义表情符号

{
  "action": "emojiList",
  "guildId": "999"
}

角色变更（默认禁用）

{
  "action": "roleAdd",
  "guildId": "999",
  "userId": "111",
  "roleId": "222"
}

频道信息

{
  "action": "channelInfo",
  "channelId": "123"
}

{
  "action": "channelList",
  "guildId": "999"
}

语音状态

{
  "action": "voiceStatus",
  "guildId": "999",
  "userId": "111"
}

预定事件

{
  "action": "eventList",
  "guildId": "999"
}

审核（默认禁用）

{
  "action": "timeout",
  "guildId": "999",
  "userId": "111",
  "durationMinutes": 10
}

可以尝试的想法

• 用 ✅/⚠️ 添加反应来标记状态更新。
• 为发布决策或会议时间发起快速投票。
• 在成功部署后发送庆祝贴纸。
• 为发布时刻上传新的表情符号/贴纸。
• 在团队频道中运行每周“优先级检查”投票。
• 当用户的请求完成时，通过私信发送贴纸作为确认。

操作门控

使用 discord.actions.* 来禁用操作组：
- reactions（添加反应 + 反应列表 + 表情符号列表）
- stickers、polls、permissions、messages、threads、pins、search
- emojiUploads、stickerUploads
- memberInfo、roleInfo、channelInfo、voiceStatus、events
- roles（添加/移除角色，默认 false）
- moderation（禁言/踢出/封禁，默认 false）

Discord 写作风格指南

保持对话感！ Discord 是一个聊天平台，不是文档。

应该做的

• 简短、有力的消息（1-3 句为佳）
• 多个快速回复 > 一大段文字
• 使用表情符号来表达语气/强调 🦞
• 小写、随意的风格完全可以
• 将信息分解成易于消化的小块
• 与对话的氛围保持一致

不要做的

• 不要使用 Markdown 表格（Discord 会将其渲染为丑陋的原始 | 文本 |）
• 在随意聊天中不要使用 ## 标题（用 粗体 或大写来强调）
• 避免长篇大论
• 不要过度解释简单的事情
• 跳过“我很乐意帮忙！”之类的客套话

有效的格式

• 粗体 用于强调
• 代码 用于技术术语
• 列表用于多个项目

• 引用 用于引用内容

• 将多个链接包裹在 <> 中以抑制嵌入预览

示例转换

❌ 不好：

我很乐意帮助你！以下是可用版本控制策略的全面概述：

## 语义化版本控制
Semver 使用 MAJOR.MINOR.PATCH 格式，其中...

## 日历化版本控制
CalVer 使用基于日期的版本，如...

✅ 好：

版本控制选项：semver (1.2.3)、calver (2026.01.04) 或 yolo（永远 `latest`）。哪种适合你的发布节奏？