v0.1.7 — doctor fix (was stopping after CPU)

Bugfix

openclaw doctor was silently exiting after the CPU row when run in some macOS environments.

Cause: the _row helper's last expression was [ -n "$hint" ] && printf ... — when hint was empty, the function returned exit code 1, triggering set -e at the call site. The CPU row passes an empty hint, so the script died right after printing it.

Fix: explicit return 0 at the end of _row.

If you saw openclaw doctor stop after the CPU line, please update:

openclaw self-update      # brew users
# or in manual mode:
cd ~/DEV/openclaw-workspace && git pull --ff-only

v0.1.6 — beginner contributor guide + bilingual templates

Highlights

• 🌱 New docs/GUIDE-CONTRIBUTING.md — non-developer-friendly contribution guide (KO+EN). Typos, translation, beta-testing all count.
• 🌐 PR template + bug/feature issue templates are now bilingual (KO+EN).
• ➕ New issue templates: 📝 documentation, ❓ question.
• 🧭 New issue chooser config with quick links to SECURITY.md, docs map, and the beginner contribute guide.
• 📚 README documentation maps (KO+EN) updated with the new beginner row.

No code changes to openclaw itself — version bumped to 0.1.6 to keep tap in sync.

v0.1.5 — web-browsing scenario in beginner guide

Added a bilingual section to docs/GUIDE-OPENCLAW.md answering the common beginner question: can OpenClaw fetch news articles or KOSPI data from the web? — yes, after openclaw network online --restart, with a table of which protections remain intact in online mode (host isolation, read-only rootfs, cap_drop, 127.0.0.1 binding) and which gate is opened.

v0.1.4 — 'From Zero' beginner guide

What's new

New bilingual (KO+EN) GUIDE-FROM-ZERO.md for absolute beginners — starts from opening Terminal and creating a folder with mkdir, walks through the five essential commands (pwd / ls / cd / mkdir / clear), then leads into the one-line install. Includes a 'where people commonly get stuck' FAQ (PATH not refreshed after install, hidden-input password prompts, frozen-screen tips, rm -rf safety warning).

The Documentation map in both READMEs now leads with this guide as the very first entry.

v0.1.3 — beginner guides for Ollama / Docker / OpenClaw

What's new

Three new bilingual (KO+EN) beginner guides under docs/:

• GUIDE-OLLAMA.md — what Ollama is, models, where they live, host↔container wiring
• GUIDE-DOCKER.md — what Docker is, why containerize, 4 key terms, security hardening
• GUIDE-OPENCLAW.md — clears up the OpenClaw vs openclaw-workspace confusion, first 5 minutes

The Documentation map tables in both READMEs now point newcomers to these primers.

v0.1.2 — model management made easy

What's new

openclaw models command — manage local LLMs without ever opening .env:

openclaw models                  # list .env entries + locally installed models
openclaw models suggest          # curated 24GB picks (coding/general/Korean)
openclaw models add llama3.1:8b  # auto-edit .env + ollama pull
openclaw models remove name --purge
openclaw models pull name

Also available as menu entry 14.

Docs: new bilingual '🤖 Models' sections in both READMEs explaining:

• Host Ollama sharing (any ollama pull works inside OpenClaw immediately)
• Non-developer vs developer workflows
• The isolated mode caveat (blocks host Ollama too)

v0.1.1 — one-line installer + self-update

What's new

• One-line web installer: curl -fsSL https://raw.githubusercontent.com/GoGoComputer/openclaw-workspace/main/scripts/install.sh | bash
• openclaw self-update (alias: ai-update, upgrade) — updates the manager itself, auto-detecting Homebrew vs git install.
• In-menu update notification — the launcher checks GitHub for a newer release (24h cache, silent on offline) and shows a banner.
• READMEs (KO/EN) updated with the new top-of-file install banner and option ordering.

v0.1.0 — initial release

v0.1.0 — initial release

🇰🇷 한국어 · 🇺🇸 English (both languages below)

---

🇰🇷 한국어

OpenClaw 셀프호스트 자동화 도구의 첫 공개 릴리스입니다.

✨ 새로운 기능

• 단일 진입 CLI/런처 ./openclaw — 인자 없이 실행하면 대화형 메뉴(menu), 모든 명령은 서브커맨드 한 줄로도 가능
  • menu, doctor, install, start, stop, logs, update, backup, restore, schedule, network, clean, uninstall
• 멱등 설치 — 중간에 끊겨도 다시 실행하면 이어서 진행 (~/.openclaw-mgr/state 기반). 공장 초기화 맥에서도, 일부 도구가 이미 설치된 맥에서도 동일하게 동작 (중복 설치 자동 방지).
• 상태 점검 — Xcode CLT / Homebrew / Docker / Ollama / 저장소 / 컨테이너 / 포트 / 디스크 / RAM / 자동 스케줄 / 네트워크 격리 / 한국 소버린 AI 호환 — 한 화면에 ✓/✗/⚠ 로 표시
• 백업·복원 — Docker 볼륨 + .env 를 tar.gz 로, sha256 체크섬 + GPG 대칭암호화(기본 ON)
• 자동 업데이트 — launchd 로 매일 정해진 시각 자동 git pull --ff-only + 이미지 갱신 + Ollama 모델 갱신
• 🔒 네트워크 격리 런처 — ./openclaw network isolated|online 으로 컨테이너 외부 통신을 한 번에 켜고 끄기. 기본값은 isolated (외부 차단). 악성 패키지 다운로드, 데이터 외부 유출 모두 물리적으로 불가.
• 🧹 메모리·디스크 정리 — ./openclaw clean 으로 비개발자도 안전하게 정리(--status, --light, --all, 대화형).
• 한국 소버린 AI 자연 호환 — 자매 프로젝트 korea-sovereign-ai 의 EXAONE/A.X/Solar 모델을 호스트 Ollama 공유로 그대로 사용.

