功能描述

Discord project collaboration infrastructure for OpenClaw agents. Manage Forum Channels, threads, participant permissions, and mention mode. Supports 3-tier...

使用说明 (SKILL.md)

Discord Project Manager

Name: Discord Project Manager
Author: lemodigital

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

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 \x3Cforum_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.

Commands

Configuration

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 \x3Cid>      # Set guild ID manually
discord-pm.py config set-forum \x3Cid>      # Set default forum channel

Agent Registry

discord-pm.py registry init             # Auto-collect agent info from OpenClaw config
discord-pm.py registry list             # List all registered agents

Forum Channels

# Create a new Forum Channel (uses Discord REST API directly)
discord-pm.py forum-channel create \x3Cname> [--emoji \x3Cemoji>] [--description \x3Ctext>]

# Manage forum channels
discord-pm.py forum-channel set-default \x3Cchannel_id>
discord-pm.py forum-channel add \x3Cchannel_id> \x3Cname>    # Register existing channel
discord-pm.py forum-channel remove \x3Cname>
discord-pm.py forum-channel list

Threads

# Create thread (uses default forum unless --forum-channel specified)
discord-pm.py thread create \
  --name \x3Cname> \
  --owner \x3Cagent> \
  --participants \x3Cagent1,agent2,...> \
  [--forum-channel \x3Cid>] \
  [--no-mention] \
  [--message \x3Ctext>]

discord-pm.py thread archive \x3Cthread_id>    # Remove all permissions
discord-pm.py thread status \x3Cthread_id>     # Show permissions and participants

Permissions

discord-pm.py permissions add \x3Cthread_id> \x3Cagent1> [agent2...] [--no-mention]
discord-pm.py permissions remove \x3Cthread_id> \x3Cagent1> [agent2...]
discord-pm.py permissions mention-mode \x3Cthread_id> \x3Con|off> \x3Cagents...|--all>

Project Registry

discord-pm.py project list [--active] [--archived] [--agent \x3Cname>]
discord-pm.py project info \x3Cthread_id>
discord-pm.py project describe \x3Cthread_id> \x3Ctext>
discord-pm.py project update \x3Cthread_id> --next-action \x3Ctext>

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

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

Data Files

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

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

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

安全使用建议

This skill appears to do exactly what it says, but it operates with powerful local privileges: it reads and writes your OpenClaw configuration (including the Discord bot token and any other data in that JSON) and triggers a gateway reload. Before installing or running it: 1) verify the skill source/owner and prefer installing from a trusted repo; 2) back up ~/.openclaw/openclaw.json (the code already writes backups, but keep your own); 3) review the included scripts (scripts/discord-pm.py and libs) to ensure behavior matches your policy; 4) run it first in a non-production environment or with a test guild/bot to confirm effects; 5) ensure file permissions on your OpenClaw config are restricted so only trusted code can read it; and 6) if you don't want the skill to change settings for every account, avoid using '--all' operations or review the registry before running bulk actions.

功能分析

Type: OpenClaw Skill Name: discord-project-manager Version: 2.1.6 The OpenClaw AgentSkills skill bundle 'discord-project-manager' is classified as benign. It performs high-privilege actions such as reading/writing `~/.openclaw/openclaw.json` and restarting the OpenClaw gateway, which are clearly declared in `SKILL.md` and are essential for its stated purpose of managing Discord project collaboration and agent permissions. The code uses `subprocess.run` with lists of arguments to prevent shell injection, implements file locking and atomic writes for config modifications, and includes input validation (`lib/validators.py`) for critical IDs. There is no evidence of data exfiltration to unauthorized endpoints, persistence mechanisms, obfuscation, or prompt injection attempts in the documentation or code.

能力评估

✓ Purpose & Capability

Name/description match the code and runtime instructions. The skill reads ~/.openclaw/openclaw.json to obtain Discord tokens and agent mappings, calls the Discord REST API to create forum channels, and patches the OpenClaw config to set channel permissions — all expected for a Discord project manager.

ℹ Instruction Scope

Runtime instructions and code legitimately read and write the OpenClaw config and call the Discord API. The SKILL.md and code also expose a '--all' mention-mode behavior that scans the live OpenClaw config and will apply permissions to any accounts found there (including manually configured bots). This is functionally consistent but means the skill will examine and act on all Discord account entries present in the config, not only entries in its own registry.

✓ Install Mechanism

No install spec (instruction-only installer) — the package is delivered as code files and CLI scripts. No remote downloads or installers were declared. This is the lowest-risk install mechanism for a skill package.

ℹ Credentials

The skill requests read/write access to ~/.openclaw/openclaw.json and expects to obtain the Discord bot token from that config. That is proportional to the stated functionality, but it does mean the skill will read any other secrets stored in that JSON. There are no unrelated external credentials requested.

✓ Persistence & Privilege

always is false and the skill does not request permanent platform-level privileges. It does perform config patches and sends SIGUSR1 (or falls back to 'openclaw gateway restart') to apply changes — this is required to make permission updates live but is a system-level action the user should accept deliberately.

版本历史

v2.1.6

- Version bumped in documentation footer from 2.1.6 to 2.2.1. - No functional or code changes detected in this release. - SKILL.md content remains unchanged except for the version number.

v2.1.5

- Added structured metadata section specifying OpenClaw config, Discord bot credentials, and side effects. - Introduced a new Project Registry with `projects.json` data file and a set of `project` commands (list, info, describe, update). - Updated documentation to clarify security, permissions, and config file access for transparency. - Expanded the source structure to include the new `projects.py` module. - Bumped documentation version and last updated date; no core functionality changes outside doc/metadata.

v2.1.4

- Streamlined CLI commands to support batch operations for adding/removing multiple agents at once; now applies a single config patch per update. - Added support for `--all` flag in `mention-mode` command to update mention status for every account with thread access, including non-registered agents. - Refined documentation for clarity and updated usage examples, including more explicit troubleshooting guidance. - Introduced `lib/projects.py` and removed deprecated standalone scripts for thread creation and registry tasks. - Improved source layout by adding input validation module and removing legacy scripts.

v2.1.3

- Version number updated to 2.1.3. - No file or documentation changes detected in this release.

v2.1.2

Python rewrite with direct Discord API integration. Forum Channel creation, thread lifecycle, permission management, mention mode control. Security fixes: urllib instead of curl, file locking, input validation.

元数据

Slug discord-project-manager

版本 2.1.6

许可证 —

累计安装 1

当前安装数 1

历史版本数 5

常见问题