discord-intent-runbook

name	discord-intent-runbook
description	Diagnose and remediate Discord channel reliability issues in OpenClaw, especially privileged intent mismatches and reconnect loops. Use when Discord logs show code 4014, bot is online but not responding, channels keep auto-restarting, message content appears limited, or after changing Discord/OpenClaw channel settings.

Discord Intent Runbook

Overview

Run a deterministic troubleshooting flow for Discord in OpenClaw. Collect probe evidence first, then apply safe config and portal-side fixes.

Quick Start

1. Run probe:

   ./scripts/discord_intent_probe.sh
   

2. Triage logs:

   ./scripts/discord_log_triage.sh
   

3. Generate fix checklist:

   ./scripts/discord_fix_checklist.sh > /tmp/discord-intent-fix.md
   

Workflow

Step 1: Collect baseline evidence

• Capture:
  • openclaw channels capabilities --channel discord --json
  • openclaw channels status --probe --json
  • openclaw config get channels.discord --json
  • openclaw channels logs --channel discord --lines 200
• Do not change config before evidence is captured.

Step 2: Identify likely failure class

• 4014 / missing privileged gateway intents:
  • portal intent mismatch is primary suspect.
• messageContent: limited:
  • bot may miss non-mention text in guild channels.
• repeated auto-restart attempt:
  • treat as persistent channel health issue until probe + logs are clean.

Step 3: Apply safe fixes

• Update Discord Developer Portal intents for the bot.
• Keep OpenClaw channel policy explicit (groupPolicy, mention rules) and validated.
• Prefer incremental changes and re-probe after each change.

Step 4: Verify and close

• Re-run probe and log triage.
• Success criteria:
  1. probe reports ok
  2. no fresh 4014 in recent logs
  3. bot can respond in expected channel mode
• Document final state and remaining constraints.

Guardrails

• Do not print raw Discord token values.
• Do not blindly flip policies in production group chats.
• If gateway is unreachable, perform config-only diagnosis and report that runtime verification is pending.

Resources

• scripts/discord_intent_probe.sh: Gather probe + config evidence.
• scripts/discord_log_triage.sh: Detect Discord-specific error patterns in recent logs.
• scripts/discord_fix_checklist.sh: Generate step-by-step remediation checklist.
• references/discord-intent-playbook.md: Extended runbook and decision table.

Example Requests

1. "Dùng discord-intent-runbook kiểm tra vì sao bot Discord reconnect liên tục."
2. "Dùng discord-intent-runbook xử lý lỗi 4014 theo quy trình an toàn."
3. "Dùng discord-intent-runbook tạo checklist fix để mình cấu hình Discord Portal."

For deeper guidance, load references/discord-intent-playbook.md.