---
slug: discord-communities
name: discord-communities
version: "1.0.6"
displayName: Discord
summary: "管Discord guild/频道/消息/成员/角色/应用命令"
  commands - powered by ...
license: MIT-0
description: |-
  Manage Discord guilds, channels, messages, members, roles, and application
  commands - powered by 。Use when 需要设计创作、UI设计、海报制作、品牌视觉时使用。不适用于3D建模和动画制作。适用于独立开发者、企业团队和自动化工作流场景。
tags:
- Communication
tools:
  - - read
- exec
pricing_tier: "L4"
pricing_model: "monthly"
suggested_price: 99.9
---


# Discord

Work with Discord from chat — manage guilds, channels, messages, members, roles, and application commands.

Powered by [ClawLink](https://claw-link.dev/?utm_source=SkillHub&utm_medium=referral&utm_content=discord-communities), an integration hub for Skill平台 that handles hosted connection flows and credentials so you don't need to configure Discord API access yourself.

### Setup in 3 Steps

| Step 1: Install | Step 2: Pair Account | Step 3: Connect Discord |
| --- | --- | --- |
|  |  | *App-specific connection GIF coming soon* |
| Run the install command in Skill平台 | Sign in and approve the device | Open the dashboard and connect Discord |

## Connection flow

```text
User → ClawLink OAuth → Discord account
         ↓
    Skill平台 tools
    (via ClawLink)
```

**Step 1** — Install the ClawLink plugin:

```text
skill-platform plugins install SkillHub:clawlink-plugin
```

Start a fresh chat after installing.

**Step 2** — Pair ClawLink:

1. Call `clawlink_begin_pairing`
2. Open the returned URL in your browser
3. Sign in to ClawLink and approve the device

**Step 3** — Connect Discord:
Open [claw-link.dev/dashboard?add=discord](https://claw-link.dev/dashboard?add=discord), complete the OAuth flow, then confirm.

*App-specific connection GIF coming soon*

**Step 4** — Verify and discover:

```javascript
// 1. Verify Discord is connected
clawlink_list_integrations()

// 2. List available tools
clawlink_list_tools({ integration: "discord" })

// 3. Search tools if needed
clawlink_search_tools({ query: "guild", integration: "discord" })
```

## Architecture

```text
┌─────────────────────────────────────────────────────────┐
│                    Skill平台 (you)                       │
├─────────────────────────────────────────────────────────┤
│  ClawLink Plugin  →  clawlink_* tools                   │
├─────────────────────────────────────────────────────────┤
│                    ClawLink Cloud                       │
│         (credentials, connection state, routing)        │
├─────────────────────────────────────────────────────────┤
│              Discord API (user's account)              │
└─────────────────────────────────────────────────────────┘
```

## Tool reference

### User & identity

| Tool | Description | Risk |
| --- | --- | --- |
| `discord_get_my_user` | Get current user's profile (email if email scope granted) | safe |
| `discord_get_user` | Get any Discord user by ID (use '@me' for authenticated user) | safe |
| `discord_get_openid_connect_userinfo` | Get OIDC-compliant user claims (sub, email, picture, locale) | safe |
| `discord_get_my_oauth2_authorization` | Get OAuth2 authorization details, scopes, token expiration | safe |
| `discord_list_my_connections` | List user's connected third-party accounts on Discord | safe |
| `discord_list_my_guilds` | List current user's guilds (partial data for display) | safe |
| `discord_get_my_guild_member` | Get guild member info for current user (roles, nickname, join date) | safe |

### Guilds & widgets

| Tool | Description | Risk |
| --- | --- | --- |
| `discord_get_guild_template` | Get Discord guild template details by template code | safe |
| `discord_get_guild_widget` | Get guild widget JSON (guild widget must be enabled) | safe |
| `discord_get_guild_widget_png` | Get PNG image widget for a guild | safe |
| `discord_leave_guild` | Leave a guild on behalf of the authenticated user | high_impact |

### Application commands & permissions

| Tool | Description | Risk |
| --- | --- | --- |
| `discord_get_application_command_permissions` | Get permissions for a specific command in a guild | safe |
| `discord_get_batch_application_command_permissions` | Get permissions for all commands in a guild | safe |
| `discord_edit_application_command_permissions` | Edit permissions for a specific command (requires MANAGE_GUILD) | confirm |

### Entitlements & commerce

| Tool | Description | Risk |
| --- | --- | --- |
| `discord_get_current_user_application_entitlements` | Get user's premium entitlements for an application | safe |
| `discord_get_sku_subscription` | Get a specific subscription by ID for a SKU | safe |
| `discord_list_sku_subscriptions` | List all subscriptions for a SKU | safe |
| `discord_consume_entitlement` | Mark a consumable entitlement as consumed | confirm |
| `discord_delete_test_entitlement` | Delete a test entitlement (cleanup) | high_impact |

### Role connections

| Tool | Description | Risk |
| --- | --- | --- |
| `discord_get_user_application_role_connection` | Get user's role connection metadata for an app | safe |
| `discord_update_user_application_role_connection` | Update user's role connection (requires role_connections.write scope) | confirm |
| `discord_delete_user_application_role_connection` | Delete user's role connection metadata | high_impact |

### Gateway & utilities

| Tool | Description | Risk |
| --- | --- | --- |
| `discord_get_gateway` | Get valid WebSocket URL for Gateway connection | safe |
| `discord_get_public_keys` | Get OAuth2 public keys for token verification | safe |
| `discord_invite_resolve` | Resolve and get details about an invite code | safe |
| `discord_list_sticker_packs` | List all available Discord Nitro sticker packs | safe |

### User modification

| Tool | Description | Risk |
| --- | --- | --- |
| `discord_modify_current_user` | Modify current user's username (max 2 changes/hour) and avatar | confirm |

## 示例

### Example 1: Get user info and guilds

```javascript
// Get current user's profile
const me = await clawlink_call_tool({
  tool: "discord_get_my_user",
  parameters: {}
});

// List the user's guilds
const guilds = await clawlink_call_tool({
  tool: "discord_list_my_guilds",
  parameters: {}
});

// Get guild member info for yourself
const member = await clawlink_call_tool({
  tool: "discord_get_my_guild_member",
  parameters: { guild_id: "123456789" }
});
```

### Example 2: Check application entitlements

```javascript
// Get user's entitlements for an application
const entitlements = await clawlink_call_tool({
  tool: "discord_get_current_user_application_entitlements",
  parameters: { application_id: "987654321" }
});

// List subscriptions for a SKU
const subs = await clawlink_call_tool({
  tool: "discord_list_sku_subscriptions",
  parameters: { sku_id: "123456789" }
});
```

### Example 3: Manage role connections

```javascript
// Get current user's role connection
const roleConn = await clawlink_call_tool({
  tool: "discord_get_user_application_role_connection",
  parameters: { application_id: "987654321" }
});

// Update role connection metadata
await clawlink_call_tool({
  tool: "discord_update_user_application_role_connection",
  parameters: {
    application_id: "987654321",
    metadata: {
      custom_fields: [
        { name: "Xbox Gamertag", value: "PlayerOne" }
      ]
    }
  }
});
```

### Example 4: Resolve invites and check widget

```javascript
// Resolve an invite code
const invite = await clawlink_call_tool({
  tool: "discord_invite_resolve",
  parameters: { invite_code: "abc123xyz" }
});

// Get guild widget PNG for embedding
const widget = await clawlink_call_tool({
  tool: "discord_get_guild_widget_png",
  parameters: { guild_id: "123456789" }
});
```

## Error handling

| Error pattern | Likely cause | Resolution |
| --- | --- | --- |
| `401 Unauthorized` | Bot token used where Bearer required | Use OAuth2 Bearer token authentication |
| `Missing MANAGE_GUILD permission` | Not authorized to edit command permissions | User needs to grant proper Discord permissions |
| `Guild widget disabled` | Widget not enabled in server settings | Server admin must enable widget in Discord settings |
| `Username change limit reached` | Already changed username 2+ times this hour | Wait before retrying |
| `Role connection write scope missing` | OAuth2 lacks role_connections.write scope | User may need to reconnect Discord with full scopes |

## Security & Permissions

* ClawLink stores only the OAuth token, never the raw bot token
* Device credentials are stored locally in Skill平台 plugin config
* Bot tokens vs OAuth2 Bearer tokens have different capabilities — some tools error with bot tokens
* `discord_get_public_keys` is for verifying external JWTs, not for storing keys

## Troubleshooting

**Tools not showing up after install:**

* Start a fresh Skill平台 chat to reload the plugin catalog
* Call `clawlink_list_integrations` to confirm ClawLink is paired

**"Permission denied" when editing command permissions:**

* Requires OAuth2 Bearer token (bot tokens will error)
* User must have both MANAGE_GUILD and MANAGE_ROLES permissions in the target guild

**Cannot get guild widget:**

* Widget must be enabled in Discord server settings
* Server admin must toggle "Enable Server Widget" in Server Settings > Widget

---

Powered by [ClawLink](https://claw-link.dev/?utm_source=SkillHub&utm_medium=referral&utm_content=discord-communities) — your Skill平台 integration hub for Discord.

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- **操作系统**: Windows / macOS / Linux

### 依赖说明
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
- 本Skill基于Markdown指令,无需额外API Key(除内容中明确标注的外部API)

### 可用性分类
- **分类**: MD+EXEC(纯Markdown指令,部分功能需要exec命令行执行能力)
- **说明**: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行任务

## 核心能力

- Manage Discord guilds, channels, messages, members, roles, and application
  commands - powered by
- 触发关键词: discord, guilds, channels, manage, communities, messages

## 适用场景

| 场景 | 输入 | 输出 |
|------|------|------|
| 基础使用 | 用户请求 | 处理结果 |

**不适用于**：需要人工判断的复杂决策场景

## 使用流程

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

## 常见问题

### Q1: 如何开始使用Discord？
A: 请先阅读使用流程章节，确认环境满足依赖说明中的要求。

### Q2: 遇到错误怎么办？
A: 请参考错误处理章节，按照表格中的处理方式操作。

### Q3: Discord有什么限制？
A: 请参考已知限制章节了解具体限制。

## 已知限制

- 需要LLM支持，无LLM环境无法使用
- 复杂场景可能需要人工辅助判断
- 性能取决于底层模型能力