discord-bot

name	discord-bot
description	Discord Bot API integration with managed OAuth. Send messages, manage channels, moderate guilds, handle roles, create webhooks, and automate Discord server operations. Use this skill when users want to manage Discord servers, send messages to channels, moderate users, create invites, or automate bot interactions.

Discord Bot

Automate Discord server management from chat -- send messages, moderate members, manage channels and roles, create webhooks, and handle scheduled events. Powered by ClawLink for hosted OAuth so you never handle bot tokens directly.

Setup in 3 Steps

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

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  Discord API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

// 1. List guild channels
clawlink_call_tool({ tool: "discordbot_list_guild_channels", parameters: { guild_id: "123456789" } })

// 2. Send a message
clawlink_call_tool({ tool: "discordbot_create_message", parameters: { channel_id: "987654321", content: "Hello from OpenClaw!" } })

// 3. List guild members
clawlink_call_tool({ tool: "discordbot_list_guild_members", parameters: { guild_id: "123456789", limit: 50 } })

Authentication

ClawLink handles the full OAuth flow -- no API keys or bot tokens to manage. After pairing, connect Discord Bot at claw-link.dev/dashboard?add=discord-bot.

Connection Management

// List active connections
clawlink_list_integrations()

// Verify connection works
clawlink_call_tool({ tool: "discordbot_test_auth", parameters: {} })

// Reconnect if needed
// Visit https://claw-link.dev/dashboard?add=discord-bot

Security & Permissions

• Read tools (list, get) are safe and require no confirmation
• Write tools (create, update, delete) require confirmation before execution
• High-impact tools (ban, bulk delete, prune) are destructive and irreversible
• Bot permissions depend on the roles assigned in each guild

Tool Reference

Messaging Operations

Tool	Description	Mode
discordbot_create_message	Send a message to a channel (text, embeds, stickers, components)	Write
discordbot_update_message	Edit a message previously sent by the bot	Write
discordbot_delete_message	Permanently delete a message	Write
discordbot_list_messages	Retrieve messages from a channel (newest first, paginated)	Read
discordbot_get_message	Retrieve a specific message by ID	Read
discordbot_crosspost_message	Crosspost from announcement channel to followers	Write
discordbot_pin_message	Pin a message in a channel (max 50 pinned)	Write
discordbot_unpin_message	Unpin a message from a channel	Write
discordbot_list_pinned_messages	List all pinned messages (up to 50)	Read
discordbot_trigger_typing_indicator	Show bot typing indicator (lasts 10 seconds)	Write

Reaction Operations

Tool	Description	Mode
discordbot_add_my_message_reaction	Add emoji reaction from bot to a message	Write
discordbot_delete_my_message_reaction	Remove bot's own reaction from a message	Write
discordbot_delete_user_message_reaction	Remove a specific user's reaction	Write
discordbot_delete_all_message_reactions	Remove all reactions from a message	Write
discordbot_delete_all_message_reactions_by_emoji	Remove all reactions for a specific emoji	Write
discordbot_list_message_reactions_by_emoji	List users who reacted with a specific emoji	Read

Channel Operations

Tool	Description	Mode
discordbot_create_guild_channel	Create a new channel (text, voice, category, etc.)	Write
discordbot_update_channel	Update channel settings (name, topic, permissions)	Write
discordbot_delete_channel	Permanently delete a channel	Write
discordbot_get_channel	Retrieve channel metadata by ID	Read
discordbot_list_guild_channels	List all channels in a guild	Read
discordbot_set_channel_permission_overwrite	Set permission overrides for role/user in a channel	Write
discordbot_delete_channel_permission_overwrite	Remove channel-specific permission overrides	Write
discordbot_follow_channel	Follow announcement channel to relay via webhook	Write

Thread Operations

Tool	Description	Mode
discordbot_create_thread	Create a new thread in a channel	Write
discordbot_create_thread_from_message	Create thread from a specific message	Write
discordbot_join_thread	Join the authenticated user to a thread	Write
discordbot_leave_thread	Leave a thread	Write
discordbot_add_thread_member	Add a user to a thread	Write
discordbot_delete_thread_member	Remove a user from a thread	Write
discordbot_get_thread_member	Get a member from a thread	Read
discordbot_list_thread_members	List all members of a thread	Read
discordbot_get_active_guild_threads	List all active threads in a guild	Read
discordbot_list_public_archived_threads	List public archived threads	Read
discordbot_list_private_archived_threads	List private archived threads	Read
discordbot_list_my_private_archived_threads	List private archived threads you are in	Read

