Discord Community Hub Free

基础 Discord 社区管理工具,支持用户信息、服务器列表与基础集成查询。

Install

openclaw skills install @thcjp/discord-community-hub-free

Discord 社区中心(免费版)

概述

Discord 社区中心免费版是一款面向个人社区管理者的 Discord 社区基础管理工具。它通过集成网关连接 Discord 账号,提供当前用户资料查询、已加入服务器列表、服务器成员与角色信息、服务器小组件(widget)与邀请详情等只读查询能力,以及基础集成连接与工具发现功能。

免费版聚焦安全低风险的只读操作,适合个人 Discord 社区的日常信息查询和小型服务器的概览管理。所有写操作(如离开服务器、修改用户信息、编辑命令权限)在免费版中不可用,如需这些能力请升级至 Pro 版。

核心能力

能力模块	说明	免费版支持
用户资料	查询当前用户信息	支持
服务器列表	列出已加入的服务器	支持
成员信息	查询服务器成员资料	支持
角色信息	查询服务器角色概况	支持(只读)
服务器组件	获取 widget 与邀请详情	支持
集成连接	连接 Discord 账号	支持
工具发现	列出与搜索可用工具	支持
应用命令	管理命令权限	不支持
权益管理	订阅与 entitlement	不支持
角色连接	元数据更新	不支持
用户修改	修改用户名/头像	不支持

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：社区管理工具、支持用户信息、服务器列表与基础、集成查询、面向个人社区管理、社区基础管理工具、核心能力、查询当前用户资料、与已加入服务器列、获取服务器成员信、息与角色概况、查询服务器小组件、基础集成连接与工等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:查询个人 Discord 账号概况

想快速了解自己 Discord 账号的基本信息和已加入的服务器。

javascript

// 1. 获取当前用户资料
const me = await integration.call_tool({
  tool: "discord_get_my_user",
  parameters: {}
});

// 2. 列出已加入的服务器
const guilds = await integration.call_tool({
  tool: "discord_list_my_guilds",
  parameters: {}
});

// 3. 获取自己在某服务器的成员信息
const member = await integration.call_tool({
  tool: "discord_get_my_guild_member",
  parameters: { guild_id: "123456789" }
});

返回结果包含用户名、ID、头像、已加入服务器列表及各服务器的成员角色、昵称、加入时间等。

场景二:服务器概览与邀请解析

新建社区后,想确认服务器组件状态并解析分享出去的邀请链接。

javascript

// 1. 获取服务器 widget(JSON 格式)
const widget = await integration.call_tool({
  tool: "discord_get_guild_widget",
  parameters: { guild_id: "123456789" }
});

// 2. 获取 widget 图片(PNG)
const widgetPng = await integration.call_tool({
  tool: "discord_get_guild_widget_png",
  parameters: { guild_id: "123456789" }
});

// 3. 解析邀请码详情
const invite = await integration.call_tool({
  tool: "discord_invite_resolve",
  parameters: { invite_code: "abc123xyz" }
});

场景三:集成工具发现

连接 Discord 后,想了解可用的工具集。

javascript

// 1. 确认 Discord 已连接
const integrations = await integration.list_integrations();

// 2. 列出 Discord 可用工具
const tools = await integration.list_tools({ integration: "discord" });

// 3. 搜索特定功能工具
const found = await integration.search_tools({
  query: "guild",
  integration: "discord"
});

不适用场景

以下场景Discord社区中心免费版不适合处理：

逆向工程闭源API
API安全渗透测试
非标准协议集成

触发条件

需要API集成、接口对接、Webhook配置、系统连接时使用。不适用于非本工具能力范围的需求。

快速开始

依赖详情

在 Agent 平台安装集成网关插件:

text

platform plugins install integration-gateway

安装后开启新的对话会话以加载插件目录。

第二步:配对集成网关

javascript

// 1. 发起配对
const pairing = await integration.begin_pairing();

// 2. 在浏览器中打开返回的 URL
// 3. 登录集成网关并批准设备

第三步:连接 Discord 账号

在集成网关控制台中,打开 Discord 连接页面,完成 OAuth 授权流程,确认连接成功。

第四步:验证连接

javascript

// 验证 Discord 已连接
const connected = await integration.list_integrations();

// 列出可用工具
const tools = await integration.list_tools({ integration: "discord" });

示例

用户资料查询

javascript

// 获取当前用户完整资料
await integration.call_tool({
  tool: "discord_get_my_user",
  parameters: {}
});

// 获取 OAuth2 授权详情(含 scope 与过期时间)
await integration.call_tool({
  tool: "discord_get_my_oauth2_authorization",
  parameters: {}
});

// 获取 OIDC 用户信息(符合 OpenID Connect)
await integration.call_tool({
  tool: "discord_get_openid_connect_userinfo",
  parameters: {}
});

服务器信息查询

javascript

// 获取任意用户信息(传 '@me' 表示当前用户)
await integration.call_tool({
  tool: "discord_get_user",
  parameters: { user_id: "@me" }
});

// 列出已连接的第三方账号
await integration.call_tool({
  tool: "discord_list_my_connections",
  parameters: {}
});

// 获取服务器模板详情
await integration.call_tool({
  tool: "discord_get_guild_template",
  parameters: { template_code: "abc123" }
});

