Skip to content

Commit 9ed2c53

Browse files
GoGoComputerclaude
GoGoComputer
and
claude
committed
docs(discord-bot): expand from setup-only to setup + everyday operation
The previous guide ended at "your bot replied once" and dropped users on Discord with no map for the next thousand interactions. This adds five new sections (§7-§11) plus a one-screen cheat sheet covering how people actually use the bot day-to-day. §7 봇과 대화하는 4가지 방법 — trigger semantics for @mention, DM, slash commands (/agent ask, /agent reset, ...), and channel whitelist auto-respond. Notes on context length per trigger, when threads are appropriate, and DM privacy behavior. §8 자주 쓰는 프롬프트 패턴 — one-liners, long-text summarization (with the Discord 2000-char ceiling noted), code review with fenced diffs, workspace-aware prompts that reference files under ~/.openclaw/workspace, thread-based continued conversation, /reset, and in-channel model switching. §9 채널·서버별 동작 조정 — six tuning knobs as a table: autoChannels / muteChannels / channelModels / channelPersonas / allowedGuilds / maxInputChars. Concrete JSON example for splitting "#code" vs "#general" onto different Ollama models. Includes the "Settings > Advanced > Developer Mode > Copy Channel ID" walk. §10 워크스페이스·인격을 봇으로 끌어오기 — same IDENTITY/SOUL/USER/ AGENTS/MEMORY system-prompt loading as ./openclaw chat; edits take effect on the next message (no restart); using the bot itself to append to MEMORY.md mid-conversation; multimodal/attachment notes where supported. §11 봇 행동 관리 — temporary quiet vs ./openclaw stop, channel-level mute, multi-server operation (same token vs separate bots), the recurring "stop for lunch, start after" pattern that points at GUIDE-DAILY-USE, and a clean way to disable Discord while keeping the rest of OpenClaw running. 🎯 명령·인터랙션 cheat sheet — two compact tables (Discord-side and host-side) for the things people look up most often. Cross-linking - README (KO + EN) Documentation Map: 💬 row description now enumerates what's actually inside the guide - docs/GUIDE-DAILY-USE.md related-docs entry expands to point at the new §7-§11 VERSION 0.2.11 -> 0.2.12; CHANGELOG entry. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1 parent 895351f commit 9ed2c53

6 files changed

Lines changed: 290 additions & 4 deletions

File tree

‎CHANGELOG.md‎

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

33
## 📖 목차 / Contents
44

