An integration enabling OpenClaw agents to manage Discord guilds, channels, user profiles, roles, and monetization structures via ClawLink.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install discord-communities
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install discord-communities using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is discord-communities?
The discord-communities integration acts as a powerful bridge connecting your AI coding environment directly to your Discord servers. Powered by ClawLink, this capability handles credential management and secure OAuth connection flows so that developers do not have to configure complex Discord API access rules manually. By integrating this into your workflow, you can expand your catalog of Openclaw Skills with robust capabilities to read and write Discord server states, manage memberships, and sync user metadata.
Using this setup, your AI agent can coordinate real-time actions across channels, adjust roles, and verify subscription status. It represents a vital tool for developers building community automations, moderation workflows, and customized bot ecosystems within the realm of Openclaw Skills.
discord-communities Use Cases
- Automated Community Moderation: Manage server members, assign or strip roles, and process member lists to maintain server health.
- Subscription & Entitlement Tracking: Verify premium SKU subscriptions and entitlement claims for application monetization.
- Server Status and Invites: Retrieve, resolve, and embed Discord server widgets or invite link data dynamically.
- Application Commands Configuration: Administer guild-specific application permissions and edit command access scopes.
- User Role Synchronization: Seamlessly sync third-party platform profiles with Discord role connections using metadata.
How discord-communities Works
- Plugin Installation: Install the ClawLink plugin within OpenClaw to enable communication with the API bridge.
- Device Pairing: Execute the pairing tool to generate a secure activation URL, allowing you to link your local agent to ClawLink.
- OAuth Authentication: Authorize your Discord account via the web-based ClawLink OAuth dashboard.
- Tool Execution: OpenClaw passes commands to the local ClawLink plugin, which securely routes the request through ClawLink Cloud to the Discord API.
- Response Return: A structured JSON payload containing user, guild, or channel details is returned directly to the agent session.
discord-communities Setup
Install the ClawLink plugin to begin adding Discord capabilities to your Openclaw Skills.
Step 1: Install the Plugin
Run the following command in your terminal:
openclaw plugins install clawhub:clawlink-plugin
Note: Start a fresh chat session after installation to reload the plugin catalog.
Step 2: Pair with ClawLink
Call the pairing tool within your chat to link your device:
clawlink_begin_pairing()
Open the returned URL in your web browser, sign in, and approve the connection.
Step 3: Connect Your Discord Account
Go to the ClawLink dashboard to complete OAuth verification:
# Open in your browser:
https://claw-link.dev/dashboard?add=discord
Step 4: Verify Your Setup
Confirm the integration is active and explore available tools:
// Check active connections
clawlink_list_integrations()
// List available tools for Discord
clawlink_list_tools({ integration: 'discord' })
discord-communities Data Schema & Taxonomy
The integration utilizes distinct data models to interact with Discord's API. Here is a breakdown of the tool categories, their security classifications, and standard payload schemas:
Tool & Security Taxonomies
| Data Category | Key Tools | Default Risk Level | Description |
|---|---|---|---|
| User Profiles | discord_get_my_user, discord_get_user |
safe | Retrieves user claims, IDs, avatars, and linked third-party connections. |
| Guild Structure | discord_list_my_guilds, discord_get_guild_widget |
safe | Fetches partial server data, template configurations, and widget assets. |
| Guild Operations | discord_leave_guild |
high_impact | Actions affecting user guild status. |
| App Commands | discord_edit_application_command_permissions |
confirm | Edits tool permissions for commands within guilds. |
| E-Commerce | discord_get_current_user_application_entitlements |
safe / confirm | Retrieves subscription statuses, premium SKU access, and consumes entitlements. |
| Role Connections | discord_update_user_application_role_connection |
confirm | Modifies connection metadata for role-based authorization rules. |
Error Response Reference Table
| Error / HTTP Code | Probable Root Cause | Recommended Action |
|---|---|---|
401 Unauthorized |
Bearer token required, but bot token was used | Authenticate via OAuth2 Bearer token path |
Missing MANAGE_GUILD |
Missing admin/management permissions | Grant MANAGE_GUILD and MANAGE_ROLES privileges to the authorizing account |
Guild widget disabled |
The widget is turned off in server preferences | Toggle server widget on inside Discord server settings |
discord-communities Advanced Features
- Granular Security Boundaries: Classifies tools as safe, confirm, or high_impact to prevent accidental actions (e.g., leaving a guild or deleting role connections) without explicit confirmation.
- Monetization & Entitlements Management: Programmatically tracks, validates, and consumes app-store subscription models inside Discord servers.
- Dynamic Role Metadata Syncing: Updates application role connection metadata dynamically, facilitating conditional role gating based on external APIs.
- Multi-Level Authentication Paths: Safely segregates bot-token actions from user-scoped OAuth Bearer flows, reducing administrative overhead.
- Local Credential Storage: Keeps device credentials strictly stored on the local filesystem within OpenClaw configuration files, while routing token handling securely through ClawLink Cloud.
SKILL.md
Loading
Related Openclaw Skills
Dynamics 365 CRM
Interact with and manage your Microsoft Dynamics 365 CRM records directly from your AI agent using the ClawLink integration.
Freshservice IT
An Openclaw Skills integration designed to manage Freshservice IT service operations, including tickets, requesters, agents, assets, and service catalogs directly from your AI agent.
GitHub Triage
An automated GitHub repository management skill that analyzes, groups, and triages issues and pull requests securely through ClawLink integration.
GIPHY Media Integration
The GIPHY Media skill enables your AI coding agent to dynamically search, translate, and upload GIFs, stickers, and emojis via ClawLink integration.
ClickHouse Analytics
A secure, read-only analytical tool integration that lets OpenClaw agents explore ClickHouse database schemas and run SQL queries.
Content Repurpose to LinkedIn
Turn articles, notes, and raw text into polished, high-converting LinkedIn posts and publish them securely after user approval.
Featured*
