A technical utility that enables AI agents to bypass session-based visibility limits by fetching Discord channel and thread history directly via the Discord Bot API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install discord-thread-reader
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-thread-reader 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 Context?
Discord Context is a specialized extension designed for Openclaw Skills that addresses a fundamental limitation in AI-Discord interactions: session-based visibility. Standard agents can typically only see messages from conversations where they have an active session. This skill bridges the gap by providing a secure method to query the Discord API directly, allowing agents to ingest historical context from threads or channels they weren't previously a part of.
By leveraging localized token storage, this skill enables agents to pull up to 100 messages at a time, including metadata and referenced messages. This is essential for developers and teams using Openclaw Skills who need their agents to have a comprehensive understanding of long-standing discussions or specific channel histories that fall outside the immediate conversation buffer.
Discord Context Use Cases
- Accessing Discord threads where the agent was not explicitly mentioned or invited.
- Retrieving historical context from a specific channel to answer questions about past decisions.
- Paginating through long conversation histories using specific message IDs as anchors.
- Listing active threads within a parent channel to discover relevant sub-discussions.
How Discord Context Works
- The agent identifies a request for external Discord context based on triggers like "read that thread."
- The skill retrieves the Discord Bot Token from a secure, non-indexed file path (~/.openclaw/.discord-bot-token).
- It uses a curl command to call the Discord API v10 /messages endpoint with the target Channel or Thread ID.
- The raw JSON response is piped through a formatter for structured reading.
- The agent parses the message content, author details, and timestamps to reconstruct the conversation for the user.
Discord Context Setup
To integrate this into your suite of Openclaw Skills, you must first store your bot token securely outside the workspace to prevent accidental commits:
# Store your bot token in a file outside the workspace
echo 'YOUR_DISCORD_BOT_TOKEN' > ~/.openclaw/.discord-bot-token
chmod 600 ~/.openclaw/.discord-bot-token
After saving the token, ensure the bot has the View Channel and Read Message History permissions in the Discord Developer Portal. Finally, record the token path in your TOOLS.md so the agent knows where to look.
Discord Context Data Schema & Taxonomy
The skill interacts with the Discord API v10 schema. The following fields are primarily utilized during context retrieval:
| Field | Description |
|---|---|
| content | The actual text content of the message |
| author.username | The Discord handle of the sender |
| timestamp | The ISO8601 timestamp of the message |
| id | The unique Snowflake ID (used for pagination) |
| referenced_message | Details of the message being replied to, if applicable |
Discord Context Advanced Features
- Pagination Support: Use the
beforeorafterparameters to navigate through thousands of historical messages. - Thread Discovery: Ability to list all active threads in a guild channel to map out complex server structures.
- Secure Token Management: Uses file-system level permissions (chmod 600) to keep bot credentials isolated from the agent's primary configuration files.
- Developer Mode Integration: Designed to work seamlessly with Discord Snowflake IDs for precise targeting of messages.
SKILL.md
Loading
Related Openclaw Skills
Skill Composer
A powerful workflow orchestrator that chains multiple Openclaw Skills into single-command automated processes using YAML configurations.
Baidu Web Search
A professional-grade web search skill for Openclaw Skills that provides AI agents with real-time internet access via the Baidu Qianfan API.
Agent Browser
A specialized browser automation CLI that allows AI agents to interact with web pages through a unique element-referencing system.
WordPress OAuth
A specialized tool for managing WordPress.com OAuth authentication and automated post publishing.
SageMaker
A sophisticated memory and growth operating system designed to give AI agents consistent layered memory and self-driven evolution patterns.
Pre-Publish Security Protocol
A comprehensive multi-layered security audit system designed to prevent credential leaks and detect vulnerabilities before they reach your public repositories.
Featured*