Guild (Server) Operations

Tool	Description	Mode
discordbot_create_guild	Create a new guild (bot must be in fewer than 10 guilds)	Write
discordbot_update_guild	Update guild settings (name, region, etc.)	Write
discordbot_delete_guild	Permanently delete a guild (owner only)	Write
discordbot_get_guild	Get guild details by ID	Read
discordbot_get_guild_preview	Get public guild preview	Read
discordbot_leave_guild	Bot leaves a guild (must be re-invited)	Write
discordbot_get_guild_widget	Get public JSON widget data	Read
discordbot_get_guild_widget_png	Get guild widget as PNG image	Read
discordbot_get_guild_widget_settings	Get widget settings	Read
discordbot_update_guild_widget_settings	Update widget settings	Write
discordbot_get_guild_welcome_screen	Get welcome screen configuration	Read
discordbot_update_guild_welcome_screen	Update welcome screen	Write
discordbot_get_guild_vanity_url	Get vanity URL invite code	Read
discordbot_get_guilds_onboarding	Get onboarding settings	Read
discordbot_put_guilds_onboarding	Configure guild onboarding flow	Write
discordbot_preview_prune_guild	Preview count of members to prune (does not remove)	Read
discordbot_prune_guild	Remove inactive members from guild	Write

Member Operations

Tool	Description	Mode
discordbot_list_guild_members	List guild members (paginated, requires GUILD_MEMBERS intent)	Read
discordbot_get_guild_member	Get specific member details	Read
discordbot_search_guild_members	Search members by username/nickname	Read
discordbot_add_guild_member	Add user to guild via OAuth2 token	Write
discordbot_update_guild_member	Update member nickname, roles, timeout, etc.	Write
discordbot_update_my_guild_member	Update bot's own nickname in a guild	Write
discordbot_delete_guild_member	Kick a member from guild	Write

Role Operations

Tool	Description	Mode
discordbot_create_guild_role	Create a new role in a guild	Write
discordbot_update_guild_role	Update role attributes (name, permissions, color)	Write
discordbot_delete_guild_role	Permanently delete a role	Write
discordbot_list_guild_roles	List all roles in a guild	Read
discordbot_add_guild_member_role	Assign a role to a member	Write
discordbot_delete_guild_member_role	Remove a role from a member	Write

Moderation Operations

Tool	Description	Mode
discordbot_ban_user_from_guild	Permanently ban a user from guild	Write
discordbot_bulk_ban_users_from_guild	Ban up to 200 users at once	Write
discordbot_unban_user_from_guild	Revoke a ban, allowing user to rejoin	Write
discordbot_get_guild_ban	Get ban details for a specific user	Read
discordbot_list_guild_bans	List all banned users	Read
discordbot_bulk_delete_messages	Delete 2-100 messages at once (must be less than 14 days old)	Write
discordbot_create_auto_moderation_rule	Create auto moderation rule	Write
discordbot_update_auto_moderation_rule	Update an auto moderation rule	Write
discordbot_delete_auto_moderation_rule	Delete an auto moderation rule	Write
discordbot_get_auto_moderation_rule	Get a specific auto moderation rule	Read
discordbot_list_auto_moderation_rules	List all auto moderation rules	Read
discordbot_list_guild_audit_log_entries	Retrieve audit log entries	Read

Invite Operations

Tool	Description	Mode
discordbot_create_channel_invite	Create invite link for a channel	Write
discordbot_invite_resolve	Resolve invite code to details	Read
discordbot_invite_revoke	Revoke an invite permanently	Write
discordbot_list_channel_invites	List active invites for a channel	Read
discordbot_list_guild_invites	List all active invites for a guild	Read

Scheduled Event Operations

Tool	Description	Mode
discordbot_create_guild_scheduled_event	Create a scheduled event	Write
discordbot_update_guild_scheduled_event	Update a scheduled event	Write
discordbot_delete_guild_scheduled_event	Delete a scheduled event	Write
discordbot_get_guild_scheduled_event	Get a specific scheduled event	Read
discordbot_list_guild_scheduled_events	List scheduled events in a guild	Read
discordbot_list_guild_scheduled_event_users	List users interested in an event	Read

