From dbbd817fd6cadc1e39a1867be9c048eb3b3fd9c7 Mon Sep 17 00:00:00 2001 From: YIOYIO <202501123+YIOYIOIOI@users.noreply.github.com> Date: Thu, 26 Mar 2026 21:10:11 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20Windows=20=E5=AE=89=E8=A3=85/=E5=90=8C?= =?UTF-8?q?=E6=AD=A5/=E7=9C=8B=E6=9D=BF=20Gateway=20=E5=85=BC=E5=AE=B9?= =?UTF-8?q?=E6=80=A7=E4=BF=AE=E5=A4=8D=20(#203)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: cft0808 <41196455+cft0808@users.noreply.github.com> --- WINDOWS_INSTALL_CN.md | 283 +++++++++++++++++++++++++++++++++++ agents.json | 101 +++++++++++++ dashboard/server.py | 28 +++- scripts/sync_agent_config.py | 4 +- scripts/utils.py | 2 +- 5 files changed, 407 insertions(+), 11 deletions(-) create mode 100644 WINDOWS_INSTALL_CN.md create mode 100644 agents.json diff --git a/WINDOWS_INSTALL_CN.md b/WINDOWS_INSTALL_CN.md new file mode 100644 index 0000000..9ee293d --- /dev/null +++ b/WINDOWS_INSTALL_CN.md @@ -0,0 +1,283 @@ +# 三省六部 Windows 安装说明（简明版 + 详细版） + +> 适用于 Windows 用户。本文默认你下载的是**已经包含 Windows 兼容修复**的版本，因此不需要再手动改 Python 文件。 + +--- + +# 一、最简单版本：照着做就能装 + +## 1. 下载项目 +把项目放到你自己的 OpenClaw workspace 里，例如： + +```text +C:\Users\\.openclaw\workspace\skills\edict +``` + +> 你实际目录名可以不是 `edict`，但后面命令里的路径要对应修改。 + +--- + +## 2. 如果以前装过旧版本，先删除旧链接 +如果你之前已经安装过旧版三省六部，请先检查并删除这些目录里的旧 `data` / `scripts` 链接： + +```text +C:\Users\\.openclaw\workspace-taizi +C:\Users\\.openclaw\workspace-zhongshu +C:\Users\\.openclaw\workspace-menxia +C:\Users\\.openclaw\workspace-shangshu +C:\Users\\.openclaw\workspace-hubu +C:\Users\\.openclaw\workspace-libu +C:\Users\\.openclaw\workspace-bingbu +C:\Users\\.openclaw\workspace-xingbu +C:\Users\\.openclaw\workspace-gongbu +C:\Users\\.openclaw\workspace-libu_hr +C:\Users\\.openclaw\workspace-zaochao +``` + +重点删除里面已有的： + +- `data` +- `scripts` + +如果不清理旧链接，第一次运行安装脚本时，可能会因为“链接已经存在”而失败。 + +--- + +## 3. 运行安装脚本 +在 PowerShell 里进入项目目录： + +```powershell +cd C:\Users\\.openclaw\workspace\skills\edict +powershell -ExecutionPolicy Bypass -File .\install.ps1 +``` + +--- + +## 4. 安装后检查两件事 + +### A. 检查 agent / subagent 配置是否写进 `openclaw.json` +安装脚本正常情况下会写入，但建议你安装后自己确认一次。 + +如果没有正确写进去，可以参考本仓库附带的 `agents.json` 脱敏模板。使用时请先把其中的 `` 替换成你自己的系统用户名，再复制到对应配置中。 + +### B. 检查 `tools.sessions.visibility = all` +安装脚本会尝试设置，但建议你手动确认一次。 + +如果没有生效，执行： + +```powershell +openclaw config set tools.sessions.visibility all +``` + +--- + +## 5. 启动后台刷新循环 +在 Git Bash / MINGW64 里运行： + +```bash +cd ~/.openclaw/workspace/skills/edict/scripts +bash run_loop.sh +``` + +> 这个脚本负责后台持续刷新数据。 + +--- + +## 6. 启动 dashboard +在 PowerShell 里运行： + +```powershell +cd C:\Users\\.openclaw\workspace\skills\edict +python dashboard\server.py +``` + +然后浏览器打开： + +```text +http://127.0.0.1:7891 +``` + +--- + +# 二、安装完成后你应该看到什么 + +正常情况下： + +- 面板可以打开 +- `官员总览` 能显示三省六部官员信息 +- `模型配置` 能显示 agent 列表 +- 右上角 Gateway 状态正常 +- 倒计时会持续刷新页面数据 + +--- + +# 三、详细说明 + +## 1. 为什么要先删旧链接 + +如果你以前已经安装过旧版本，那么： + +- `workspace-*\data` +- `workspace-*\scripts` + +很可能还指向旧仓库。 + +这时你再运行新的 `install.ps1`，第一次可能出现： + +- symlink / junction 创建失败 +- 安装脚本看起来跑完了，但实际 workspace 仍然连着旧版本 + +所以最稳妥的做法是： + +## 先删旧链接，再运行安装脚本 + +--- + +## 2. 为什么安装后还要核对 agent / subagent 配置 + +在部分环境里，安装脚本可能没有把三省六部的 agent 配置完整落进 `openclaw.json`。 + +因此建议你安装后主动确认： + +- `taizi` +- `zhongshu` +- `menxia` +- `shangshu` +- `hubu` +- `libu` +- `bingbu` +- `xingbu` +- `gongbu` +- `libu_hr` +- `zaochao` + +这些 agent 是否都存在，且 `subagents.allowAgents` 是否正确。 + +如果缺失，可以直接参考本仓库附带的 `agents.json` 脱敏模板；使用前请先把 `` 替换成你自己的系统用户名。 + +--- + +## 3. `agents.json` 是干什么用的\r\n\r\n本仓库附带了一个脱敏版的：\r\n\r\n```text\r\nagents.json\r\n```\r\n\r\n它保留了三省六部 agent 的配置结构，包括：\r\n\r\n- `id`\r\n- `name`\r\n- `workspace`\r\n- `agentDir`\r\n- `subagents.allowAgents`\r\n\r\n其中路径部分已经用 `` 做了脱敏处理。\r\n\r\n使用时请先把：\r\n\r\n```text\r\n\r\n```\r\n\r\n替换成你自己的 Windows 用户名，再复制到对应配置中。\r\n\r\n---\r\n\r\n## 4. 为什么还要确认 `tools.sessions.visibility = all` + +这个设置会影响 session 工具可见性，对多 agent 协同很重要。 + +虽然安装脚本会尝试设置，但建议安装后自己再确认一次。 + +如果没生效，手动执行： + +```powershell +openclaw config set tools.sessions.visibility all +``` + +--- + +## 5. 为什么还要跑 `run_loop.sh` + +dashboard 右上角虽然有一个 5 秒倒计时，但它只是： + +- 每 5 秒重新读取一次现有 API 数据 + +它并不会自动帮你在后台持续生成数据。 + +真正负责后台数据刷新的是： + +```bash +bash run_loop.sh +``` + +它会持续执行同步脚本，更新： + +- `live_status.json` +- `officials_stats.json` +- `agent_config.json` + +所以： + +- dashboard 倒计时 = **读数据** +- `run_loop.sh` = **产数据 / 刷数据** + +Windows 下也建议正常运行 `run_loop.sh`。 + +--- + +## 6. 如果 dashboard 提示“请先启动服务器”怎么办 + +这句文案有时是误导性的。它不一定表示 `dashboard/server.py` 真没启动。 + +更常见的真实原因是： + +- API 返回了空对象 +- 读取到了旧仓库的数据 +- 当前启动的不是你想要的那个 dashboard server + +排查时建议直接访问： + +```text +http://127.0.0.1:7891/api/officials-stats +http://127.0.0.1:7891/api/agent-config +http://127.0.0.1:7891/api/live-status +``` + +如果这三个接口能正常返回 JSON，说明 server 没问题。 + +--- + +## 7. 如果 dashboard 提示 Gateway 没启动怎么办 + +如果你使用的是本修复版，这个问题应该已经被修好。 + +之前在 Windows 上误报的原因是 dashboard 的 Gateway 检测逻辑偏 Linux。修复后已改为优先使用端口 / probe 检测。 + +所以如果你仍然看到 Gateway 未启动： + +- 先确认自己现在运行的是修复后的 `dashboard/server.py` +- 再确认浏览器访问的不是旧的本地 server 进程 + +--- + +# 四、推荐的完整使用顺序 + +## 第一步 +清理旧 `workspace-*` 里的 `data` / `scripts` + +## 第二步 +运行： + +```powershell +powershell -ExecutionPolicy Bypass -File .\install.ps1 +``` + +## 第三步 +检查： + +- agent / subagent 配置 +- `tools.sessions.visibility = all` + +必要时可参考： + +```text +agents.json +``` + +## 第四步 +启动后台刷新循环： + +```bash +bash run_loop.sh +``` + +## 第五步 +启动 dashboard： + +```powershell +python dashboard\server.py +``` + +--- + +# 五、一句话总结 + +## Windows 用户最稳的做法就是： +先清旧链接，再运行安装脚本；安装后检查 agent 配置和 `tools.sessions.visibility = all`；如有需要可参考 `agents.json` 脱敏模板并替换 ``；最后启动 `run_loop.sh` 和 `dashboard/server.py`。 + + diff --git a/agents.json b/agents.json new file mode 100644 index 0000000..e757941 --- /dev/null +++ b/agents.json @@ -0,0 +1,101 @@ +[ + { + "id": "taizi", + "name": "taizi", + "workspace": "C:\\Users\\\\.openclaw\\workspace-taizi", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\taizi\\agent", + "subagents": { + "allowAgents": ["zhongshu"] + } + }, + { + "id": "zhongshu", + "name": "zhongshu", + "workspace": "C:\\Users\\\\.openclaw\\workspace-zhongshu", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\zhongshu\\agent", + "subagents": { + "allowAgents": ["menxia", "shangshu"] + } + }, + { + "id": "menxia", + "name": "menxia", + "workspace": "C:\\Users\\\\.openclaw\\workspace-menxia", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\menxia\\agent", + "subagents": { + "allowAgents": ["shangshu", "zhongshu"] + } + }, + { + "id": "shangshu", + "name": "shangshu", + "workspace": "C:\\Users\\\\.openclaw\\workspace-shangshu", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\shangshu\\agent", + "subagents": { + "allowAgents": ["zhongshu", "menxia", "hubu", "libu", "bingbu", "xingbu", "gongbu", "libu_hr"] + } + }, + { + "id": "hubu", + "name": "hubu", + "workspace": "C:\\Users\\\\.openclaw\\workspace-hubu", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\hubu\\agent", + "subagents": { + "allowAgents": ["shangshu"] + } + }, + { + "id": "libu", + "name": "libu", + "workspace": "C:\\Users\\\\.openclaw\\workspace-libu", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\libu\\agent", + "subagents": { + "allowAgents": ["shangshu"] + } + }, + { + "id": "bingbu", + "name": "bingbu", + "workspace": "C:\\Users\\\\.openclaw\\workspace-bingbu", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\bingbu\\agent", + "subagents": { + "allowAgents": ["shangshu"] + } + }, + { + "id": "xingbu", + "name": "xingbu", + "workspace": "C:\\Users\\\\.openclaw\\workspace-xingbu", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\xingbu\\agent", + "subagents": { + "allowAgents": ["shangshu"] + } + }, + { + "id": "gongbu", + "name": "gongbu", + "workspace": "C:\\Users\\\\.openclaw\\workspace-gongbu", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\gongbu\\agent", + "subagents": { + "allowAgents": ["shangshu"] + } + }, + { + "id": "libu_hr", + "name": "libu_hr", + "workspace": "C:\\Users\\\\.openclaw\\workspace-libu_hr", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\libu_hr\\agent", + "subagents": { + "allowAgents": ["shangshu"] + } + }, + { + "id": "zaochao", + "name": "zaochao", + "workspace": "C:\\Users\\\\.openclaw\\workspace-zaochao", + "agentDir": "C:\\Users\\\\.openclaw\\agents\\zaochao\\agent", + "subagents": { + "allowAgents": [] + } + } +] diff --git a/dashboard/server.py b/dashboard/server.py index 79f321e..87b67b2 100644 --- a/dashboard/server.py +++ b/dashboard/server.py @@ -11,7 +11,7 @@ Endpoints: GET /api/model-change-log → data/model_change_log.json GET /api/last-result → data/last_model_change_result.json """ -import json, pathlib, subprocess, sys, threading, argparse, datetime, logging, re, os +import json, pathlib, subprocess, sys, threading, argparse, datetime, logging, re, os, socket from http.server import BaseHTTPRequestHandler, HTTPServer from urllib.parse import urlparse from urllib.request import Request, urlopen @@ -667,8 +667,17 @@ _AGENT_DEPTS = [ def _check_gateway_alive(): - """检测 Gateway 进程是否在运行。""" + """检测 Gateway 是否在运行。 + + Windows 上不要依赖 pgrep；优先通过本地端口探测判断。 + """ + if _check_gateway_probe(): + return True try: + if os.name == 'nt': + with socket.create_connection(('127.0.0.1', 18789), timeout=2): + return True + return False result = subprocess.run(['pgrep', '-f', 'openclaw-gateway'], capture_output=True, text=True, timeout=5) return result.returncode == 0 @@ -678,12 +687,15 @@ def _check_gateway_alive(): def _check_gateway_probe(): """通过 HTTP probe 检测 Gateway 是否响应。""" - try: - from urllib.request import urlopen - resp = urlopen('http://127.0.0.1:18789/', timeout=3) - return resp.status == 200 - except Exception: - return False + for url in ('http://127.0.0.1:18789/', 'http://127.0.0.1:18789/healthz'): + try: + from urllib.request import urlopen + resp = urlopen(url, timeout=3) + if 200 <= resp.status < 500: + return True + except Exception: + continue + return False def _get_agent_session_status(agent_id): diff --git a/scripts/sync_agent_config.py b/scripts/sync_agent_config.py index 6e09d39..44892a7 100644 --- a/scripts/sync_agent_config.py +++ b/scripts/sync_agent_config.py @@ -110,7 +110,7 @@ def _collect_openclaw_models(cfg): def main(): cfg = {} try: - cfg = json.loads(OPENCLAW_CFG.read_text()) + cfg = json.loads(OPENCLAW_CFG.read_text(encoding='utf-8')) except Exception as e: log.warning(f'cannot read openclaw.json: {e}') return @@ -174,7 +174,7 @@ def main(): cfg_path = DATA / 'agent_config.json' if cfg_path.exists(): try: - existing_cfg = json.loads(cfg_path.read_text()) + existing_cfg = json.loads(cfg_path.read_text(encoding='utf-8')) except Exception: pass diff --git a/scripts/utils.py b/scripts/utils.py index 4155c5d..4ee1572 100644 --- a/scripts/utils.py +++ b/scripts/utils.py @@ -9,7 +9,7 @@ import json, pathlib, datetime def read_json(path, default=None): """安全读取 JSON 文件，失败返回 default""" try: - return json.loads(pathlib.Path(path).read_text()) + return json.loads(pathlib.Path(path).read_text(encoding='utf-8')) except Exception: return default if default is not None else {}