@@ -2,6 +2,7 @@
 
 ## 📖 목차 / Contents
 
+- [v0.2.17 — 2026-05-14](#v0217--2026-05-14)
 - [v0.2.16 — 2026-05-14](#v0216--2026-05-14)
 - [v0.2.15 — 2026-05-14](#v0215--2026-05-14)
 - [v0.2.14 — 2026-05-14](#v0214--2026-05-14)
@@ -25,6 +26,43 @@
 
 ---
 
+## v0.2.17 — 2026-05-14
+
+### Bug fix — Discord bot replies "Something went wrong" after stop/start (sandbox compose overlay drop)
+User's Discord bot was Online but every message got the generic OpenClaw error reply:
+
+> ⚠️ Something went wrong while processing your request. Please try again, or use `/new` to start a fresh session.
+
+Gateway logs revealed the actual cause:
+
+```
+[diagnostic] lane task error: lane=session:agent:main:discord:channel:...
+  error="Error: Failed to inspect sandbox image: failed to connect to the
+  docker API at unix:///var/run/docker.sock; ... no such file or directory"
+```
+
+The bot processes each message by spinning a sandbox sub-container, which needs `/var/run/docker.sock` mounted into the gateway container. `install.sh` step_sandbox generates `~/DEV/openclaw/docker-compose.sandbox.yml` (the overlay that mounts the socket) and brings the gateway up with that overlay included — but **neither `cmd/start.sh` nor `step_lockdown` referenced this overlay afterward**. So the first `./openclaw stop && ./openclaw start` (or any `network online --restart` / `network isolated --restart`) silently dropped the socket mount, and the bot stopped being able to invoke tools.
+
+Symptom: `docker inspect openclaw-openclaw-gateway-1 --format '{{range .Mounts}}{{.Source}} {{end}}'` shows the workspace and config mounts but **no `/var/run/docker.sock`**. Plugins list shrinks from 7 (with `discord`) back to 6 because the discord channel can't run.
+
+- **`cmd/start.sh`** — now adds `-f $OPENCLAW_DIR/docker-compose.sandbox.yml` to the compose args when that file exists. Same conditional include pattern already used for `compose.security.yml` / `compose.network.yml`. If the overlay doesn't exist (sandbox disabled by `OPENCLAW_SANDBOX=0`, or never set up) the start path is unchanged.
+- **`cmd/install.sh step_lockdown`** — same fix. Without this, the very last step of `./openclaw install` (the auto-lockdown to isolated) was already dropping the sandbox mount on first install, so the bot worked only between step_sandbox and step_lockdown — invisible to users until they tried Discord.
+
+### Documentation
+- **GUIDE-DAILY-USE 트러블슈팅 표** — new row for "`Something went wrong while processing your request`" with the docker.sock cause and the `git pull → stop → start` recovery. Includes a one-liner to verify the mount.
+- **GUIDE-DISCORD-BOT 트러블슈팅** — new dedicated entry "봇이 응답으로 'Something went wrong...'" with the full diagnosis, log grep one-liner, mount verification, and history of the v0.2.16-and-earlier regression.
+
+### Verified on user's machine
+After patch + `./openclaw stop && start`:
+- Gateway healthy
+- Mounts now include `/var/run/docker.sock -> /var/run/docker.sock`
+- Plugins line: `ready (7 plugins: acpx, bonjour, browser, device-pair, **discord**, phone-control, talk-voice)`
+- `discord client initialized as <id> (openclaw); awaiting gateway readiness` — connected and ready to process messages.
+
+VERSION 0.2.16 → 0.2.17.
+
+---
+
 ## v0.2.16 — 2026-05-14
 
 ### GUIDE-DAILY-USE TL;DR — Discord prompt cheat sheet alongside host commands
 
@@ -395,6 +395,7 @@ rm ~/.openclaw-mgr/state
 |---|---|
 | 웹UI "Safari Can't Connect" | [isolated 모드 → online 으로](../README.md#-외부-네트워크-잠깐-켜기) |
 | TUI 답이 안 옴: **`fetch failed`** / **`LLM request failed: network connection error`** | 컨테이너→Ollama 네트워크 자체는 OK 인데 **모델 이름이 실제 설치된 이름과 다름** (예: `gemma4` vs `gemma4:26b`). 아래 [현재 어떤 모델을 쓰는지 확인](#-현재-어떤-모델을-쓰는지--openclawjson-점검) 참조 |
+| Discord 봇 응답: **`Something went wrong while processing your request. Please try again, or use /new to start a fresh session.`** (게이트웨이 로그에서 `Failed to inspect sandbox image: dial unix /var/run/docker.sock: no such file or directory`) | `./openclaw stop && start` 또는 `network` 토글 후 **gateway 컨테이너에 `/var/run/docker.sock` 마운트가 빠진 상태**. 봇이 도구 실행할 때 sandbox 컨테이너 못 띄움. v0.2.17+ 에서 `start.sh` / `step_lockdown` 이 자동으로 `docker-compose.sandbox.yml` 오버레이를 포함하도록 패치됨 — `git pull && ./openclaw stop && ./openclaw start` 한 번이면 해결. 확인: `docker inspect openclaw-openclaw-gateway-1 --format '{{range .Mounts}}{{.Source}} {{end}}' \| grep docker.sock` |
 | TUI 에서 답이 안 옴 / 느림 (메시지는 가긴 감) | 모델이 너무 크다 — `./openclaw chat` 의 picker 로 가벼운 모델 선택 |
 | install 이 [skip] 만 띄움 | [state 파일 vs 실제 산출물 어긋남 FAQ](../README.md) |
 | chat 에서 "Ollama not reachable" | Ollama 앱 안 켜진 상태 — `open -a Ollama` |
 
@@ -831,6 +831,30 @@ json.dump(cfg, open("/Users/mo/.openclaw/openclaw.json", "w"), indent=2)
 - [ ] OpenClaw 게이트웨이 컨테이너가 떠 있는가? `docker compose ps`
 - [ ] 방화벽이 `discord.com`/`gateway.discord.gg` outbound 를 차단? (회사 네트워크 흔한 케이스)
 
+### "봇이 응답으로 `Something went wrong while processing your request. Please try again, or use /new to start a fresh session.`"
+
+게이트웨이 로그에 다음이 보이면 `docker.sock` 마운트 누락:
+```bash
+./openclaw logs | grep -i "Failed to inspect sandbox image"
+# → Error: Failed to inspect sandbox image: failed to connect to the docker
+#   API at unix:///var/run/docker.sock; ... no such file or directory
+```
+
+원인: `./openclaw stop && start` 또는 `network online/isolated --restart` 사이클 후 gateway 컨테이너 안에 `/var/run/docker.sock` 마운트가 빠진 상태. 봇이 메시지를 받으면 도구 실행을 위해 **sandbox 서브컨테이너**를 띄우려는데 socket 이 없어 실패.
+
+해결 (v0.2.17+):
+```bash
+cd ~/DEV/openclawAgent/openclaw-workspace/openclaw-mgr
+git pull
+./openclaw stop && ./openclaw start
+# 확인:
+docker inspect openclaw-openclaw-gateway-1 \
+  --format '{{range .Mounts}}{{.Source}} {{end}}' | tr ' ' '\n' | grep docker.sock
+# → /var/run/docker.sock  이 나와야 정상
+```
+
+원래는 install 의 `step_sandbox` 가 `docker-compose.sandbox.yml` 을 만들어 처음엔 마운트가 들어가는데, 그 이후 stop/start 또는 lockdown 이 호출되면 sandbox 오버레이가 빠지는 게 v0.2.16 까지의 회귀였음. v0.2.17 에서 `start.sh` 와 `step_lockdown` 둘 다 sandbox 오버레이를 자동 포함하도록 수정.
+
 ### "봇이 Online 인데 어떤 메시지에도 응답 안 함 — TUI 에서는 `fetch failed`"
 
 OpenClaw 의 설정에 등록된 **모델 이름이 실제 설치된 Ollama 모델과 다른** 케이스. OpenClaw 가 onboard 중 하드코딩 기본값 (`gemma4` 등 태그 없는 이름) 을 자동으로 모델 목록에 끼워 넣어 일어남. → [GUIDE-DAILY-USE: 현재 어떤 모델을 쓰는지](GUIDE-DAILY-USE.md#-현재-어떤-모델을-쓰는지--openclawjson-점검) 의 진단·해결 3단계 그대로 적용. 빠른 fix: `./openclaw setup --skip-confirm` (v0.2.11+ 자동 정리).
 
@@ -454,8 +454,13 @@ step_lockdown() {
   [ -f compose.yml ] && files="-f compose.yml"
   local sec="$OPENCLAW_MGR_DIR/compose.security.yml"
   local net="$OPENCLAW_MGR_DIR/compose.network.yml"
+  local sandbox_overlay="$OPENCLAW_DIR/docker-compose.sandbox.yml"
   [ -f "$sec" ] && files="$files -f $sec"
   [ -f "$net" ] && files="$files -f $net"
+  # 🛡 step_sandbox 가 만든 docker.sock 마운트 오버레이도 포함해 lockdown.
+  # 안 그러면 lockdown 직후 sandbox 마운트가 풀려 봇이 도구 호출 시 "Failed
+  # to inspect sandbox image" 로 떨어진다. (start.sh 와 동일한 회귀 방지.)
+  [ -f "$sandbox_overlay" ] && files="$files -f $sandbox_overlay"
   # shellcheck disable=SC2086
   docker compose $files up -d --pull missing
 }
 
@@ -37,6 +37,9 @@ OPENCLAW_DIR="${OPENCLAW_DIR:-$HOME/DEV/openclaw}"
 cd "$OPENCLAW_DIR"
 sec="${OPENCLAW_MGR_DIR}/compose.security.yml"
 net="${OPENCLAW_MGR_DIR}/compose.network.yml"
+# install 의 step_sandbox 가 생성한 docker.sock 마운트 오버레이.
+# 없으면 (샌드박스 비활성 또는 사용자가 OPENCLAW_SANDBOX=0 으로 설정) 그냥 스킵.
+sandbox="$OPENCLAW_DIR/docker-compose.sandbox.yml"
 
 # 네트워크 override 가 없으면 isolated 로 자동 생성 (기본 = 최고 보안).
 if [ ! -f "$net" ]; then
@@ -50,6 +53,12 @@ info "네트워크 모드: $mode (변경: ./openclaw network online|isolated --r
 args=(-f docker-compose.yml)
 [ -f "$sec" ] && args+=(-f "$sec")
 [ -f "$net" ] && args+=(-f "$net")
+# 🛡 샌드박스 오버레이 포함 — 없으면 gateway 컨테이너 안에 /var/run/docker.sock
+# 마운트가 빠져, 봇이 도구 실행할 때 "Failed to inspect sandbox image: dial
+# unix /var/run/docker.sock: no such file or directory" 로 떨어진다. install
+# 의 step_sandbox 가 이 파일을 만들지만 그 직후 ./openclaw stop && start 만
+# 해도 이 오버레이가 빠지는 게 v0.2.16 까지의 회귀였다.
+[ -f "$sandbox" ] && args+=(-f "$sandbox")
 docker compose "${args[@]}" up -d
 ok "컨테이너 시작 완료"
 
 
@@ -13,7 +13,7 @@ set -euo pipefail
 OPENCLAW_MGR_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
 export OPENCLAW_MGR_DIR
 
-VERSION="0.2.16"
+VERSION="0.2.17"
 
 # .env 자동 초기화: .env 없으면 .env.example 에서 자동 생성 (cp 불필요, 첫 실행부터 동작)
 # Auto-init: create .env from .env.example on first run — zero-config for beginners