Emoji & Sticker Operations

Tool	Description	Mode
discordbot_create_guild_emoji	Create custom emoji in guild	Write
discordbot_update_guild_emoji	Update emoji name and role restrictions	Write
discordbot_delete_guild_emoji	Delete custom emoji	Write
discordbot_get_guild_emoji	Get specific emoji details	Read
discordbot_list_guild_emojis	List all custom emojis in guild	Read
discordbot_create_guild_sticker	Upload a new sticker (max 512KB)	Write
discordbot_update_guild_sticker	Update sticker name, description, tags	Write
discordbot_delete_guild_sticker	Delete custom sticker	Write
discordbot_get_guild_sticker	Get specific sticker details	Read
discordbot_list_guild_stickers	List all custom stickers	Read
discordbot_get_sticker	Get sticker by ID	Read
discordbot_list_sticker_packs	List available Nitro sticker packs	Read

Webhook Operations

Tool	Description	Mode
discordbot_create_webhook	Create a webhook in a channel	Write
discordbot_execute_webhook	Execute webhook to send messages/embeds	Write
discordbot_execute_slack_compatible_webhook	Send via Slack-compatible webhook	Write
discordbot_execute_github_compatible_webhook	Send via GitHub-compatible webhook	Write
discordbot_update_webhook	Update webhook properties	Write
discordbot_update_webhook_by_token	Update webhook without bot auth	Write
discordbot_delete_webhook	Delete a webhook by ID	Write
discordbot_delete_webhook_by_token	Delete webhook without bot auth	Write
discordbot_get_webhook	Get webhook details by ID	Read
discordbot_get_webhook_by_token	Get webhook without bot auth	Read
discordbot_list_channel_webhooks	List webhooks in a channel	Read
discordbot_get_guild_webhooks	List all webhooks in a guild	Read
discordbot_update_webhook_message	Update a webhook-sent message	Write
discordbot_delete_webhook_message	Delete a webhook-sent message	Write
discordbot_get_webhook_message	Get a webhook-sent message	Read
discordbot_update_original_webhook_message	Update original webhook/interaction message	Write
discordbot_delete_original_webhook_message	Delete original webhook/interaction message	Write
discordbot_get_original_webhook_message

Application Command Operations

Tool	Description	Mode
discordbot_create_application_command	Create global application command	Write
discordbot_update_application_command	Update global application command	Write
discordbot_delete_application_command	Delete global application command	Write
discordbot_get_application_command	Get specific global command	Read
discordbot_list_application_commands	List all global commands	Read
discordbot_create_guild_application_command	Create guild-specific command	Write
discordbot_update_guild_application_command	Update guild-specific command	Write
discordbot_delete_guild_application_command	Delete guild-specific command	Write
discordbot_get_guild_application_command	Get guild-specific command	Read
discordbot_list_guild_application_commands	List guild-specific commands	Read
discordbot_get_guild_application_command_permissions	Get command permissions in guild	Read
discordbot_list_guild_application_command_permissions	List all command permissions in guild	Read
discordbot_create_interaction_response	Respond to an interaction (slash command, component)	Write

Template Operations

Tool	Description	Mode
discordbot_create_guild_template	Create template from existing guild	Write
discordbot_create_guild_from_template	Create guild from a template	Write
discordbot_update_guild_template	Update template name/description	Write
discordbot_sync_guild_template	Sync template with source guild	Write
discordbot_delete_guild_template	Delete a guild template	Write
discordbot_get_guild_template	Get template details by code	Read
discordbot_list_guild_templates	List all guild templates	Read

DM & Group DM Operations

Tool	Description	Mode
discordbot_create_dm	Create or retrieve a DM channel	Write
discordbot_add_group_dm_user	Add user to group DM	Write
discordbot_delete_group_dm_user	Remove user from group DM	Write

Voice & Stage Operations

Tool	Description	Mode
discordbot_create_stage_instance	Create Stage instance for live audio event	Write
discordbot_update_self_voice_state	Update bot's voice state in stage channel	Write
discordbot_update_voice_state	Update another user's voice state in stage	Write
discordbot_delete_stage_instance	Delete active Stage instance	Write
discordbot_get_stage_instance	Get active Stage instance	Read
discordbot_list_voice_regions	List available voice regions	Read
discordbot_list_guild_voice_regions	List voice regions for a guild	Read

