discord

Gives OpenClaw's assistant a seat in your Discord server: it can post, reply in threads, react, pin and moderate itself, rather than you relaying every message. It can also send buttons for people to click. Which actions it has depends on what your Discord setup in OpenClaw allows.

WHEN TO USE

SCOPE

USE FOR

Post a message to a Discord channel, or reply inside an existing thread.
React to, pin, edit or delete a specific message.
Send a message with Approve and Decline buttons for someone to click.
Carry out a moderation action on a member, after confirming who and what.
Choose which bot account to post from when more than one is set up.

NOT FOR

Combining the newer Components v2 UI with legacy embeds in one message — Discord rejects that.

This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.

In this document (3)

Use the message tool with channel: "discord". The tool schema lists the actions enabled by the current account's channels.discord.actions.* gates; do not assume unavailable actions.

Workflow

Prefer stable guildId, channelId, messageId, and userId values from context. Pass accountId when more than one Discord account could apply.
Resolve the exact message before editing, deleting, pinning, moderating, or reacting when the user's reference is ambiguous.
Keep thread replies in their existing thread. A forum parent cannot receive components; send components to the created forum thread instead.
Confirm destructive or moderation actions unless the user already specified the exact target and action.

Interactive components

components must be a structured object or native component array, never a placeholder string. Do not combine components v2 with legacy embeds.

{
  "action": "send",
  "channel": "discord",
  "to": "channel:123",
  "message": "Choose an option",
  "components": {
    "blocks": [
      {
        "type": "actions",
        "buttons": [
          { "label": "Approve", "style": "success", "callbackData": "approve" },
          { "label": "Decline", "style": "danger", "callbackData": "decline" }
        ]
      }
    ]
  }
}

Discord mention syntax, component availability, and form hints are injected automatically. Follow the current hints and tool schema rather than a duplicated action catalog.

Comes in the @openclaw/discord plugin. Install it in OpenClaw with openclaw plugins install @openclaw/discord, which also turns it on; the skill loads once your Discord bot is set up (channels.discord). The npx skills add command copies this skill's text from OpenClaw's repository into another agent, but it calls OpenClaw's message tool, so it needs OpenClaw to work.

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.

Install checklist

Check selected tools if a picker appears; Claude Code may be unchecked under Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.
Without a tool picker, check Installing to: for your intended tool. Stop if it names a different tool.
If asked, choose Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.
Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.

Skills CLI 1.7.2 sends install data to skills.sh by default, including the source, skill names, target tools and file details; GitHub sources are reported only when GitHub confirms the repository is public, while other remote sources can also be reported. Confirmed-public GitHub sources also trigger a security-audit request. Before installing, set the environment variable DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable both.

npx skills add openclaw/openclaw --skill "discord" --full-depth

After installing for Claude Code, open it in the installation project if you chose Project; Global makes the skill available across projects on this computer. Once Claude Code loads the skill, its description helps Claude decide when to use it.

If installation created a top-level skills folder that did not exist when your Claude Code session started, run /reload-skills in that session. Run it again after later changes in that folder.

What's inside

Files included with this skill.

View on GitHub

discord

Discord

Workflow

Interactive components

No requirements beyond installing this skill were found.

What's inside

More skills

MCP keyword matches