Discord

核心用法

Discord Communities 技能通过 ClawLink 集成平台，让用户能够在 OpenClaw 聊天环境中直接调用 Discord API，实现服务器管理、用户信息查询、应用权限配置等操作。该技能采用 OAuth2 授权流程，用户无需自行搭建 Discord 应用或处理复杂的 API 凭证管理。

关键功能模块：

• 用户与身份管理：获取当前用户资料、OAuth2 授权详情、关联的第三方账号
• 服务器（Guild）操作：查看服务器模板、获取服务器挂件、退出服务器
• 应用命令权限：查询和编辑 Discord 应用命令在特定服务器的权限配置
• 订阅与权益：管理用户的付费权益、SKU 订阅状态
• 角色连接：同步外部平台身份标识到 Discord 角色系统

显著优点

1. 零配置接入：通过 ClawLink 托管 OAuth 流程，消除手动创建 Discord App、管理 Bot Token 的门槛
2. 安全凭证隔离：ClawLink 云端存储 OAuth Token，本地仅保留设备配对凭证，降低密钥泄露风险
3. 风险分级工具：每个工具标注安全等级（safe / confirm / high_impact），修改类操作需额外确认
4. 标准化错误处理：文档明确列出 401 权限错误、速率限制、功能未启用等场景的诊断方案

潜在缺点与局限性

• 功能边界受限：当前工具集侧重"用户视角"操作，缺少频道消息发送、成员批量管理、角色创建等核心管理功能
• 速率限制敏感：用户名修改每小时限 2 次，高频操作易触发 Discord 全局限流
• OAuth 范围依赖：部分功能（如 role_connections.write）需用户重新授权扩展范围
• Widget 功能前提：服务器挂件查询依赖管理员在 Discord 设置中手动启用
• Bot Token 不兼容：明确区分 OAuth Bearer Token 与 Bot Token，后者会导致特定工具报错

适合人群

• 需要快速查询 Discord 用户/服务器信息的运营人员
• 管理 Discord 应用（Bot）权限配置的开发者
• 集成外部平台身份（如 Xbox、Steam）到 Discord 角色的社区管理员
• 希望避免自建 Discord API 基础设施的小团队

常规风险

| 风险类型 | 说明 | 缓解措施 |

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

| 账号操作风险 | `discord_leave_guild` 和角色删除操作不可逆 | 工具标注 high_impact，建议二次确认 |

| 权限提升风险 | `discord_edit_application_command_permissions` 可能影响服务器安全 | 需 MANAGE_GUILD 权限，非管理员无法执行 |

| 数据泄露风险 | 用户邮箱、关联账号信息通过 API 返回 | ClawLink 仅存储必要 Token，不缓存用户数据 |

| 订阅误操作 | `discord_consume_entitlement` 标记权益为已消耗 | 操作前需 confirm 级别确认 |

架构安全评估

该技能采用三层架构隔离：OpenClaw 本地 → ClawLink 云端 → Discord API。凭证由 ClawLink 托管而非用户本地存储，降低了密钥硬编码泄露风险。但需注意 ClawLink 作为中心化枢纽，成为潜在的供应链攻击目标，建议关注其安全公告。

核心用法

Discord Communities 技能通过 ClawLink 集成枢纽，让用户无需自行配置 API 密钥即可管理 Discord 服务器。使用流程分为四步：安装 ClawLink 插件、完成设备配对、通过 OAuth 授权连接 Discord 账号，最后验证并调用工具。该技能涵盖六大功能模块：用户身份管理（获取用户信息、所属公会列表）、公会与小部件操作（查看模板、生成 widget 图片、退出公会）、应用命令权限管理、订阅与权益查询、角色连接元数据管理，以及网关工具与邀请解析。

所有工具调用均通过 clawlink_call_tool 统一接口发起，ClawLink 云端负责凭证托管、状态维护和请求路由，最终与 Discord 官方 API 交互。这种托管架构让用户专注业务逻辑，无需处理 OAuth 流程的复杂性。

显著优点

零配置接入：传统 Discord 机器人需要开发者账号、Bot Token、权限配置等繁琐步骤，该技能通过 ClawLink 托管服务实现"即装即用"，大幅降低技术门槛。

权限细分清晰：每个工具都标注了风险等级（safe/confirm/high_impact），帮助用户预判操作影响。例如修改用户资料需要 confirm 级别确认，而离开公会属于 high_impact 高风险操作。

覆盖场景全面：从基础的用户信息查询、公会成员管理，到进阶的应用命令权限配置、SKU 订阅查询、角色连接元数据更新，满足社区运营、付费权益管理、自动化运营等多层次需求。

安全架构隔离：ClawLink 仅存储 OAuth 令牌而非原始 Bot Token，设备凭证本地存储，符合最小权限原则。

潜在缺点与局限性

依赖 ClawLink 服务可用性：整个功能链路强依赖 ClawLink 云服务，若该服务中断或变更，技能将完全失效。用户无法切换到自建代理或直接使用 Discord API。

OAuth 权限范围受限：部分功能需要特定 OAuth scope（如 role_connections.write），若用户初次授权未包含，需重新完成连接流程，无法动态扩展权限。

变更频率限制：Discord 对用户资料修改有严格限速（如用户名每小时最多更改 2 次），高频自动化场景可能触发限制。

无消息发送能力：当前工具集聚焦于管理类操作，不包含发送频道消息、私信、创建 webhook 等消息交互功能，不适合需要主动推送内容的自动化场景。

guild widget 功能受限：小部件功能需要服务器管理员在 Discord 设置中手动开启，技能无法自动启用，存在功能可用性外部依赖。

适合的目标群体

社区运营者：需要批量管理 Discord 服务器成员、角色、权限配置，或监控付费订阅状态的社群管理员。

Discord 机器人开发者：希望快速验证 Discord API 功能、调试权限配置，或作为现有 bot 功能的补充管理后台。

内容创作者与 DAO 组织者：拥有多个 Discord 服务器，需要统一查看成员分布、权益状态，简化多服务器运营复杂度。

企业 IT 管理员：需要通过标准化工具审计员工在 Discord 上的组织归属、第三方账号连接情况，满足合规检查需求。

使用风险

性能延迟风险：所有请求需经 ClawLink 云端中转，相比直连 Discord API 增加一层网络跳数，在高并发场景下可能存在额外延迟。

凭证生命周期风险：OAuth 令牌存在过期时间，长期使用需关注 discord_get_my_oauth2_authorization 返回的过期时间，避免在关键操作时因令牌失效导致中断。

权限误操作风险：discord_edit_application_command_permissions 和 discord_leave_guild 等工具对服务器配置有实质影响，建议在执行前通过 discord_get_batch_application_command_permissions 等查询工具确认当前状态。

服务锁定风险：技能与 ClawLink 深度绑定，若未来需要迁移到其他集成方案，可能面临工具接口不兼容的切换成本。