Discord

!Discord

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

Powered by ClawLink, an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Discord API access yourself.

Setup in 3 Steps

Connection flow

User → ClawLink OAuth → Discord account
         ↓
    OpenClaw tools
    (via ClawLink)

Step 1 — Install the ClawLink plugin:

openclaw plugins install clawhub: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, complete the OAuth flow, then confirm.

App-specific connection GIF coming soon

Step 4 — Verify and discover:

// 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

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

Tool reference

User & identity

Guilds & widgets

Application commands & permissions

Entitlements & commerce

Role connections

Gateway & utilities

User modification

Code examples

Example 1: Get user info and guilds

// 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

// 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

// 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

// 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

Security & Permissions

• ClawLink stores only the OAuth token, never the raw bot token
• Device credentials are stored locally in OpenClaw 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 OpenClaw 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 — your OpenClaw integration hub for Discord.