disclaw
Manage Discord workspace structure and OpenClaw routing as code. Use when creating/renaming/deleting Discord channels, categories, threads, or managing agent-to-channel bindings. Triggers on: Discord channels, workspace structure, channel setup, routing, binding, disclaw.
Why use this skill?
Automate your Discord server organization with Disclaw. Manage categories, channels, threads, and agent routing using simple YAML configurations.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ofan/disclawWhat This Skill Does
Disclaw is a specialized infrastructure-as-code tool for managing your Discord workspace structure directly from your OpenClaw environment. Unlike standard messaging bots that handle conversations, Disclaw focuses on the architecture of your server. It enables users to declaratively define and manage categories, channels, and threads via a YAML configuration file. By maintaining a single source of truth, you can ensure that your server's layout remains consistent, automated, and version-controlled. It also handles the complex task of mapping specific OpenClaw agents to specific Discord channels, including fine-grained control over mention requirements and routing logic.
Installation
To get started, first install the skill package globally using npm: npm install -g @ofan/disclaw. Ensure your OpenClaw instance is configured with a valid Discord bot token located at channels.discord.token. To enable automated synchronization, provide Gateway API access by adding { "gateway": { "tools": { "allow": ["gateway"] } } } to your openclaw.json. Once installed, create a disclaw.yaml configuration file in your workspace directory defining your desired guild structure, then verify your configuration using disclaw validate -c disclaw.yaml and disclaw diff -c disclaw.yaml.
Use Cases
Disclaw is ideal for teams needing to enforce standardized server structures across multiple environments (e.g., staging vs. production). It is perfect for developers who want to manage Discord routing alongside their code. It excels in scenarios where you need to quickly spin up a new department or project channel, ensuring that specific bots are bound to the right threads without manual configuration via the Discord UI. It is also a powerful tool for cleaning up "channel sprawl" by using the prune functionality to remove unauthorized or stale channels.
Example Prompts
- "OpenClaw, please run the disclaw diff command on my current workspace to see if there are any drift issues between my yaml config and the Discord server.
- "I need to update our routing; please modify the disclaw.yaml file to move the siren agent from the general channel to the new alerts channel and set requireMention to true for the support agent.
- "Everything looks correct in the diff, please apply the changes to the workspace using the prune flag to clean up any legacy categories.
Tips & Limitations
Always run disclaw diff before applying changes to prevent accidental deletion of manual channels. Remember that Discord enforces lowercase names for channels; adhere to this convention in your YAML to avoid sync errors. Disclaw manages structural metadata; it will not touch your message history, reactions, or user permissions, making it a safe choice for restructuring active servers. When using the --prune flag, exercise extreme caution as it will permanently remove any channel not defined in your config file.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-ofan-disclaw": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api