Discord 操作

概述

用途使用discord来管理消息、回应、主题、投票和审核。您可以通过discord.actions.*

禁用相关功能组（默认启用，角色/审核功能除外）。该工具使用为Clawdbot配置的机器人令牌。

• 需要收集的输入对于回应功能：频道ID、消息ID以及一个表情符号
• 。对于贴纸/投票/发送消息功能：需要一个发送至目标（格式为channel:<id>或user:<id>）。可选的内容
• 文本。投票功能还需要一个问题以及2至10个.
• 对于媒体：媒体URL使用file:///路径表示本地文件，或https://...表示远程文件。
• 对于表情符号上传：服务器ID、名称、媒体URL，可选的角色ID（限制256KB，PNG/JPG/GIF格式）。
• 对于贴纸上传：服务器ID、名称、描述、标签、媒体URL（限制512KB，PNG/APNG/Lottie JSON格式）。

消息上下文行包含discord 消息 ID和频道字段，您可以直接复用。

注意： 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。
• 至可以用户：<ID>用于私信。

上传自定义表情符号

{
  "动作": "表情符号上传",
  "公会ID": "999",
  "名称": "派对_blob",
  "媒体URL": "file:///tmp/party.png",
  "角色ID": ["222"]
}

• 表情符号图像必须是PNG/JPG/GIF格式且<=256KB。
• 角色ID是可选的；省略此项可使表情符号对所有人生效。

上传贴纸

{
  "动作": "贴纸上传",
  "公会ID": "999",
  "名称": "clawdbot_挥手",
  "描述": "Clawdbot挥手问好",
  "标签": "👋",
  "媒体URL": "file:///tmp/wave.png"
}

• 贴纸需要名称、描述和标签。
• 上传文件必须是PNG/APNG/Lottie JSON格式且<=512KB。

创建投票

{
  "动作": "投票",
  "发送至": "频道:123",
  "问题": "午餐吃什么？",
  "答案": ["披萨", "寿司", "沙拉"],
  "允许多选": false,
  "持续时间（小时）": 24,
  "内容": "立即投票"
}

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

检查机器人在频道的权限

{
  "动作": "权限",
  "频道ID": "123"
}

可尝试的想法

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

操作门控

使用discord.actions.*来禁用操作组：

• 反应（反应 + 反应列表 + 表情符号列表）
• 贴纸、投票、权限、消息、线程、置顶、搜索
• 表情符号上传、贴纸上传
• 成员信息、角色信息,频道信息,语音状态,事件
• 角色（角色添加/移除，默认false）
• 管理操作（禁言/踢出/封禁，默认false）

读取最近消息

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

发送/编辑/删除消息

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

附带媒体附件：

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

• 目标地址使用格式channel:<id>或user:<id>用于私信（不是channelId!)
• mediaUrl支持本地文件 (file:///path/to/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 写作风格指南

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

建议

• 简短有力的消息（理想长度 1-3 句）
• 多个快速回复 > 一大段文字墙
• 使用表情符号来传达语气/强调 🦞
• 小写休闲风格没问题
• 将信息分解成易于消化的小块
• 与对话的氛围保持一致

不建议

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

有效的格式

• **加粗**用于强调
• `代码`用于技术术语
• 列表用于多项内容

• 引用用于参考

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

示例转换

❌ 差：

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

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

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

✅ 好：

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