skills$openclaw/discord-watcher
louis-br6.1k

by louis-br

discord-watcher – OpenClaw Skill

discord-watcher is an OpenClaw Skills integration for coding workflows. Use this skill to keep up to date with specific Discord channels by fetching recent messages. Requires DISCORD_TOKEN.

6.1k stars862 forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026coding

Skill Snapshot

namediscord-watcher
descriptionUse this skill to keep up to date with specific Discord channels by fetching recent messages. Requires DISCORD_TOKEN. OpenClaw Skills integration.
ownerlouis-br
repositorylouis-br/discord-watcher
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @louis-br/discord-watcher
last updatedFeb 7, 2026

Maintainer

louis-br

louis-br

Maintains discord-watcher in the OpenClaw Skills directory.

View GitHub profile
File Explorer
5 files
.
_meta.json
284 B
.gitignore
235 B
README.md
298 B
SKILL.md
3.2 KB
update.sh
2.0 KB
SKILL.md

name: discord-watcher description: Use this skill to keep up to date with specific Discord channels by fetching recent messages. Requires DISCORD_TOKEN.

Discord Watcher

This skill uses DiscordChatExporter to fetch recent messages from ALL accessible Discord channels.

Prerequisites

  • DISCORD_TOKEN: Must be set in the environment or passed to the script.
  • DiscordChatExporter (CLI): Must be installed in a dce subdirectory.

Installation

  1. Download the CLI version of DiscordChatExporter from GitHub: https://github.com/Tyrrrz/DiscordChatExporter/releases (Look for DiscordChatExporter.Cli.linux-x64.zip or your OS equivalent)

  2. Extract it to a dce folder inside this skill's directory:

    mkdir -p skills/discord-watcher/dce
    unzip DiscordChatExporter.Cli.linux-x64.zip -d skills/discord-watcher/dce
    chmod +x skills/discord-watcher/dce/DiscordChatExporter.Cli
    

Usage

Run the update script to fetch messages from the last 24 hours across all channels:

./skills/discord-watcher/update.sh [TOKEN]

The script can be run from any directory (it auto-detects its location).

This will:

  1. Create a timestamped directory in exports/updates/.
  2. Export all new messages (last 24h) from every channel you can see.
  3. Save them as plain text files organized by server and category.

Token retrieval (browser method)

If you need help obtaining DISCORD_TOKEN from a logged-in browser session, the following in-page technique (run from a page context where script evaluation is allowed) reliably extracts the token from localStorage using an injected iframe. Treat the token as a secret once retrieved.

JavaScript snippet (run in the page context via an automation tool that can evaluate page scripts):

// Inject a hidden iframe and read its localStorage 'token' key
(() => {
  try {
    const iframe = document.createElement('iframe');
    iframe.style.display = 'none';
    document.documentElement.appendChild(iframe);
    const token = iframe.contentWindow.localStorage.getItem('token');
    iframe.remove();
    return {ok: !!token, method: 'iframe', token};
  } catch (e) {
    return {ok: false, error: e.toString()};
  }
})();

Notes and alternatives:

  • Some automation contexts cannot access page localStorage directly; the iframe technique often bypasses that limitation.
  • An alternative is the "webpack chunk" method to locate Discord's internal token getter; use with care.
  • Never commit tokens to source control. Store them in a .env file or environment variable instead.

To keep updated automatically, you can add a HEARTBEAT.md entry:

- [ ] Every 6 hours: Run `skills/discord-watcher/update.sh` and summarize any new important discussions in `memory/discord-news.md`.

The exported text files are perfect for indexing with qmd.

  1. Create a collection:

    qmd collection add exports/updates --name discord-logs --mask "**/*.txt"
    

    Note: Ensure you use the --mask "**/*.txt" flag as the exporter saves plain text files.

  2. Update index:

    qmd update
    
  3. Search:

    qmd search "query"
    
README.md

Hello humans, this is just a skill my openclaw made. Nothing special, it simply exports chats using DiscordChatExporter and then you could use something like qmd to search them for now.

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

Requirements

- **DISCORD_TOKEN**: Must be set in the environment or passed to the script. - **DiscordChatExporter (CLI)**: Must be installed in a `dce` subdirectory.

FAQ

How do I install discord-watcher?

Run openclaw add @louis-br/discord-watcher in your terminal. This installs discord-watcher into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/louis-br/discord-watcher. Review commits and README documentation before installing.