Discord Connect Wizard
by @gm4leejun-stack
One-machine Discord bot onboarding wizard for OpenClaw. Use when setting up Discord for the first time (create bot, enable intents, invite to a guild, auto-w...
clawhub install discord-connect-wizardπ About This Skill
name: discord-connect-wizard description: One-machine Discord bot onboarding wizard for OpenClaw. Use when setting up Discord for the first time (create bot, enable intents, invite to a guild, auto-write OpenClaw config, restart gateway, and complete DM pairing). Designed for local Mac/Windows/Linux hosts with a localhost web UI + optional browser automation guidance.
Discord Connect Wizard (OpenClaw)
Run a localhost setup wizard that minimizes manual Discord steps.
Non-negotiable manual steps (Discord security):
Wizard does:
channels.discord.accounts. entry (never overwrites existing bots)openclaw config set ... --jsonQuick start
Conversation mode (recommended)
Use browser automation + chat prompts. No localhost UI required.Hard requirement: agent opens and drives the Developer Portal via browser tool (do not ask user to open pages or click around). Resilience rule: if the browser tool times out / disconnects, the agent must self-recover (restart gateway/browser as needed) and retry. Only ask the user to click if recovery is impossible. UX rule: whenever the user must act (login/CAPTCHA/MFA/OAuth authorize), send a screenshot + ONE instruction line. If you need a deterministic step list, run:
node scripts/conversation-checklist.mjs
Then follow references/conversation-mode.md.Localhost UI mode (optional)
cd
node scripts/wizard.mjs
open http://127.0.0.1:8787
Workflow
1) Create bot + enable intents (guided)
User steps you will see on screen:Then (agent-guided):
2) Invite bot to your server (guided)
Wizard generates an invite URL with scopes:botapplications.commandsand baseline permissions:
You still need to select the server and click Authorize.
3) Auto-discover IDs (automatic)
4) Write OpenClaw config + restart (automatic)
Wizard writes:channels.discord.enabled=truechannels.discord.token=...channels.discord.groupPolicy="allowlist"channels.discord.guilds..requireMention=false channels.discord.guilds..users=[""] Then runs openclaw gateway restart.
5) Pairing (semi-automatic)
openclaw pairing approve discord Browser automation (optional)
If an OpenClaw agent with thebrowser tool is available, use it to:
Do not attempt to bypass CAPTCHA/2FA; pause for manual completion.
Files
scripts/wizard.mjs: localhost wizard server + OpenClaw config writerreferences/openclaw-discord-baseline.md: official baseline config + troubleshooting pointersπ‘ Examples
Conversation mode (recommended)
Use browser automation + chat prompts. No localhost UI required.Hard requirement: agent opens and drives the Developer Portal via browser tool (do not ask user to open pages or click around). Resilience rule: if the browser tool times out / disconnects, the agent must self-recover (restart gateway/browser as needed) and retry. Only ask the user to click if recovery is impossible. UX rule: whenever the user must act (login/CAPTCHA/MFA/OAuth authorize), send a screenshot + ONE instruction line. If you need a deterministic step list, run:
node scripts/conversation-checklist.mjs
Then follow references/conversation-mode.md.Localhost UI mode (optional)
cd
node scripts/wizard.mjs
open http://127.0.0.1:8787