Discord Channel Auditor

---
name: discord-channel-auditor
description: Audit and auto-update a Discord server guide channel. Compares a reference guide message against actual channels, detects new/renamed/deleted/moved channels, and posts an updated guide. Use for keeping a #how-to or #server-guide channel in sync with reality.
---

# Discord Channel Auditor

Keep a server guide channel automatically synced with actual Discord channels.

## Requirements

- **OpenClaw** with Discord channel configured (no extra credentials needed)
- Uses OpenClaw's built-in `message` tool for all Discord operations (`channel-list`, `read`, `send`, `delete`, `edit`)
- Bot must have "View Channel" permission in the guild to list channels
- Bot must have "Send Messages" + "Manage Messages" in the guide channel to post/delete

## When to Use
- Maintaining a #how-to or #server-guide channel
- After creating, renaming, deleting, or moving channels
- On a daily cron to catch drift

## Workflow

1. **Fetch channel list** using `message(action=channel-list)` for the guild
2. **Read current guide** using `message(action=read)` on the guide channel
3. **Compare** -- check for:
   - New channels not in the guide
   - Channels in the guide that no longer exist
   - Renamed channels (ID exists, name changed)
   - Moved channels (different category)
   - Wrong descriptions
4. **If changes found:** Delete old guide messages and post fresh guide
5. **If no changes:** Do nothing (save tokens)

## Guide Format

Organize by category in Discord display order (by position). Use this structure:

```
**📥 Category Name**
- **#channel-name** -- Brief description of purpose
- **#another-channel** -- What goes here

**💼 Another Category**
- **#work-channel** -- Description
```

### Rules
- Keep descriptions to one line, max ~10 words
- Match category emoji to Discord category name
- List channels in position order within each category
- Include a "General tips" section at the bottom
- Post as 1-2 messages max (Discord 2000 char limit per message)
- Skip voice channels unless specifically relevant

## Cron Setup

```
Schedule: daily at a quiet hour (e.g., 6 AM local)
Session: isolated
Timeout: 120 seconds
Delivery: none (don't notify, just update silently)
```

## Edge Cases
- New category with no channels: include header, note "(empty)"
- Private channels: skip unless the bot has access
- Archived channels: skip