Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Discord project collaboration infrastructure for OpenClaw agents. Manage Forum Channels, threads, participant permissions, and mention mode. Supports 3-tier...
Discord project collaboration infrastructure for OpenClaw agents. Manage Forum Channels, threads, participant permissions, and mention mode. Supports 3-tier...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Automated Discord project collaboration for OpenClaw multi-agent teams. Create Forum Channels and threads, manage who can speak where, and control mention-only mode โ all from the CLI.
OpenClaw with Discord channel configured Discord bot with Manage Channels permission in the target guild Python 3.8+
SKILL_DIR="/path/to/discord-project-manager" # 1. Initialize (first time only) python3 "$SKILL_DIR/scripts/discord-pm.py" config init python3 "$SKILL_DIR/scripts/discord-pm.py" registry init python3 "$SKILL_DIR/scripts/discord-pm.py" forum-channel set-default <forum_channel_id> # 2. Create a project thread python3 "$SKILL_DIR/scripts/discord-pm.py" thread create \ --name "my-feature" \ --owner agent-a \ --participants "agent-a,agent-b" This creates a thread in your default forum, gives agent-a free speech (owner), and sets agent-b to mention-only mode.
discord-pm.py config init # Auto-detect guild ID from OpenClaw config discord-pm.py config get # Show current config discord-pm.py config set-guild <id> # Set guild ID manually discord-pm.py config set-forum <id> # Set default forum channel
discord-pm.py registry init # Auto-collect agent info from OpenClaw config discord-pm.py registry list # List all registered agents
# Create a new Forum Channel (uses Discord REST API directly) discord-pm.py forum-channel create <name> [--emoji <emoji>] [--description <text>] # Manage forum channels discord-pm.py forum-channel set-default <channel_id> discord-pm.py forum-channel add <channel_id> <name> # Register existing channel discord-pm.py forum-channel remove <name> discord-pm.py forum-channel list
# Create thread (uses default forum unless --forum-channel specified) discord-pm.py thread create \ --name <name> \ --owner <agent> \ --participants <agent1,agent2,...> \ [--forum-channel <id>] \ [--no-mention] \ [--message <text>] discord-pm.py thread archive <thread_id> # Remove all permissions discord-pm.py thread status <thread_id> # Show permissions and participants
discord-pm.py permissions add <thread_id> <agent1> [agent2...] [--no-mention] discord-pm.py permissions remove <thread_id> <agent1> [agent2...] discord-pm.py permissions mention-mode <thread_id> <on|off> <agents...|--all>
discord-pm.py project list [--active] [--archived] [--agent <name>] discord-pm.py project info <thread_id> discord-pm.py project describe <thread_id> <text> discord-pm.py project update <thread_id> --next-action <text> Projects are automatically registered when threads are created and updated when participants change or threads are archived. The --agent filter shows only projects where the agent is owner or participant, with role labels. Batch operations: add and remove accept multiple agent names. A single config patch is applied for all agents, so only one gateway reload happens. The --all flag on mention-mode scans the live OpenClaw config to find every account that currently has access to the thread, then sets mention mode for all of them โ including accounts not in the agent registry (e.g. manually configured bots).
TierUse CaseExampleForum ChannelLarge project with sub-teams๐ฆ-product-launchThreadIndividual task or sub-projectapi-refactorDefault ChannelQuick tasks, no isolation needed#dev-ops
Owner: requireMention: false โ speaks freely, drives the conversation Participants: requireMention: true โ only responds when @mentioned Non-participants: no channel access configured This keeps threads focused: the owner leads, others contribute when asked.
Thread/Forum creation โ threads via openclaw message CLI, forums via Discord REST API Permission management โ patches OpenClaw config (channels.discord.accounts.<account>.guilds.<guild>.channels.<channel>) Config reload โ triggers SIGUSR1 graceful restart (2-5s). Falls back to openclaw gateway restart if needed.
data/ โโโ config.json # Skill config (guild ID, default forum) โโโ agents.json # Agent registry (account IDs, user IDs, channels) โโโ projects.json # Project registry (threads, owners, participants, nextAction) Both auto-generated by config init and registry init. Excluded from git (user-specific data).
This skill requires access to your OpenClaw configuration: Reads ~/.openclaw/openclaw.json to obtain the Discord bot token and agent account mappings Writes channel permission entries to the same config file (with file locking and atomic writes) Triggers SIGUSR1 for graceful config reload (falls back to openclaw gateway restart) The bot token is used exclusively for Discord REST API calls (forum channel creation). It is never logged, stored elsewhere, or transmitted to third parties. Recommendations: Back up ~/.openclaw/openclaw.json before first use Ensure your Discord bot has only Manage Channels permission Review the source code if you have concerns about config access
ProblemCheckThread creation failsIs the default forum set? (forum-channel set-default)Mention mode not workingDoes the agent have mentionPatterns in OpenClaw config?Forum creation 403Does the bot have Manage Channels permission in the guild?Permission changes delayedConfig reload takes 2-5s. If still not working, run openclaw gateway restart
discord-project-manager/ โโโ SKILL.md โโโ scripts/ โ โโโ discord-pm.py # Unified CLI โ โโโ cli.sh # Bash wrapper โโโ lib/ โ โโโ discord_api.py # Discord API (CLI + REST) โ โโโ config.py # OpenClaw config operations โ โโโ skill_config.py # Skill-local config โ โโโ registry.py # Agent registry โ โโโ thread.py # Thread lifecycle โ โโโ permissions.py # Permission management โ โโโ forum.py # Forum channel management โ โโโ projects.py # Project registry โ โโโ validators.py # Input validation โโโ data/ # Auto-generated, git-ignored Version: 2.2.1 Last Updated: 2026-02-27
Messaging, meetings, inboxes, CRM, and teammate communication surfaces.
Largest current source with strong distribution and engagement signals.