discord-hub-builder

What This Skill Does

The Discord Hub Builder is an automated infrastructure-as-code tool for Discord, designed specifically for AI agent orchestration. Instead of manually clicking through the Discord UI to set up categories, channels, and roles, this skill utilizes the Discord REST API to provision a standardized command center. It builds a hierarchical structure containing dedicated workspaces for agent management, task queues, and research logging. Furthermore, it automates the creation of 'workflow cards'—pinned messages that serve as operational templates for your agents, clearly defining triggers, inputs, outputs, and execution frequencies.

Installation

To add this skill to your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/calecorbett/discord-hub-builder. Ensure you have your Discord bot token ready and the bot invited to your target server with the 'Manage Channels,' 'Manage Roles,' and 'Send Messages' permissions enabled. Before executing the main builder, verify your guild ID and conduct a dry run using python3 scripts/build_hub.py --token <TOKEN> --guild <GUILD_ID> --dry-run to inspect the generated structure without modifying your server.

Use Cases

• Rapid AI Prototyping: Instantly spin up a professional environment for testing multiple AI agents simultaneously.
• Agent Governance: Maintain a consistent structure for agent logs, research archives, and operational notes across different project environments.
• Team Onboarding: Quickly deploy a ready-to-use communication hub for cross-functional teams that need to interact with AI agent outputs in real-time.

Example Prompts

1. "Hey OpenClaw, please run the discord-hub-builder to set up my AI management server using the bot token and guild ID provided in my configuration."
2. "I need to prepare a new workspace for my research agents. Can you execute a dry run of the discord-hub-builder for guild ID 123456789 to show me how the categories will look?"
3. "The setup for the agent command center looks good. Proceed with the live installation of the Discord hub so I can start routing agent tasks."

Tips & Limitations

• Permissions: Discord's permission API is sensitive; while this skill creates the architecture, you must manually define granular role-based access for your #task-queue to prevent unauthorized users from interacting with agent triggers.
• Idempotency: While role creation is idempotent (skips if they already exist), channel creation is not. Always perform a dry run to avoid creating duplicate channel structures.
• Rate Limiting: If building a massive server, the script may encounter 429 errors. Simply wait a few moments before retrying or implement a short delay between API calls.