Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Productivity
Disclaw
Manage Discord workspace structure and OpenClaw routing as code. Use when creating/renaming/deleting Discord channels, categories, threads, or managing agent...
skill openclawclawhub Free
Manage Discord workspace structure and OpenClaw routing as code. Use when creating/renaming/deleting Discord channels, categories, threads, or managing agent...
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, _meta.json
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.1.2
Provenance
- Publisher
- ofan
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Disclaw โ Discord Structure as Code
Disclaw manages Discord workspace structure (categories, channels, threads) and OpenClaw agent-to-channel bindings as code via a YAML config file. Disclaw vs Discord plugin: Disclaw manages structure (create/rename/delete channels, categories, threads; manage bindings and routing gates). The Discord plugin manages messaging (send/receive, reactions, pins, thread replies). They do not conflict.
Installation
npm install -g @ofan/disclaw disclaw --version
Prerequisites
Discord bot token must be in OpenClaw config at channels.discord.token Gateway API access โ add to openclaw.json: { gateway: { tools: { allow: ["gateway"] } } } This lets disclaw read/write config via the gateway API. Without it, disclaw falls back to CLI. Config file โ create disclaw.yaml in the workspace (see format below)
Verify Setup
disclaw validate -c disclaw.yaml disclaw diff -c disclaw.yaml
Config File Format
The config file (disclaw.yaml) declares the desired state of Discord workspace structure. version: 1 managedBy: disclaw guild: "YOUR_GUILD_ID" channels: # Standalone channel (no category) - name: announcements topic: "Important announcements" # Category with channels - category: Engineering channels: - name: general threads: [Standup, Retro] - name: alerts topic: "Automated alerts only" # Another category - category: Support channels: - name: tickets - name: escalations # OpenClaw agent bindings (optional) openclaw: requireMention: false agents: main: general # single channel siren: [general, alerts] # multiple channels support: # with options channel: tickets requireMention: true
Key rules
guild is the Discord server ID (right-click server โ Copy Server ID) Channel names must be lowercase, no spaces (Discord enforces this) Thread names can have spaces and mixed case Agent bindings reference channel names from the channels section requireMention controls whether the bot needs @mention to respond in that channel
disclaw diff โ Show what would change
disclaw diff -c disclaw.yaml disclaw diff -c disclaw.yaml --json # structured output disclaw diff -c disclaw.yaml --channel alerts # filter by channel Shows: managed resources (create/update/delete/noop), unmanaged resources, unbound agents, stale agents, routing health warnings, and pinned messages.
disclaw apply โ Apply changes (dry-run by default)
disclaw apply -c disclaw.yaml # dry-run (shows what would change) disclaw apply -c disclaw.yaml --yes # actually apply changes disclaw apply -c disclaw.yaml --prune --yes # also delete unmanaged resources Safety: Always takes a snapshot before mutating. Creates before deletes. Bindings and routing gates are updated atomically.
disclaw import โ Import unmanaged Discord resources
disclaw import -c disclaw.yaml # dry-run (shows what would be imported) disclaw import -c disclaw.yaml --yes # write to config file Discovers Discord channels/categories/threads not in the config and adds them. Also finds unbound OpenClaw agents.
disclaw rollback โ Restore from snapshot
disclaw rollback -c disclaw.yaml # dry-run disclaw rollback -c disclaw.yaml --yes # actually rollback Restores Discord state from the most recent pre-apply snapshot. Drift-aware (shows what changed since the snapshot).
disclaw validate โ Validate config (no API calls)
disclaw validate -c disclaw.yaml disclaw validate -c disclaw.yaml --json Safe for CI. Checks: schema validity, empty names, duplicate channels/threads, binding refs pointing to non-existent channels.
Filter flags (diff, apply, import)
--category <names...> # filter by category name --channel <names...> # filter by channel name --thread <names...> # filter by thread name --agent <names...> # filter by agent name --json # structured JSON output
Gateway options (all commands except validate)
--gateway-url <url> # override gateway URL (default: http://127.0.0.1:18789) --gateway-token <token> # override gateway auth token Also via env vars: OPENCLAW_GATEWAY_URL, OPENCLAW_GATEWAY_TOKEN.
Add a new channel
Edit disclaw.yaml โ add channel under the appropriate category Validate: disclaw validate -c disclaw.yaml Preview: disclaw diff -c disclaw.yaml Apply: disclaw apply -c disclaw.yaml --yes
Bind an agent to a channel
Edit disclaw.yaml โ add entry under openclaw.agents Preview: disclaw diff -c disclaw.yaml Apply: disclaw apply -c disclaw.yaml --yes This creates the binding AND allowlists the channel in routing gates automatically.
Import existing Discord channels
Run: disclaw import -c disclaw.yaml (dry-run to preview) Review the output Run: disclaw import -c disclaw.yaml --yes (writes to config) Verify: disclaw diff -c disclaw.yaml
Delete a channel
Remove the channel from disclaw.yaml Preview: disclaw apply -c disclaw.yaml --prune Apply: disclaw apply -c disclaw.yaml --prune --yes Warning: --prune is required for deletions. Without it, removed channels are shown as "unmanaged" but not deleted.
Rename a channel
Change the channel name in disclaw.yaml Preview: disclaw diff -c disclaw.yaml (shows delete old + create new) Apply: disclaw apply -c disclaw.yaml --yes Note: Discord doesn't support true renames via API โ disclaw creates the new channel and (with --prune) deletes the old one.
Troubleshooting
"Discord bot token not found" Ensure channels.discord.token is set in openclaw.json Or set DISCORD_BOT_TOKEN env var "Gateway tool not available" Add gateway.tools.allow: ["gateway"] to openclaw.json Or disclaw will fall back to CLI automatically "Gateway auth failed" Check OPENCLAW_GATEWAY_TOKEN env var matches gateway.auth.token in config Or pass --gateway-token <token> "OpenClaw CLI timed out" Check if the gateway is running: openclaw status Check network: curl http://127.0.0.1:18789/ "Discord connection timed out" Check internet connectivity Verify bot token is valid Try again (Discord API can be flaky) "Permission denied" during apply Bot needs: Manage Channels, Manage Threads permissions Check bot role position in Discord server settings
Safety
Dry-run by default โ all mutating commands require --yes Snapshot before apply โ automatic, saved to .disclaw/snapshots/ Rollback available โ disclaw rollback -c disclaw.yaml --yes Managed-scope only โ disclaw only touches resources in the config Creates before deletes โ safer ordering during apply Validation โ config is validated before any API calls
Category context
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Config
- SKILL.md
- _meta.json