网关与工具

javascript

// 获取 WebSocket 网关 URL
await integration.call_tool({
  tool: "discord_get_gateway",
  parameters: {}
});

// 获取 OAuth2 公钥(用于外部 JWT 验证)
await integration.call_tool({
  tool: "discord_get_public_keys",
  parameters: {}
});

// 列出 Nitro 贴纸包
await integration.call_tool({
  tool: "discord_list_sticker_packs",
  parameters: {}
});

最佳实践

优先只读操作: 免费版聚焦只读查询,安全无风险。在进行任何管理操作前,先用只读工具确认当前状态(如先查成员信息再考虑角色调整)。
Widget 需服务器开启: 获取服务器 widget 前需在服务器设置 → Widget 中开启「启用服务器组件」。未开启时调用会返回错误。
邀请码及时解析: 分享邀请链接前用 discord_invite_resolve 解析确认有效期和目标服务器,避免邀请过期或指向错误服务器。
集成工具检索技巧: 使用 search_tools 按功能关键词搜索(如 "guild"、"member"、"role"),快速定位所需工具,避免在长列表中手动翻找。
OAuth scope 确认: 连接 Discord 时注意授权范围(scope)。基础查询只需 identify + guilds;如需邮箱需 email scope。scope 不足会导致部分工具报错,可重新连接补全。
凭证安全: 集成网关仅存储 OAuth 令牌,不存储原始机器人令牌。设备凭证保存在本地插件配置中。切勿在代码或配置中硬编码任何令牌。
区分令牌类型: 机器人令牌(Bot Token)与 OAuth2 Bearer 令牌能力不同。部分工具(如编辑命令权限)需要 Bearer 令牌,使用机器人令牌会报错。按工具要求使用对应令牌类型。

常见问题

Q1: 安装插件后工具不显示怎么办?

安装集成网关插件后,需开启新的对话会话以重新加载插件目录。若仍不显示,调用 list_integrations 确认集成网关已配对成功,再调用 list_tools 检查 Discord 工具是否注册。

Q2: 获取 widget 报错「Guild widget disabled」?

服务器组件需在 Discord 服务器设置 → Widget 中手动开启「启用服务器组件」。未开启时调用 discord_get_guild_widget 会返回错误。请服务器管理员开启后重试。

Q3: 「401 Unauthorized」错误是什么原因?

通常是令牌类型不匹配。查询类操作使用 OAuth2 Bearer 令牌;若误用机器人令牌会返回 401。请确认集成网关使用的是 OAuth2 授权流程获取的 Bearer 令牌,并在连接时授予了足够 scope。

Q4: 免费版能修改用户名或头像吗?

不能。修改用户资料(discord_modify_current_user)属于写操作,免费版不提供。如需修改用户名(每小时限 2 次)或头像,请升级至 Pro 版。免费版仅支持只读查询。

Q5: 「Username change limit reached」是什么?

Discord 限制用户名每小时最多修改 2 次。频繁修改会触发此限制,需等待后再试。这是 Discord 平台限制,与工具版本无关。

Q6: 如何确认连接的 scope 是否足够?

调用 discord_get_my_oauth2_authorization 可查看当前授权的 scope 列表和令牌过期时间。若某工具报权限不足,对比工具要求的 scope 与当前已授权 scope,缺失的需重新连接 Discord 补全授权。

Q7: 集成网关存储哪些凭证?

集成网关仅存储 OAuth 令牌(用于访问 Discord API),不存储原始机器人令牌或密码。设备凭证保存在本地 Agent 插件配置中。discord_get_public_keys 用于验证外部 JWT,不用于存储密钥。

依赖说明

运行环境

Agent 平台: 支持解析 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
操作系统: Windows / macOS / Linux
网络: 需可访问 Discord API 与集成网关
浏览器: OAuth 授权流程需在浏览器中完成

第三方依赖

依赖项	类型	是否必需	获取方式
LLM 能力	API	必需	由 Agent 内置大模型提供
集成网关插件	插件	必需	Agent 平台插件市场安装
Discord OAuth2	授权	必需	Discord Developer Portal 注册应用
Discord API	服务	必需	Discord 平台提供
浏览器	运行时	必需	用于 OAuth 授权流程

API Key 配置

OAuth2 应用: 在 Discord Developer Portal 注册 OAuth2 应用,获取 Client ID 和 Client Secret。
授权 scope: 基础查询需 identify + guilds scope;获取邮箱需 email scope;OIDC 需 openid scope。按需配置。
集成网关配对: 通过集成网关完成设备配对,凭证保存在本地插件配置中,无需手动管理令牌。
其他 API Key: 免费版不依赖额外 API Key。

可用性分类

分类: MD+EXEC(纯 Markdown 指令 + 部分功能需 exec 执行能力)
说明: 以自然语言指令驱动 Agent 通过集成网关调用 Discord 工具完成社区查询
适用规模: 个人/小团队,只读查询为主,无写操作风险
升级建议: 如需应用命令管理、权益管理、角色连接、用户修改等写操作,请升级至 discord-community-hub-pro

错误处理

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

已知限制

需LLM支持,无LLM环境不可用
复杂业务场景建议结合人工经验判断
执行效率受模型能力与网络环境影响