5+
- [v0.2.12 — 2026-05-14](#v0212--2026-05-14)
56
- [v0.2.11 — 2026-05-14](#v0211--2026-05-14)
67
- [v0.2.10 — 2026-05-14](#v0210--2026-05-14)
78
- [v0.2.9 — 2026-05-14](#v029--2026-05-14)
@@ -20,6 +21,26 @@
2021

2122
---
2223

24+
## v0.2.12 — 2026-05-14
25+
26+
### GUIDE-DISCORD-BOT.md — major expansion (setup-only → setup + daily-use)
27+
The original guide stopped at "your bot is online and replied once". This release adds five new sections covering everyday operation, plus a one-screen cheat sheet:
28+
29+
- **§7 봇과 대화하는 4가지 방법** — @mention / DM / slash commands (`/agent ask`, `/agent reset`, etc.) / channel whitelist auto-respond. Per-trigger semantics: context length, when threads are useful, DM privacy.
30+
- **§8 자주 쓰는 프롬프트 패턴** — one-liners, long-text summarization (with Discord's 2000-char limit caveat), code review with fenced diffs, workspace-aware prompts ("read MEMORY.md and …"), thread-based continued conversation, `/reset`, in-Discord model switching.
31+
- **§9 채널·서버별 동작 조정** — table of six tuning knobs (autoChannels / muteChannels / channelModels / channelPersonas / allowedGuilds / maxInputChars) with a concrete JSON example showing per-channel model assignment. Includes the "Copy Channel ID" walkthrough.
32+
- **§10 워크스페이스·인격을 봇으로 끌어오기** — how IDENTITY/SOUL/USER/AGENTS/MEMORY auto-load into the bot's system prompt (same as `./openclaw chat`); editing those files reflects on the next message without restart; using the bot itself to append to MEMORY.md mid-conversation; multimodal attachments.
33+
- **§11 봇 행동 관리** — temporary mute (Discord-side vs `./openclaw stop`), permanent kick/ban, multi-server operation (same token vs separate bots), daily on/off pattern linked to GUIDE-DAILY-USE, disabling Discord while keeping the rest of OpenClaw.
34+
- **🎯 명령·인터랙션 cheat sheet** — two compact tables (Discord-side actions, host-side commands) so users don't have to scroll the guide for everyday lookups.
35+
36+
### Cross-linking
37+
- README (KO + EN) Documentation Map: the 💬 row description now lists what's actually inside (setup + daily-use sections + cheat sheet + troubleshooting cases) instead of just "create bot, invite, paste token".
38+
- `docs/GUIDE-DAILY-USE.md` related-docs entry expands the description to point at the new §7–§11.
39+
40+
No code change.
41+
42+
---
43+
2344
## v0.2.11 — 2026-05-14
2445

2546
### Bug fix — TUI/Discord `fetch failed` after fresh setup (`OLLAMA_DEFAULT_MODEL` trap)

‎README.en.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -309,7 +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. |
312+
| 💬 **Run OpenClaw as a Discord bot** | [docs/GUIDE-DISCORD-BOT.md](docs/GUIDE-DISCORD-BOT.md) | **Setup** (create app → Message Content Intent → OAuth2 invite → paste token → first test) **+ everyday use** (four ways to trigger: mention/DM/slash/whitelist · prompt patterns · per-channel model & persona · workspace file references · mute/disable/multi-server · cheat sheet) **+ security + 8-case troubleshooting**. |
313313
| 🔄 **Daily on/off cycle (after install)** | [docs/GUIDE-DAILY-USE.md](docs/GUIDE-DAILY-USE.md) | The everyday loop once setup is done — morning start, stepping away, shutdown, resuming a session, what to do when something looks wrong, periodic maintenance. Side-by-side table comparing `./openclaw stop` vs `docker compose down` vs `uninstall`. |
314314
| 👤 **General user** | [README.en.md](README.en.md) (this file) | Command catalog · `.env` · network isolation · FAQ |
315315
| 🇰🇷 **일반 사용자 (KO)** | [README.md](README.md) | Korean main README |

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -404,7 +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 단계 안내. |
407+
| 💬 **Discord 봇으로 OpenClaw 운영** | [docs/GUIDE-DISCORD-BOT.md](docs/GUIDE-DISCORD-BOT.md) | **셋업** (앱 생성 → Message Content Intent → OAuth2 invite → 토큰 등록 → 첫 테스트) **+ 일상 사용** (트리거 4종: 멘션/DM/슬래시/자동응답 · 자주 쓰는 프롬프트 패턴 · 채널별 모델·인격 분리 · 워크스페이스 파일 인용 · mute/disable/다중 서버 · cheat sheet) **+ 보안 7항목 + 트러블슈팅 8케이스**. KO 본문. |
408408
| 🔄 **매일 켜고 끄는 법 (일상 사용)** | [docs/GUIDE-DAILY-USE.md](docs/GUIDE-DAILY-USE.md) | install 끝낸 이후의 사이클 — 매일 아침 켜기 / 자리 비울 때 / 컴퓨터 끄기 / 대화 이어가기 / 뭔가 이상할 때 / 주기 유지보수. 종료 방법별 비교 표 (`./openclaw stop` vs `docker compose down` vs `uninstall`). |
409409
| 👤 **일반 사용자** | [README.md](README.md) (이 문서) | 명령 카탈로그·`.env`·네트워크 격리·FAQ |
410410
| 🇬🇧 **General user (EN)** | [README.en.md](README.en.md) | Full English equivalent of this README |

‎docs/GUIDE-DAILY-USE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -301,7 +301,7 @@ PY
301301
| 문서 | 무엇이 있나 |
302302
|---|---|
303303
| [▶ 설치 후 첫 사용 가이드](GUIDE-FIRST-USE.md) | 이 가이드의 **앞 단계** — install 직후 5분 안에 첫 대화까지 |
304-
| [💬 Discord 봇 운영](GUIDE-DISCORD-BOT.md) | 봇으로 운영할 때의 일상 사이클·트러블슈팅 |
304+
| [💬 Discord 봇 운영](GUIDE-DISCORD-BOT.md) | 봇으로 운영할 때의 일상 사이클·트러블슈팅. **§7–§11 일상 사용법** (트리거 4종 · 자주 쓰는 프롬프트 · 채널별 모델/인격 · cheat sheet) |
305305
| [🌐 웹에서 정보 가져오기](GUIDE-WEB-FETCH.md) | 일상에 `surf` 명령으로 뉴스·코스피 가져오는 패턴 |
306306
| [🚑 트러블슈팅](TROUBLESHOOTING.md) | 시나리오 5 더 자세한 진단 |
307307
| [🐾 OpenClaw 기초](GUIDE-OPENCLAW.md) | 에이전트 구조·세션·메모리 |

0 commit comments

Comments
 (0)