🔒 보안

• compose.security.yml 강제 — read_only, cap_drop:[ALL], no-new-privileges, pid/mem/cpu 한도
• 네트워크 격리(기본값) — Docker internal: true + DNS 차단으로 컨테이너→외부 모든 통신 차단
• /var/run/docker.sock 마운트 자동 검출·차단
• 모든 외부 노출 포트는 127.0.0.1 에만 바인딩
• .env chmod 600 + .gitignore 강제 + git-ignore 검증
• 백업 traversal 방어 (tar tzf 사전 검사 + --no-same-owner)
• launchd plist 권한·소유자·절대경로 검증
• git clone --depth 1 + 선택적 OPENCLAW_PIN_COMMIT 핀
• 로그 출력에서 *KEY|*TOKEN|*SECRET|PASSWORD 자동 마스킹
• gitleaks pre-commit hook + CI 검사

📚 문서

• README.md — 한국어 메인
• README.en.md — 영어 (동등 분량)
• docs/QUICKSTART-ko.md · docs/QUICKSTART-en.md — 비개발자용 단계별 가이드
• docs/ARCHITECTURE.md — 모듈 다이어그램·상태 머신·백업 포맷
• docs/TROUBLESHOOTING.md — doctor 출력별 대응표
• docs/CONTRIBUTING.md · SECURITY.md

⚠️ 알려진 제한

• OpenClaw 공식 코어 저장소 URL 미확정 — .env 의 OPENCLAW_REPO 를 사용자가 채워야 컨테이너 단계가 진행됩니다.
• macOS 전용 (Linux/Windows 미지원)
• 레퍼런스 머신: MacBook Pro 16" M5 Pro / 24GB RAM (Apple Silicon arm64)

🚀 설치

git clone https://github.com/GoGoComputer/openclaw-workspace.git
cd openclaw-workspace/openclaw-mgr
cp .env.example .env
./openclaw            # 대화형 메뉴 (또는: ./openclaw doctor && ./openclaw install)

---

🇺🇸 English

First public release of the OpenClaw self-host automation tool.

✨ New features

• Single-entry CLI/launcher ./openclaw — run with no arguments to open the interactive menu (menu), or use any subcommand directly
  • menu, doctor, install, start, stop, logs, update, backup, restore, schedule, network, clean, uninstall
• Idempotent install — interrupted runs resume from the last completed step (state in ~/.openclaw-mgr/state). Works identically on a freshly factory-reset Mac and on a Mac that already has some tools installed (duplicates auto-skipped).
• State diagnosis — Xcode CLT / Homebrew / Docker / Ollama / repo / container / ports / disk / RAM / auto-schedule / network isolation / Korean Sovereign AI compatibility — all in one ✓/✗/⚠ table
• Backup & restore — Docker volumes + .env packed as tar.gz, sha256 checksum + GPG symmetric encryption (default ON)
• Auto-update — daily at a fixed time via launchd: git pull --ff-only + image refresh + Ollama model refresh
• 🔒 Network isolation launcher — ./openclaw network isolated|online toggles outbound traffic in one command. Default is isolated (outbound blocked). Malicious package downloads and data exfiltration are physically impossible.
• 🧹 Memory & disk cleanup — ./openclaw clean lets non-developers safely tidy up (--status, --light, --all, interactive).
• Native Korean Sovereign AI compatibility — sister project korea-sovereign-ai (EXAONE/A.X/Solar) shares the host Ollama and works as-is.

🔒 Security

• compose.security.yml enforced — read_only, cap_drop:[ALL], no-new-privileges, pid/mem/cpu limits
• Network isolation by default — Docker internal: true + DNS blocked → no outbound traffic from the container
• Auto-detects and blocks /var/run/docker.sock mounts
• All exposed ports bind to 127.0.0.1 only
• .env chmod 600 + enforced in .gitignore + verified
• Backup traversal protection (tar tzf pre-check + --no-same-owner)
• launchd plist permission/owner/absolute-path validation
• git clone --depth 1 + optional OPENCLAW_PIN_COMMIT
• Auto-masks *KEY|*TOKEN|*SECRET|PASSWORD in log output
• gitleaks pre-commit hook + CI scan

📚 Docs

• README.md — Korean (main)
• README.en.md — English (equivalent depth)
• docs/QUICKSTART-ko.md · docs/QUICKSTART-en.md — non-developer step-by-step
• docs/ARCHITECTURE.md, docs/TROUBLESHOOTING.md, docs/CONTRIBUTING.md, SECURITY.md

⚠️ Known limitations

• Official OpenClaw core repo URL is not yet confirmed — you must set OPENCLAW_REPO in .env for the container step to proceed.
• macOS only (no Linux/Windows)
• Reference machine: MacBook Pro 16" M5 Pro / 24GB RAM (Apple Silicon arm64)

🚀 Install

git clone https://github.com/GoGoComputer/openclaw-workspace.git
cd openclaw-workspace/openclaw-mgr
cp .env.example .env
./openclaw            # interactive menu (or: ./openclaw doctor && ./openclaw install)

---

🙏 License

MIT © 2026 박성모 Park Sungmo