Discord Master Free提供Discord Bot开发入门知识，涵盖Bot创建、命令注册、消息处理和基础权限配置的操作指南。
SKILL.md

---
slug: discord-master-free
name: discord-master-free
version: 1.0.0
displayName: Discord开发助手(免费版)
summary: Discord Bot开发入门指南，覆盖命令注册、消息处理、认证安全等核心能力。
license: Proprietary
edition: free
description: Discord 开发助手免费版是一套面向初学者与个人开发者的 Discord Bot 开发知识库，帮助用户快速掌握斜杠命令注册、消息收发、认证安全等核心技能。核心能力：提供
  Bot Token 安全管理指南、斜杠命令注册流程、消息与组件交互模板、基础权限配置、HTTP 直连调用方法（无需 SDK 依赖）
tags:
- Discord
- 集成工具
- Bot开发
- 免费版
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: L3
pricing_model: per_use
suggested_price: 29.9
tools: ["read", "write", "exec"]
tags: "Discord,社交,通信"
---
# Discord 开发助手（免费版）

## 概述

Discord 是全球最大的社区交流平台之一，其 Bot 生态为自动化运营、工具集成与社区管理提供了强大能力。本助手将 Discord Bot 开发流程整理为结构化指南，帮助开发者在 10 分钟内完成第一个 Bot 的搭建与命令注册。

免费版聚焦于**入门最高频的五大能力**：Bot 创建与认证、斜杠命令注册、消息收发、基础权限配置、HTTP 直连调用。

## 核心能力

### 能力一：Bot 创建与 Token 管理

| 步骤 | 操作要点 | 注意事项 |
|---|----|----|
| 创建应用 | Developer Portal → New Application | 应用名即 Bot 默认显示名 |
| 创建 Bot | 应用详情页 → Bot → Add Bot | Bot Token 仅显示一次，妥善保存 |
| 配置权限 | OAuth2 → URL Generator | 按最小权限原则选择 scope |
| 邀请入服 | 用生成的 URL 邀请 Bot | 需服务器管理权限 |

**输入**: 用户提供能力一：Bot 创建与 Token 管理所需的指令和必要参数。
**处理**: 解析能力一：Bot 创建与 Token 管理的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力一：Bot 创建与 Token 管理的响应数据,包含状态码、结果和日志。

### 能力二：斜杠命令注册

斜杠命令（Slash Commands）是 Discord 推荐的命令交互方式，提供自动补全与参数验证。

