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