From 048e8ec1c1de3cb1207f161401b8dfb72afd5c20 Mon Sep 17 00:00:00 2001
From: oliver <zhoutianjun127@126.com>
Date: Tue, 28 Apr 2026 23:01:43 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=BC=80=E6=BA=90=E6=9E=81?=
 =?UTF-8?q?=E7=AE=80=E5=AE=89=E8=A3=85=E6=96=87=E6=A1=A3=EF=BC=8C=E5=B9=B6?=
 =?UTF-8?q?=E5=9C=A8=20README=20=E5=A2=9E=E5=8A=A0=E5=85=A5=E5=8F=A3?=
 =?UTF-8?q?=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

为首次使用者提供最短启动路径（仅 Web/Admin、微信、WhatsApp），降低开源部署门槛并减少安装误解。

Made-with: Cursor
---
 README.md                      |  2 +
 docs/OPEN_SOURCE_QUICKSTART.md | 94 ++++++++++++++++++++++++++++++++++
 2 files changed, 96 insertions(+)
 create mode 100644 docs/OPEN_SOURCE_QUICKSTART.md

diff --git a/README.md b/README.md
index 0e97bdb6..8812e0e1 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,8 @@ Notes:
 
 Full runbook (recommended): see `docs/RUNBOOK.md` → “开源快速安装（从零到跑起来）”.
 
+Minimal onboarding guide: `docs/OPEN_SOURCE_QUICKSTART.md`.
+
 ## Layers
 - `runtime/`: core execution loop, routing, skill runtime, hook runtime
 - `interfaces/`: transport adapters (HTTP/WS)
diff --git a/docs/OPEN_SOURCE_QUICKSTART.md b/docs/OPEN_SOURCE_QUICKSTART.md
new file mode 100644
index 00000000..0449ac4b
--- /dev/null
+++ b/docs/OPEN_SOURCE_QUICKSTART.md
@@ -0,0 +1,94 @@
+# Open Source Quickstart (Windows)
+
+This guide is the shortest path for first-time users.
+
+## Prerequisites
+
+- Python 3.11+
+- Node.js 22+
+- PowerShell (Windows 10/11)
+
+## Path A: Web/Admin only (no Weixin/WhatsApp required)
+
+1) Bootstrap Python venv:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\scripts\bootstrap_venv.ps1
+```
+
+2) Start full stack in background:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\scripts\start_all.ps1 -Background
+```
+
+3) Open:
+
+- Admin: `http://127.0.0.1:8787/admin`
+- Chat: `http://127.0.0.1:8787/chat`
+
+Notes:
+
+- If Weixin/WhatsApp sidecars are not installed, `start_all.ps1` will skip them with a warning and continue.
+- This does not block Admin/Chat.
+
+## Path B: Enable Weixin (Personal WeChat)
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\weixin_install.ps1 -UseOpenclawCli
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\weixin_login.ps1
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\weixin_start.ps1
+```
+
+Notes:
+
+- No global `openclaw` CLI installation is required.
+- Runtime dependencies are installed locally in sidecar workspace.
+
+## Path C: Enable WhatsApp (experimental)
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\whatsapp_install.ps1
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\whatsapp_login.ps1
+powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\whatsapp_start.ps1
+```
+
+## Admin dispatch controls (Weixin/WhatsApp)
+
+In Admin:
+
+- `Stack` page: channel-level controls (`Bind specialist` / `Comprehensive`)
+- `User/Channel binding` page: account-level controls per channel/account
+
+Priority:
+
+1. Account-level dispatch config
+2. Channel-level dispatch config
+3. Default (`expert + generalist`)
+
+## Common commands
+
+Start:
+
+```powershell
+.\scripts\start_all.ps1 -Background
+```
+
+Status:
+
+```powershell
+.\scripts\status_all.ps1
+```
+
+Stop:
+
+```powershell
+.\scripts\stop_all.ps1
+```
+
+Force stop:
+
+```powershell
+.\scripts\stop_all.ps1 -Force
+```
+