From b1a0f94cd6bf8a1c7f06ab3a3972d2d0817ed7df Mon Sep 17 00:00:00 2001
From: oliver <zhoutianjun127@126.com>
Date: Tue, 28 Apr 2026 19:32:45 +0800
Subject: [PATCH] update ops scripts to include weixin by default

Make start/status/stop all scripts include Weixin sidecar by default and add -WithoutWeixin as an explicit opt-out.
Refresh RUNBOOK commands to match the new default behavior.

Made-with: Cursor
---
 docs/RUNBOOK.md                           | 36 +++++++++++++++--------
 runtime/operations/scripts/start_all.ps1  |  4 +--
 runtime/operations/scripts/status_all.ps1 |  4 +--
 runtime/operations/scripts/stop_all.ps1   |  4 +--
 4 files changed, 30 insertions(+), 18 deletions(-)

diff --git a/docs/RUNBOOK.md b/docs/RUNBOOK.md
index 6f09452e..761c738c 100644
--- a/docs/RUNBOOK.md
+++ b/docs/RUNBOOK.md
@@ -142,37 +142,49 @@ Linux/macOS:
 
 `powershell -ExecutionPolicy Bypass -File .\scripts\start_all.ps1 -Background`
 
-（含微信 sidecar）：
+默认即包含微信 sidecar：
 
-`powershell -ExecutionPolicy Bypass -File .\scripts\start_all.ps1 -Background -WithWeixin`
+`powershell -ExecutionPolicy Bypass -File .\scripts\start_all.ps1 -Background`
 
-（含微信 sidecar + wiki worker）：
+不启动微信 sidecar（可选）：
 
-`powershell -ExecutionPolicy Bypass -File .\scripts\start_all.ps1 -Background -WithWeixin -WithWikiWorker`
+`powershell -ExecutionPolicy Bypass -File .\scripts\start_all.ps1 -Background -WithoutWeixin`
+
+（含 wiki worker）：
+
+`powershell -ExecutionPolicy Bypass -File .\scripts\start_all.ps1 -Background -WithWikiWorker`
 
 查看状态：
 
 `powershell -ExecutionPolicy Bypass -File .\scripts\status_all.ps1`
 
-（含微信 sidecar）：
+默认即包含微信 sidecar：
 
-`powershell -ExecutionPolicy Bypass -File .\scripts\status_all.ps1 -WithWeixin`
+`powershell -ExecutionPolicy Bypass -File .\scripts\status_all.ps1`
 
-（含微信 sidecar + wiki worker）：
+不检查微信 sidecar（可选）：
 
-`powershell -ExecutionPolicy Bypass -File .\scripts\status_all.ps1 -WithWeixin -WithWikiWorker`
+`powershell -ExecutionPolicy Bypass -File .\scripts\status_all.ps1 -WithoutWeixin`
+
+（含 wiki worker）：
+
+`powershell -ExecutionPolicy Bypass -File .\scripts\status_all.ps1 -WithWikiWorker`
 
 停止：
 
 `powershell -ExecutionPolicy Bypass -File .\scripts\stop_all.ps1`
 
-（含微信 sidecar）：
+默认即包含微信 sidecar：
 
-`powershell -ExecutionPolicy Bypass -File .\scripts\stop_all.ps1 -WithWeixin`
+`powershell -ExecutionPolicy Bypass -File .\scripts\stop_all.ps1`
 
-（含微信 sidecar + wiki worker）：
+不停止微信 sidecar（可选）：
 
-`powershell -ExecutionPolicy Bypass -File .\scripts\stop_all.ps1 -WithWeixin -WithWikiWorker`
+`powershell -ExecutionPolicy Bypass -File .\scripts\stop_all.ps1 -WithoutWeixin`
+
+（含 wiki worker）：
+
+`powershell -ExecutionPolicy Bypass -File .\scripts\stop_all.ps1 -WithWikiWorker`
 
 说明：
 
diff --git a/runtime/operations/scripts/start_all.ps1 b/runtime/operations/scripts/start_all.ps1
index 65652c20..14292f14 100644
--- a/runtime/operations/scripts/start_all.ps1
+++ b/runtime/operations/scripts/start_all.ps1
@@ -3,7 +3,7 @@
     [int]$Port = 8787,
     [switch]$SkipInstall = $false,
     [switch]$Background = $false,
-    [switch]$WithWeixin = $false,
+    [switch]$WithoutWeixin = $false,
     [bool]$WithWikiWorker = $true,
     [string]$WeixinChannelId = "oclaw-weixin",
     [string]$WeixinGatewayBaseUrl = ""
@@ -37,7 +37,7 @@ if (-not $Background) {
 
 & "$PSScriptRoot/start_desktop.ps1" -SkipInstall:$SkipInstall -Background -WithWikiWorker:$WithWikiWorker
 
-if ($WithWeixin) {
+if (-not $WithoutWeixin) {
     $gwBase = ($WeixinGatewayBaseUrl | ForEach-Object { "$_".Trim() })
     if (-not $gwBase) {
         $gwBase = "http://$BindHost`:$Port"
diff --git a/runtime/operations/scripts/status_all.ps1 b/runtime/operations/scripts/status_all.ps1
index 168bbe1e..4fd68852 100644
--- a/runtime/operations/scripts/status_all.ps1
+++ b/runtime/operations/scripts/status_all.ps1
@@ -1,7 +1,7 @@
 param(
     [string]$BindHost = "127.0.0.1",
     [int]$Port = 8787,
-    [switch]$WithWeixin = $false,
+    [switch]$WithoutWeixin = $false,
     [switch]$WithWikiWorker = $false,
     [string]$WeixinChannelId = "oclaw-weixin"
 )
@@ -118,7 +118,7 @@ try {
     Warn "Get-NetTCPConnection failed: $($_.Exception.Message)"
 }
 
-if ($WithWeixin) {
+if (-not $WithoutWeixin) {
     Write-Host ""
     Write-Step "Weixin sidecar"
     try {
diff --git a/runtime/operations/scripts/stop_all.ps1 b/runtime/operations/scripts/stop_all.ps1
index 97e339ac..b5cda1a9 100644
--- a/runtime/operations/scripts/stop_all.ps1
+++ b/runtime/operations/scripts/stop_all.ps1
@@ -1,7 +1,7 @@
 param(
     [int]$Port = 8787,
     [switch]$Force = $false,
-    [switch]$WithWeixin = $false,
+    [switch]$WithoutWeixin = $false,
     [switch]$WithWikiWorker = $false,
     [string]$WeixinChannelId = "oclaw-weixin"
 )
@@ -26,7 +26,7 @@ try {
     if (-not $Force) { throw }
 }
 
-if ($WithWeixin) {
+if (-not $WithoutWeixin) {
     Write-Step "Stopping weixin sidecar"
     try {
         & "$PSScriptRoot/weixin_stop.ps1" -ChannelId $WeixinChannelId -Force:$Force