Discord Project Manager

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.

Prerequisites

• - OpenClaw with Discord channel configured
• Discord bot with Manage Channels permission in the target guild
• Python 3.8+

Quick Start

CODEBLOCK0

This creates a thread in your default forum, gives agent-a free speech (owner), and sets agent-b to mention-only mode.

Commands

Configuration

CODEBLOCK1

Agent Registry

CODEBLOCK2

Forum Channels

CODEBLOCK3

Threads

CODEBLOCK4

Permissions

CODEBLOCK5

Project Registry

CODEBLOCK6

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).

Architecture

3-Tier Project Structure

Tier	Use Case	Example
Forum Channel	Large project with sub-teams	📦-product-launch
Thread

Individual task or sub-project | api-refactor | | Default Channel | Quick tasks, no isolation needed | #dev-ops |

Permission Model

• - 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.

How It Works

1. 1. Thread/Forum creation — threads via openclaw message CLI, forums via Discord REST API
2. Permission management — patches OpenClaw config (channels.discord.accounts.<account>.guilds.<guild>.channels.<channel>)
3. Config reload — triggers SIGUSR1 graceful restart (2-5s). Falls back to openclaw gateway restart if needed.

Data Files

CODEBLOCK7

Both auto-generated by config init and registry init. Excluded from git (user-specific data).

Security & Permissions

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

Troubleshooting

Problem	Check
Thread creation fails	Is the default forum set? (forum-channel set-default)
Mention mode not working

Does the agent have mentionPatterns in OpenClaw config? | | Forum creation 403 | Does the bot have Manage Channels permission in the guild? | | Permission changes delayed | Config reload takes 2-5s. If still not working, run openclaw gateway restart |

Source Structure

CODEBLOCK8

---

Version: 2.2.1
Last Updated: 2026-02-27