Integration & Misc Operations

Tool	Description	Mode
discordbot_list_guild_integrations	List guild integrations	Read
discordbot_delete_guild_integration	Delete a guild integration	Write
discordbot_get_gateway	Get WebSocket URL for Gateway	Read
discordbot_get_bot_gateway	Get Gateway URL with shard info	Read
discordbot_get_application	Get application details by ID	Read
discordbot_get_my_application	Get current authenticated application	Read
discordbot_update_application	Update application settings	Write
discordbot_update_my_application	Update current application via @me	Write
discordbot_get_my_oauth2_application	Get OAuth2 application info	Read
discordbot_get_application_role_connections_metadata	Get role connection metadata	Read
discordbot_get_application_user_role_connection	Get user role connection	Read
discordbot_update_application_user_role_connection	Update user role connection	Write
discordbot_get_user	Get public user info by ID	Read
discordbot_update_my_user	Update bot username and avatar	Write
discordbot_get_public_keys	Get OAuth2 public keys (JWK format)	Read
discordbot_test_auth	Validate bot token (diagnostic)	Read

Code Examples

Example 1: Send and manage messages

// Send a message with embed
await clawlink_call_tool({
  tool: "discordbot_create_message",
  parameters: {
    channel_id: "123456789",
    content: "Deployment complete!",
    embeds: [{ title: "Status", description: "All systems green" }]
  }
});

// Edit the message
await clawlink_call_tool({
  tool: "discordbot_update_message",
  parameters: {
    channel_id: "123456789",
    message_id: "987654321",
    content: "Updated: All systems operational"
  }
});

Example 2: Moderate a guild

// Search for a member
const member = await clawlink_call_tool({
  tool: "discordbot_search_guild_members",
  parameters: { guild_id: "111111", query: "username" }
});

// Assign a role
await clawlink_call_tool({
  tool: "discordbot_add_guild_member_role",
  parameters: { guild_id: "111111", user_id: "222222", role_id: "333333" }
});

Example 3: Create scheduled events

await clawlink_call_tool({
  tool: "discordbot_create_guild_scheduled_event",
  parameters: {
    guild_id: "111111",
    name: "Weekly Team Sync",
    scheduled_start_time: "2026-06-15T10:00:00Z",
    entity_type: 2,
    channel_id: "444444",
    description: "Weekly team synchronization meeting"
  }
});

Example 4: Webhook message delivery

// Create a webhook
const webhook = await clawlink_call_tool({
  tool: "discordbot_create_webhook",
  parameters: { channel_id: "123456789", name: "Deploy Bot" }
});

// Execute the webhook
await clawlink_call_tool({
  tool: "discordbot_execute_webhook",
  parameters: {
    webhook_id: webhook.id,
    webhook_token: webhook.token,
    content: "New release deployed to production!"
  }
});

Discovery Workflow

1. Call clawlink_list_integrations to confirm discord-bot is connected.
2. Call clawlink_list_tools --integration discord-bot to see the live catalog.
3. Use clawlink_search_tools({ query: "message", integration: "discord-bot" }) to find specific tools.

Execution Workflow

READ (safe):     list_messages → get_channel → list_guild_members
WRITE (confirm): create_message → update_channel → create_webhook
DELETE (high):   delete_message → ban_user → bulk_delete_messages

Notes

• Bot must be a member of a guild to operate on it
• Global application commands take up to 1 hour to propagate
• Bulk delete messages must be less than 14 days old
• The bot can only edit its own messages

Error Handling

Status / Error	Meaning
401 Unauthorized	Invalid or expired bot token -- run discordbot_test_auth
403 Forbidden	Missing permissions -- check bot role hierarchy
404 Not Found	Channel/guild/message ID does not exist
429 Rate Limited	Too many requests -- apply exponential backoff
50001 Missing Access	Bot lacks required permission for this action

Troubleshooting

Tools Not Visible

• Start a fresh OpenClaw chat to reload plugin catalog
• Call clawlink_list_integrations to confirm pairing

Invalid Tool Call

• Verify the bot is a member of the target guild
• Check that channel IDs are numeric strings, not names
• Use discordbot_test_auth to validate the bot token

Resources

• Discord API Docs: https://discord.com/developers/docs
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=discord-bot
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw