Skip to content

Commit 1a00ddf

Browse files
GoGoComputerclaude
GoGoComputer
and
claude
committed
docs: add GUIDE-DISCORD-BOT.md — full walkthrough of the setup wizard's Discord stage
The setup wizard's Discord stage prints 3 condensed steps (OAuth2 → invite, enable Message Content Intent, then 'Enter Discord bot token vs external secret provider') and stops. That's enough if you've done Discord-bot integrations before but a dead end for a first-timer who doesn't know what 'Message Content Intent' is or which OAuth2 permissions are minimum-viable. New guide covers the whole arc in one place: 0. Pre-flight install/onboard done? network online? 1. Create app discord.com/developers/applications -> bot 2. Get token Reset Token + safety warnings 3. Intents Message Content Intent ← most common first-mistake callout; Server Members / Presence as optional 4. OAuth2 URL scopes (bot, applications.commands) + the minimum-permission table (no Administrator) 5. Paste in 'Enter Discord bot token' vs 'Use external secret provider' — when to pick each 6. First test check Online in server, send a mention, /commands ---- Security token = full bot account; rotate via Reset Token Troubleshooting bot offline / no message reads (intents) / slash commands missing (scope) / too slow (model size) / DM works channel doesn't (channel perms) / token leaked to GitHub recovery / multi-server / disable Cross-linking: - README (KO + EN) Documentation Map: new 💬 row - README (KO + EN) wizard walkthrough table: stage 11 now reads 'Skills / plugins / channels' and points at the new guide - docs/GUIDE-FIRST-USE.md (KO + EN): the inline 14-stage trail under './openclaw setup' mentions Discord stage and links the new doc - docs/GUIDE-WEB-FETCH.md Related-docs table: includes the Discord guide so users hopping between integration guides find it - The Discord guide itself has a 'Related docs' table linking back to FIRST-USE, OPENCLAW, WEB-FETCH, MANUAL-INSTALL, TROUBLESHOOTING, and the README's wizard table + network-isolation section CHANGELOG v0.2.9 (docs-only). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1 parent ef08bac commit 1a00ddf

6 files changed

Lines changed: 311 additions & 6 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
## 📖 목차 / Contents
44

5+
- [v0.2.9 — 2026-05-14](#v029--2026-05-14)
56
- [v0.2.8 — 2026-05-14](#v028--2026-05-14)
67
- [v0.2.7 — 2026-05-14](#v027--2026-05-14)
78
- [v0.2.6 — 2026-05-14](#v026--2026-05-14)
@@ -17,6 +18,21 @@
1718

1819
---
1920

21+
## v0.2.9 — 2026-05-14
22+
23+
### New guide
24+
- **`docs/GUIDE-DISCORD-BOT.md`** — running OpenClaw as a Discord bot, end-to-end. Mirrors the Discord stage of the setup wizard but in much more depth: app creation, **Message Content Intent** (the most common first-time gotcha), OAuth2 URL Generator with the minimum-viable permission set, token paste vs external secret provider, first message test, and a troubleshooting section covering bot-offline, intent missing, slash commands not appearing, etc. Security section covers what a leaked token means and how to rotate. Bilingual TLDR + KO body with EN-friendly headings.
25+
26+
### Cross-linking
27+
- README (KO + EN) Documentation Map: new 💬 row pointing to the guide.
28+
- README (KO + EN) wizard walkthrough table: stage **11 (Skills / plugins / channels)** now mentions Discord/Telegram/WhatsApp + links the new guide.
29+
- `docs/GUIDE-FIRST-USE.md` (KO + EN): the inline trail under `./openclaw setup` now mentions Discord stage and points at the new doc.
30+
- `docs/GUIDE-WEB-FETCH.md` Related-docs table: adds the Discord guide so users navigating between integration guides find it.
31+
32+
No code change.
33+
34+
---
35+
2036
## v0.2.8 — 2026-05-14
2137

2238
### Bug fix — setup wizard `Ollama not reachable` trap

‎README.en.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -172,7 +172,7 @@ Exact order/wording depends on the OpenClaw build, but you'll generally see thes
172172
| 8b | **Ollama base URL** ⚠️ **trap** | Default `http://127.0.0.1:11434` (editable text field) | **Must change to →** `http://host.docker.internal:11434`. Inside the container `127.0.0.1` means the container itself, not the host — so the wizard can't reach your host Ollama. `host.docker.internal` is Docker's special hostname that points back to the host. `./openclaw setup` prints a yellow box about this before launching the wizard. |
173173
| 9 | **Workspace dir** | Where the agent reads/writes files | Default `~/.openclaw/workspace` (mirrored to `~/DEV/openclawAgent` on the host) — just press Enter. |
174174
| 10 | **Search provider** | Web-search backend (Tavily etc.) | **`skip`** or Enter — easy to add later by re-running `setup`. |
175-
| 11 | **Skills / plugins** | Optional extra abilities (image gen, voice, …) | Defaults or `skip` for the first run. |
175+
| 11 | **Skills / plugins / channels** | Optional extra abilities (image gen, voice, …) + channel integrations (Discord, Telegram, WhatsApp, …) | Defaults or `skip` for the first run. Discord bot integration has its own walkthrough → [💬 GUIDE-DISCORD-BOT](docs/GUIDE-DISCORD-BOT.md) |
176176
| 12 | **UI (Control Panel)** | Use the web Control Panel | **Yes** — it's already running at `127.0.0.1:18789`. |
177177
| 13 | **Tailscale** | `off \| serve \| funnel` | **`off`** unless you actually use Tailscale to share the gateway across machines. |
178178
| 14 | **Health check** | Auto-runs at the end | Just wait for ✓. |
@@ -309,6 +309,7 @@ shorts run "moody travel landscapes"
309309
| 🌐 **Pulling stocks · news · FX from the web** | [docs/GUIDE-WEB-FETCH.md](docs/GUIDE-WEB-FETCH.md) | Network toggle cycle, real-world prompts, official APIs, automation, troubleshooting. **Includes `surf` command — sandboxed Docker fetch → Markdown brief**. KO+EN |
310310
| 🎨 **Designer workflow automation (Pinterest → nano-banana → Figma)** | [docs/GUIDE-CREATIVE-PIPELINE.md](docs/GUIDE-CREATIVE-PIPELINE.md) | 4-step manual → one command. 4 parallel nano-banana windows for ~3.7× speedup. KO+EN |
311311
| 🎬 **Shorts automation (Pinterest → Miricanvas → CapCut)** | [docs/GUIDE-SHORTS-PIPELINE.md](docs/GUIDE-SHORTS-PIPELINE.md) | `shorts run "keyword"` for refs · 1080×1920 design · 9:16 MP4 export. Sandbox boundary kept; install instructions included. KO+EN |
312+
| 💬 **Run OpenClaw as a Discord bot** | [docs/GUIDE-DISCORD-BOT.md](docs/GUIDE-DISCORD-BOT.md) | Stand up the agent as a Discord bot — mention/DM/slash commands. Create app → Message Content Intent → OAuth2 invite → token paste → first test → security + troubleshooting. Mirrors the setup wizard's Discord stage. |
312313
| 👤 **General user** | [README.en.md](README.en.md) (this file) | Command catalog · `.env` · network isolation · FAQ |
313314
| 🇰🇷 **일반 사용자 (KO)** | [README.md](README.md) | Korean main README |
314315
| 🛡 **Security-minded** | [SECURITY.md](SECURITY.md) · [🔒 Security section](#-security-please-read) · [🔒 Network isolation](#-network-isolation-modes-explicit-outbound-kill-switch) | Threat model, vulnerability reporting |

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -266,7 +266,7 @@ OpenClaw 본체 버전에 따라 단계 순서·문구는 약간 다를 수 있
266266
| 8b | **Ollama base URL** ⚠️ **함정** | 기본값 `http://127.0.0.1:11434` (입력 필드, 편집 가능) | **반드시 변경 →** `http://host.docker.internal:11434` (컨테이너 안의 `127.0.0.1` 은 컨테이너 자신이라 호스트 Ollama 에 못 닿음. `host.docker.internal` 이 호스트를 가리키는 Docker 의 특수 호스트명). `./openclaw setup` 이 시작 전에 노란색 박스로 한 번 더 알려줍니다. |
267267
| 9 | **Workspace dir** | 에이전트가 파일 작업할 디렉토리 | 기본 `~/.openclaw/workspace` (호스트의 `~/DEV/openclawAgent` 와 동기화됨) — Enter 추천. |
268268
| 10 | **Search provider** | 웹 검색 백엔드 (Tavily 등) | **`skip`** 또는 Enter — 나중에 `openclaw setup` 다시 돌려서 추가 가능. |
269-
| 11 | **Skills / 플러그인** | 추가 능력(이미지 생성, 음성 등) | 기본값 또는 `skip` — 처음엔 가볍게. |
269+
| 11 | **Skills / 플러그인 / 채널** | 추가 능력(이미지 생성, 음성) + 채널 연동 (Discord, Telegram, WhatsApp 등) | 기본값 또는 `skip` — 처음엔 가볍게. Discord 봇 연동은 별도 가이드 → [💬 GUIDE-DISCORD-BOT](docs/GUIDE-DISCORD-BOT.md) |
270270
| 12 | **UI (Control Panel)** | 웹 UI 사용 여부 | **Yes** — 이미 `127.0.0.1:18789` 로 떠 있음. |
271271
| 13 | **Tailscale** | `off \| serve \| funnel` | **`off`** — 외부에서 접속 안 함. Tailscale 사용자만 다른 옵션. |
272272
| 14 | **Health check** | 모든 설정 후 자동 점검 | 자동 진행 — 끝나면 ✓ 표시. |
@@ -404,6 +404,7 @@ shorts run "여행 감성 풍경"
404404
| 🌐 **웹에서 코스피·뉴스·환율 가져오기** | [docs/GUIDE-WEB-FETCH.md](docs/GUIDE-WEB-FETCH.md) | 네트워크 토글 사이클·실전 프롬프트·공식 API 키·자동화·트러블슈팅. **`surf` 명령으로 샌드박스 도커 안에서 검색 → 마크다운 도구 포함**. KO+EN 병기 |
405405
| 🎨 **디자이너 워크플로우 자동화 (Pinterest → 나노바나나 → Figma)** | [docs/GUIDE-CREATIVE-PIPELINE.md](docs/GUIDE-CREATIVE-PIPELINE.md) | 4단계 수작업 → 1명령. 나노바나나 4창 병렬로 속도 ~3.7×. KO+EN 병기 |
406406
| 🎬 **쇼츠 자동화 (Pinterest → 미리캔버스 → CapCut)** | [docs/GUIDE-SHORTS-PIPELINE.md](docs/GUIDE-SHORTS-PIPELINE.md) | `shorts run "키워드"` 으로 레퍼런스·1080×1920 디자인·9:16 영상 export. 샌드박스 경계 유지 + 프로그램 설치 안내 포함. KO+EN |
407+
| 💬 **Discord 봇으로 OpenClaw 운영** | [docs/GUIDE-DISCORD-BOT.md](docs/GUIDE-DISCORD-BOT.md) | Discord 서버에 OpenClaw 에이전트를 봇으로 띄워 멘션·DM·슬래시 명령으로 호출. 앱 생성 → Message Content Intent → OAuth2 invite → 토큰 등록 → 첫 테스트 → 보안·트러블슈팅. setup 마법사의 Discord 단계 안내. |
407408
| 👤 **일반 사용자** | [README.md](README.md) (이 문서) | 명령 카탈로그·`.env`·네트워크 격리·FAQ |
408409
| 🇬🇧 **General user (EN)** | [README.en.md](README.en.md) | Full English equivalent of this README |
409410
| 🩺 **진단 항목별 상세 가이드** | [docs/TROUBLESHOOTING.md — doctor 상세 항목별 가이드](docs/TROUBLESHOOTING.md#doctor-항목별-상세-가이드) | OS · RAM · 디스크 · Xcode CLT · Docker 데몬 · 포트 충돌 · compose 보안 경고(`docker.sock`) 각각에 대한 의미·자동·수동 해결 |

0 commit comments

Comments
 (0)