Discord

核心用法

Discord Communities 技能通过 ClawLink 集成中心，让用户在 OpenClaw 对话环境中直接操作 Discord API。采用三层架构：OpenClaw 客户端 → ClawLink Cloud（托管凭证与路由）→ Discord API。用户只需完成 OAuth 授权，无需本地存储 Bot Token 或处理复杂的权限配置。

功能覆盖四大领域：

• 用户与身份：获取个人资料、已加入服务器列表、成员信息
• 服务器管理：获取模板、服务器挂件、离开服务器
• 应用指令与权限：查询和修改指令权限（需 MANAGE_GUILD）
• 商业与权益：查询订阅权益、SKU 订阅管理

显著优点

1. 零配置接入：ClawLink 托管 OAuth 流程，用户无需创建 Discord App 或管理 Bot Token
2. 安全隔离：凭证仅存于 ClawLink 云端，本地仅保留设备配对信息，降低密钥泄露风险
3. 风险分级工具：每个工具标注 risk 等级（safe/confirm/high_impact），敏感操作需确认
4. 完整功能集：覆盖用户数据、服务器管理、商业权益、角色连接等官方 API 能力

潜在缺点与局限性

• 依赖 ClawLink 可用性：服务中断将完全阻断 Discord 功能访问
• OAuth 范围限制：部分功能需特定 scope（如 role_connections.write），用户可能需重新授权
• 速率限制继承：受 Discord API 全局速率限制，高频操作可能触发 429
• 非实时 Gateway：仅提供 REST API 工具，无 WebSocket Gateway 实时事件监听
• 商业功能局限：SKU/订阅管理需应用拥有者权限，普通用户场景有限

适合人群

• Discord 服务器管理员需批量查询或修改配置
• 开发者调试应用指令权限与权益系统
• 需要快速获取用户/服务器数据而不想搭建 Discord Bot 的用户
• 重视凭证安全、不愿自行托管 Bot Token 的团队

常规风险

| 风险场景 | 说明 |

|---------|------|

| 凭证托管信任 | ClawLink 作为第三方托管 OAuth token，需信任其安全实践 |

| 权限误操作 | `discord_leave_guild` 和权限编辑类工具标记为 high_impact/confirm，误触可导致不可逆后果 |

| scope 不足 | 部分工具调用失败源于授权时未包含必要 scope，需重新走 OAuth 流程 |

| 用户名修改限制 | 每小时仅允许修改 2 次用户名，超限需等待 |

核心用法

discord-communities 是一款面向 OpenClaw 平台的 Discord 集成管理技能，通过 ClawLink 代理服务间接调用 Discord API，无需用户自行配置复杂的 API 凭证。该技能采用纯 Markdown 文档架构，核心操作均通过 clawlink_call_tool 函数触发，涵盖用户身份查询、公会（Guild）管理、应用指令权限控制、会员权益查询、角色连接配置等六大功能模块。

使用流程分为三步：首先安装 ClawLink 插件，随后完成 OAuth 账户配对，最后在 ClawLink 仪表板中授权 Discord 连接。授权完成后，用户可调用 30+ 个 Discord 相关工具，包括获取当前用户信息、列出所属公会、修改用户名（每小时限 2 次）、解析邀请链接、获取公会挂件等。技能将工具按风险等级标注为 safe、confirm、high_impact 三级，引导用户安全操作。

显著优点

零配置接入：通过 ClawLink 托管的 OAuth 流程，用户无需创建 Discord 机器人或管理 Bot Token，大幅降低技术门槛。风险分级管控：每个工具明确标注安全等级，high_impact 操作（如离开公会、删除权益）需额外确认，有效防止误操作。功能覆盖全面：从只读查询到写操作，涵盖个人资料管理、公会运营、商业化权益（SKU 订阅）等多场景需求。架构透明可信：ClawLink 仅存储 OAuth Token 而非原始 Bot Token，且设备凭证本地存储，减少敏感信息泄露面。

潜在缺点与局限性

依赖第三方代理：所有 Discord API 请求需经 ClawLink 中转，形成额外的信任链条，若 ClawLink 服务中断或策略变更，技能将不可用。OAuth 权限约束：部分高级功能（如编辑应用指令权限）要求用户具备 MANAGE_GUILD 等 Discord 服务器权限，且需特定 OAuth Scope，普通成员无法使用。速率限制敏感：Discord API 本身存在严格限流（如用户名修改每小时 2 次），技能未提供速率管理抽象，用户需自行控制调用频率。纯文档型设计：无本地可执行代码意味着功能完全依赖 ClawLink 服务端实现，无法离线使用或自定义扩展。T3 来源可信度：作为个人开发者（hith3sh）维护的社区项目，长期维护承诺与功能迭代速度存在不确定性。

适合的目标群体

该技能主要面向三类用户：社区运营者需要同时管理多个 Discord 服务器，快速查询成员信息、审核邀请链接、检查公会挂件状态；Discord 机器人开发者调试应用指令权限、测试会员权益系统（Entitlements）；内容创作者管理粉丝社群，批量处理角色连接（Role Connections）以实现跨平台身份联动。不适合需要深度自定义 Bot 逻辑、或要求直接访问 Discord Gateway WebSocket 的进阶开发者。

使用风险与注意事项

供应链风险：ClawLink 作为中间代理服务，其安全实践与隐私政策直接影响用户数据安全，建议定期审查 OAuth 授权范围并及时撤销闲置授权。操作不可逆性：high_impact 级别的工具（如 discord_leave_guild、discord_delete_user_application_role_connection）执行后无法撤回，务必在执行前验证目标对象。Token 泄露防范：虽然 ClawLink 声称不存储原始 Bot Token，但 OAuth Token 仍具备账户操作权限，需确保 OpenClaw 运行环境安全，避免插件配置文件被窃取。网络依赖：技能运行时需持续访问 claw-link.dev 和 GitHub 静态资源，网络波动可能影响工具发现与调用。