discord-connect-wizard

# Discord Connect Wizard (OpenClaw)

Run a localhost setup wizard that minimizes manual Discord steps.

Non-negotiable manual steps (Discord security):
- Complete Discord **login / CAPTCHA / 2FA** if prompted
- Copy the Bot Token once
- Click OAuth authorize once
- If DM pairing is needed: enable DMs in server privacy settings (Discord-side)

Wizard does:
- Creates a NEW OpenClaw `channels.discord.accounts.<accountId>` entry (never overwrites existing bots)
- Discovers guild/user IDs
- Writes config via `openclaw config set ... --json`
- Restarts gateway and approves pairing for that account

## Quick 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:
```bash
node scripts/conversation-checklist.mjs
```
Then follow `references/conversation-mode.md`.

### Localhost UI mode (optional)
```bash
cd <skill_dir>
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:
- **Welcome to the Developer Portal** popup → click **Log In** (or **Create Account**)
- Complete any required **login / CAPTCHA / 2FA** (agent cannot bypass Discord security)

Then (agent-guided):
- Create app → Bot → enable **Message Content Intent** (required)
- Copy Bot Token (paste into wizard)

### 2) Invite bot to your server (guided)
Wizard generates an invite URL with scopes:
- `bot`
- `applications.commands`

and baseline permissions:
- View Channels, Send Messages, Read...

# discord-connect-wizard

One-machine Discord bot onboarding wizard for **OpenClaw**.

Goal: turn the full Discord bot onboarding flow into **“only ask the human when absolutely required”**.

- Human-only steps (Discord security): **login / CAPTCHA / MFA / OAuth Authorize**
- Everything else: automated (create app, enable intents, write OpenClaw config, restart gateway, approve pairing)

---

## What this skill does

It helps you:

1. Create a new Discord Application + Bot
2. Enable required privileged intents (especially **Message Content Intent**)
3. Invite the bot to your server via OAuth2
4. Write OpenClaw config under a **new** account (never overwrites existing bots)
5. Restart OpenClaw gateway
6. Complete DM pairing (approve pairing for that specific account)

---

## Recommended: Conversation mode (no localhost UI)

Use this when you have an OpenClaw agent with the **browser** tool available.

### How to start

Just tell your OpenClaw agent something like:

> “Use discord-connect-wizard to connect a new Discord bot. Name it X and invite it to server Y.”

### UX rules (by design)

- The agent drives the Developer Portal end-to-end.
- The agent pauses only for:
  - Discord login / CAPTCHA / MFA
  - OAuth Authorize (select server + click Authorize)
- When you must act, the agent should send:
  - a screenshot
  - **one** instruction line

---

## Optional: Localhost wizard UI

Run a local web wizard if you prefer a step-by-step UI.

```bash
cd skills/discord-connect-wizard
node scripts/wizard.mjs
# open http://127.0.0.1:8787
```

Notes:
- Token is only shown once by Discord. Copy it immediately.
- The wizard writes config using `openclaw config set ... --json`.

---

## Troubleshooting

### OAuth page says “正在打开 Discord APP”
Normal redirect behavior. Wait a few seconds.

### DM to the bot doesn’t work
In the server privacy settings, enable **“Allow direct messages from server members”**, then DM the bot again.

### Pairing approval
Pairing is per account. Al...