## 输入格式
| 参数名 | 类型 | 必填 | 说明 |
|:-----|:-----|:-----|:-----|
| input | string | 是 | Discord开发助手(免费版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

```bash
# 注册全局命令（所有服务器可用，缓存最长1小时生效）
curl -X POST \
  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ping",
    "description": "测试 Bot 响应速度",
    "type": 1
  }' \
  "https://discord.com/api/v10/applications/$APP_ID/commands"
```

```bash
# 注册服务器命令（即时生效，开发推荐）
curl -X POST \
  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "ping", "description": "测试响应", "type": 1}' \
  "https://discord.com/api/v10/applications/$APP_ID/guilds/$GUILD_ID/commands"
```

**输入**: 用户提供能力二：斜杠命令注册所需的指令和必要参数。
**处理**: 解析能力二：斜杠命令注册的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力二：斜杠命令注册的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 能力三：消息收发

```bash
# 发送消息到频道
curl -X POST \
  -H "Authorization: Bot $DISCORD_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello from my Bot!"}' \
  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages"
```

**输入**: 用户提供能力三：消息收发所需的指令和必要参数。
**处理**: 解析能力三：消息收发的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力三：消息收发的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 能力四：交互响应

当用户触发斜杠命令时，Discord 会向你的端点发送交互请求，你需在 3 秒内响应。

```json
// 交互响应格式
{
  "type": 4,
  "data": {
    "content": "Pong! 响应正常"
  }
}
```

| 响应类型 | type 值 | 说明 |
|---:|---:|---:|
| 立即回复 | 4 | 直接返回消息内容 |
| 延迟回复 | 5 | 先返回确认，后续通过 webhook 补充 |
| 更新消息 | 7 | 用于组件交互更新原消息 |
| 模态框 | 9 | 弹出表单供用户填写 |

**输入**: 用户提供能力四：交互响应所需的指令和必要参数。
**处理**: 解析能力四：交互响应的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力四：交互响应的响应数据,包含状态码、结果和日志。

### 能力五：基础权限配置

| 权限范围 | 说明 | 推荐值 |
|:---:|:---:|:---:|
| bot scope | Bot 身份授权 | 必选 |
| applications.commands | 斜杠命令注册 | 推荐 |
| Send Messages | 发送消息 | 按需 |
| Read Message History | 读取历史消息 | 按需 |
| Use Slash Commands | 使用斜杠命令 | 推荐 |

**输入**: 用户提供能力五：基础权限配置所需的指令和必要参数。
**处理**: 解析能力五：基础权限配置的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力五：基础权限配置的响应数据,包含状态码、结果和日志。
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：开发入门指南、覆盖命令注册、消息处理、认证安全等核心能、开发助手免费版是、一套面向初学者与、个人开发者的、开发知识库、帮助用户快速掌握、认证安全等核心技、核心能力、安全管理指南、斜杠命令注册流程、消息与组件交互模、直连调用方法、SDK等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

## 使用场景

### 场景一：社区欢迎机器人

新成员加入服务器时自动发送欢迎消息与规则说明，使用 Gateway 事件监听 `GUILD_MEMBER_ADD`。

### 场景二：工具查询机器人

通过斜 slash 命令提供查询功能，如 `/weather 上海`、`/stock AAPL`，通过交互响应返回结果。

### 场景三：内容审核辅助

监听消息事件，对包含敏感词的内容自动删除或标记，辅助管理员维护社区环境。

## 不适用场景

以下场景Discord开发助手(免费版)不适合处理：

- 无明确技术栈的模糊需求
- 纯架构设计决策
- 运维部署管理

## 触发条件

需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于非本工具能力范围的需求。

## 快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

**典型提问模板**：

```
我想创建一个 Discord Bot，当用户输入 /ping 时回复 Pong，请给出完整步骤。
```

```
我的 Bot 需要读取频道历史消息，应该配置哪些权限？
```

```
斜杠命令注册后不显示，可能是什么原因？
```

Agent 会根据问题匹配对应知识条目，输出包含操作步骤、HTTP 请求模板、注意事项的完整回答。

#
## 示例

### 环境变量配置

```bash
# Discord Bot 凭据
export DISCORD_BOT_TOKEN=your_bot_token
export DISCORD_APP_ID=your_application_id
export DISCORD_GUILD_ID=your_test_guild_id  # 开发测试用服务器ID
```

### 权限整数计算

Discord 权限使用位掩码整数表示，可使用 Developer Portal 的 URL Generator 自动生成，或手动计算：

```javascript
// 常用权限位
const permissions = {
  SEND_MESSAGES: 2048,
  READ_MESSAGE_HISTORY: 65536,
  USE_SLASH_COMMANDS: 2147483648,
  MANAGE_MESSAGES: 8192
};
// ...
// 计算权限整数
function calcPermissions(perms) {
  return perms.reduce((sum, p) => sum | permissions[p], 0);
}
```

## 最佳实践

### 实践一：Token 安全第一

Bot Token 等同于 Bot 的密码，泄露后任何人可控制你的 Bot。通过环境变量管理，切勿提交到代码库。

### 实践二：优先使用斜杠命令

相比前缀解析（如 `!ping`），斜杠命令提供自动补全、参数验证、统一交互体验，是 Discord 官方推荐方式。

### 实践三：交互响应不超 3 秒

Discord 要求交互在 3 秒内响应，超时会显示"交互失败"。耗时操作先返回 type 5（延迟响应），后续通过 webhook 补充结果。

### 实践四：最小权限原则

Bot 仅申请必要的权限范围，避免过度授权带来的安全风险。

### 实践五：开发用服务器命令

开发阶段使用服务器命令（guild commands），即时生效便于调试；上线后改为全局命令（global commands）。

## 常见问题

### Q1：Bot 在线但命令不响应？

检查交互端点（Interactions Endpoint URL）是否已在 Developer Portal 正确配置，且能通过 Discord 的签名验证。

### Q2：斜杠命令注册后看不到？

全局命令缓存最长 1 小时才生效。开发阶段改用服务器命令（guild commands），即时生效。

### Q3：Bot Token 泄露了怎么办？

立即在 Developer Portal → Bot → Reset Token 重置，旧 Token 立即失效。同时检查服务器日志确认无异常操作。

### Q4：如何让 Bot 监听消息内容？

需在 Developer Portal 开启 Message Content Intent（已验证 Bot 专属），否则消息事件的 content 字段为空。

### Q5：交互响应超时怎么办？

将耗时操作改为延迟响应：先返回 type 5，然后在 15 分钟内通过原始交互 webhook 或跟进消息发送最终结果。

## 依赖说明

### 运行环境
- **Agent 平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux
- **网络**: 可访问 discord.com API

### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:------|------:|:------|:------|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| Discord Bot Token | 凭据 | 必需 | Discord Developer Portal 创建 |
| curl / HTTP 客户端 | 工具 | 可选 | 系统自带或安装 |
| Node.js / Python | 运行时 | 可选 | 官方网站下载 |

### API Key 配置
- **Discord Bot Token**: 通过环境变量 `DISCORD_BOT_TOKEN` 注入
- **Application ID**: 通过环境变量 `DISCORD_APP_ID` 注入
- **禁止**: 在代码、脚本、SKILL.md 中硬编码 Token
- **推荐**: 使用 `.env` 文件管理密钥并加入 `.gitignore`

### 可用性分类
- **分类**: MD+EXEC（纯Markdown指令，核心功能需要exec执行HTTP请求）
- **说明**: 基于Markdown的AI Skill，通过自然语言指令驱动Agent输出 Discord Bot 开发方案

## 已知限制

本免费体验版限制以下高级功能：
- Gateway 网关实时事件处理（仅专业版提供）
- 高级限流与重试策略（仅专业版提供）
- 消息组件（按钮/下拉菜单/模态框）深度集成（仅专业版提供）
- Embed 富文本与文件上传（仅专业版提供）
- 多服务器管理与批量命令部署（仅专业版提供）
- Webhook 与自动化流水线集成（仅专业版提供）

解锁全部功能请使用专业版：discord-master-pro
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
## 错误处理

| 错误场景 | 原因 | 处理方式 |
|---:|:---|---:|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |

## 输出格式
```json
{
  "success": true,
  "data": {
    "result": "Discord开发助手(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "discord master"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}
```
Discord Master Free

SKILL.md

related skills
