fix: 修复多个高优 Issue (#160, #165, #156, #159, #151)

- #160 Gateway 死循環: _autoPairAndReconnect 后不调用 reconnect() 避免重置计数器 - #165 readConfig 未定义: 替换为内联 fs.readFileSync/writeFileSync - #156 systemd PATH: findOpenclawBin 添加 npm 全局路径, systemd 服务注入 PATH - #159 Docker 双容器冲突: 新增 DISABLE_GATEWAY_SPAWN 环境变量开关 - #151 Gateway 检测冲突: linuxCheckGateway 验证进程名, 拒绝操作非 OpenClaw 进程
2026-05-06 20:02:49 +08:00 · 2026-03-30 23:13:24 +08:00
parent 87d7c227d8
commit f5d32c377c
5 changed files with 311 additions and 11 deletions
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -61,6 +61,8 @@ services:
      # OpenClaw Gateway 地址（如果 Gateway 不在本地，修改为实际地址）
      # 注意：host 模式下直接使用 localhost 或 127.0.0.1
      - OPENCLAW_URL=http://127.0.0.1:18789
+      # 双容器模式下禁止面板自动启动 Gateway（取消注释）
+      # - DISABLE_GATEWAY_SPAWN=1
      # 如果需要代理（取消注释并修改为实际代理地址）
      # - HTTP_PROXY=http://host.docker.internal:7890
      # - HTTPS_PROXY=http://host.docker.internal:7890
--- a/docs/github-review-2026-03-30.md
+++ b/docs/github-review-2026-03-30.md
@@ -0,0 +1,266 @@
+# ClawPanel GitHub Issues & PRs 待处理清单
+
+> 生成时间：2026-03-30 | 范围：2026-03-25 ~ 2026-03-30 | 仓库：qingchencloud/clawpanel
+
+---
+
+## 📊 概览
+
+| 类别 | 数量 |
+|------|------|
+| 新 Issues（5天内创建） | 22 个 |
+| 其中 OPEN | 19 个 |
+| 其中 CLOSED | 3 个 |
+| 活跃 PRs（5天内创建） | 3 个 |
+| 有冲突的老 PRs | 4 个 |
+
+---
+
+## 🔴 P0 紧急 — 服务阻塞/无法使用
+
+### Issue #160 — [Bug] 恶性Bug：特定操作导致服务器必定阻塞
+- **状态**: OPEN 🔥 | **标签**: `bug`, `openclaw-processing`
+- **提交者**: yushu200403 | **创建**: 03-27
+- **问题**: 点击"实时聊天"页面的自动修复 Origin 按钮后，ClawPanel 进入无限循环持续尝试访问 Gateway，导致 2C4G 服务器完全阻塞，只能强制重启
+- **环境**: Ubuntu 22.04, v0.10.0
+- **根因推测**: 配置更改后进入无延迟死循环
+- **修复建议**: 检查 Gateway 连接重试逻辑，加退避/上限
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/160
+
+### Issue #151 — [Bug] Gateway 检测错误导致与系统 OpenClaw 冲突不断重启
+- **状态**: OPEN 🔥 | **标签**: `bug`, `openclaw-processing`
+- **提交者**: fakers777 | **创建**: 03-26
+- **问题**: Gateway 检测逻辑错误，ClawPanel 与系统已运行的 OpenClaw 冲突，造成不断重启
+- **环境**: Ubuntu, v0.10.0
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/151
+
+---
+
+## 🟠 P1 高优 — 核心功能故障
+
+### Issue #150 — [Bug] 升级到 0.99 版本后完全打不开 ClawPanel
+- **状态**: OPEN | **标签**: `bug`
+- **提交者**: carlyle168 | **创建**: 03-25
+- **问题**: 从 0.97 一路升级到 0.98/0.99 后 ClawPanel 无法打开，反复安装无效
+- **环境**: Windows 10
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/150
+
+### Issue #165 — fix: Agent 绑定消息渠道保存失败 (readConfig is not defined)
+- **状态**: OPEN | **标签**: `openclaw-processing`
+- **提交者**: jx270417948 | **创建**: 03-28
+- **问题**: Agent 绑定飞书消息渠道时点保存报错 `readConfig is not defined`
+- **环境**: Linux (Ubuntu), v0.10.0, openclaw-lark 2026.3.26
+- **根因**: 代码中引用了未定义的 `readConfig` 函数
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/165
+
+### Issue #159 — [Bug] Docker 双容器找不到 openclaw，单容器把系统搞死
+- **状态**: OPEN | **标签**: `bug`, `openclaw-processing`
+- **提交者**: wanababy | **创建**: 03-27
+- **问题**: Docker 双容器部署时 ClawPanel 找不到 OpenClaw CLI；单容器模式下 ClawPanel 自动拉起 Gateway 与已有进程冲突导致系统崩溃
+- **修复建议**: 需要添加 `DISABLE_LOCAL_GATEWAY_SPAWN` 环境变量开关，或支持纯远程 Gateway 模式
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/159
+
+### Issue #157 — [Bug] 版本问题太多
+- **状态**: OPEN | **标签**: `bug`, `openclaw-processing`
+- **提交者**: lwsg1987 | **创建**: 03-27
+- **问题**: 多个问题集合（综合反馈）：
+  1. 版本过高提示降级，降级后版本号不变
+  2. 安装 skill(summarize) 提示缺依赖，安完后继续提示
+  3. 安装微信插件卡住，手动 CLI 安装后可用但无法识别微信图片
+- **环境**: Ubuntu 24.02, v0.10.0
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/157
+
+### Issue #152 — 无法切换 OpenClaw 版本
+- **状态**: OPEN
+- **提交者**: SEVENTEEN-TAN | **创建**: 03-26
+- **问题**: 版本切换操作失败或无响应
+- **环境**: Windows x86_64, Node.js v22.22.1, OpenClaw 2026.3.24
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/152
+
+---
+
+## 🟡 P2 中等 — 功能缺陷/兼容性
+
+### Issue #166 — 未检测到任何 Skills
+- **状态**: OPEN | **创建**: 03-30 (今天)
+- **提交者**: penghaiqiu1988
+- **问题**: Skills 页面显示"CLI 可用，但返回结果解析失败"，"未检测到任何 Skills"
+- **环境**: v0.10.0, OpenClaw 汉化版 2026.3.24-zh.1
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/166
+
+### Issue #156 — [Bug] Linux Web 模式下 CLI 检测失败（systemd 缺少 PATH）
+- **状态**: OPEN | **创建**: 03-26
+- **提交者**: XIAzhenglin
+- **问题**: `linux-deploy.sh` 部署后面板显示"OpenClaw CLI 未安装"，但终端 `which openclaw` 正常
+- **根因**: systemd 服务配置缺少 PATH 环境变量，npm 全局路径未包含
+- **修复方案已给出**: 
+  - 方案 1: systemd 服务添加 PATH 环境变量
+  - 方案 2: `dev-api.js` 中 `findOpenclawBin()` 补充 npm 全局路径扫描
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/156
+
+### Issue #155 — [Bug] (无标题描述)
+- **状态**: OPEN | **标签**: `bug` | **创建**: 03-26
+- **提交者**: xiaochengshiguduo
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/155
+
+### Issue #154 — [Bug] (无标题描述)
+- **状态**: OPEN | **标签**: `bug` | **创建**: 03-26
+- **提交者**: friendfish
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/154
+
+### Issue #153 — 执行 openclaw devices list 命令失败
+- **状态**: OPEN | **创建**: 03-26
+- **提交者**: caofakun
+- **问题**: 执行 `openclaw devices list` 报错 gateway connect failed (1000 normal closure)，设备配对批准按钮无反应
+- **环境**: Windows, OpenClaw 中文版 2026.3.13
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/153
+
+### Issue #149 — [Bug] Models configured via OAuth not being pulled
+- **状态**: OPEN | **创建**: 03-25
+- **提交者**: adam479
+- **问题**: 通过 OAuth 配置的模型不被 ClawPanel 拉取/显示
+- **根因推测**: OAuth token 未在模型发现接口的请求头中传递
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/149
+
+### Issue #148 — [Bug] AI 助手读取 OpenClaw 配置测试无法联通
+- **状态**: OPEN | **标签**: `bug` | **创建**: 03-25
+- **提交者**: WHHGR
+- **问题**: AI 助手 API 设置中导入 OpenClaw 配置后测试 Failed to fetch，但在 OpenClaw 中可正常使用
+- **环境**: Ubuntu 20.04, v0.9.9
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/148
+
+### Issue #146 — 升级 OpenClaw 后触发重复升级检测
+- **状态**: OPEN | **创建**: 03-25
+- **提交者**: z1a2q3wolf
+- **问题**: 升级完成后每次打开 ClawPanel 仍弹出升级提示
+- **根因**: 版本检测逻辑有误，升级后未正确更新本地缓存版本号
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/146
+
+### Issue #144 — 黑苹果 OpenClaw 未检测到
+- **状态**: OPEN | **标签**: `openclaw-processing` | **创建**: 03-25
+- **提交者**: kof8855
+- **问题**: Hackintosh 环境下 OpenClaw 检测失败
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/144
+
+### Issue #143 — [Bug] Mac 电脑的多版本 Node 选择
+- **状态**: OPEN | **标签**: `bug` | **创建**: 03-25
+- **提交者**: zshaxy
+- **问题**: macOS 多版本 Node.js 环境兼容问题
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/143
+
+### Issue #158 — [Bug] Channel 插件包无法在面板安装
+- **状态**: OPEN | **标签**: `bug` | **创建**: 03-27
+- **提交者**: joeshen2021
+- **问题**: 在 ClawPanel 上安装 channel 插件始终失败，请求支持手动 CLI 安装方式
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/158
+
+---
+
+## 🟢 P3 功能请求
+
+### Issue #147 — feat: 定时器支持自然时间格式输入
+- **状态**: OPEN | **创建**: 03-25
+- **提交者**: z1a2q3wolf
+- **问题**: 希望定时器支持自然语言时间格式（如"每天 8 点"），而非只能用 cron 表达式
+- **链接**: https://github.com/qingchencloud/clawpanel/issues/147
+
+---
+
+## ✅ 已关闭 Issues
+
+| # | 标题 | 关闭原因 |
+|---|------|----------|
+| #145 | 切换项目后仪表盘偶发显示"版本信息未获取" | 已修复 |
+| #142 | Agent 模型配置问题 | 已修复 |
+
+---
+
+## 🔀 待处理 Pull Requests
+
+### PR #163 — feat: upgrade MiniMax provider preset and add model presets ✅可合并
+- **作者**: octo-patch | **创建**: 03-28
+- **分支**: `feature/add-minimax-provider`
+- **状态**: MERGEABLE
+- **变更**: +113/-2 | 4 文件
+- **内容**:
+  - 修复 MiniMax API 地址从弃用的 `api.minimax.chat` 更新为 `api.minimax.io`
+  - 添加 M2.7, M2.7-highspeed (1M上下文), M2.5, M2.5-highspeed 模型预设
+  - 更新 README 中英文版本
+  - 12 个单测覆盖
+- **评估**: 质量良好，有测试，建议合并 ✅
+- **链接**: https://github.com/qingchencloud/clawpanel/pull/163
+
+### PR #162 — 修复记忆文件菜单显示问题 ⚠️需审查
+- **作者**: roc-xie | **创建**: 03-28
+- **分支**: `develop`
+- **状态**: MERGEABLE
+- **变更**: +141/-93 | 1 文件 (`scripts/dev-api.js`)
+- **内容**:
+  - 修复工作记忆/记忆归档/核心文件创建后不显示
+  - 对齐 Tab 目录路径
+  - 递归搜索子目录并支持更多文件扩展名
+  - 修复 Agent 工作区路径
+- **评估**: 功能修复有价值，但需检查文件路径变更是否影响其他功能 ⚠️
+- **链接**: https://github.com/qingchencloud/clawpanel/pull/162
+
+### PR #161 — fix: 重构版本源检测逻辑 + standalone 目录集中化 + Linux 平台检测补全 ⚠️需审查
+- **作者**: SEVENTEEN-TAN | **创建**: 03-28
+- **分支**: `fix/version-detection-and-standalone`
+- **状态**: MERGEABLE
+- **变更**: +252/-80 | 8 文件 (Rust + JS)
+- **内容**:
+  - 新增 Windows `.cmd` shim 文件检测判断 npm 包归属
+  - `all_standalone_dirs()` 集中化消除 6 处硬编码
+  - Linux 平台检测补全至与 macOS/Windows 同等完整
+  - 前端三源显示（官方/汉化/未知来源）
+  - 跨源切换时清理 standalone 残留
+- **评估**: 改动较大，直接解决 #146 #150 #152 等版本检测问题，需仔细 Review ⚠️
+- **链接**: https://github.com/qingchencloud/clawpanel/pull/161
+
+### 有冲突的老 PRs（需决策处理）
+
+| # | 标题 | 作者 | 状态 |
+|---|------|------|------|
+| #130 | docs: add Japanese README | eltociear | CONFLICTING — 已有 README.ja.md，可关闭 |
+| #129 | feat: 消息渠道多账号支持与 Agent 绑定展示 | 0xsline | CONFLICTING — 功能有价值，需 rebase |
+| #115 | feat: improve dashboard, skills, sidebar, cloudflared | kiss-kedaya | CONFLICTING — 大改动，需确认是否还需要 |
+| #101 | feat: chat virtual scroll | kiss-kedaya | CONFLICTING — 虚拟滚动，需确认 |
+
+---
+
+## 📋 建议处理优先级
+
+### 🎯 立即处理
+1. **PR #163** → Review 后合并（MiniMax 修复，质量好）
+2. **PR #161** → 重点 Review（解决一大批版本检测 bug: #146 #150 #152）
+3. **Issue #160** → P0 修复 Gateway 连接死循环导致服务器阻塞
+
+### ⏳ 本周处理
+4. **PR #162** → Review 记忆文件显示修复
+5. **Issue #165** → 修复 `readConfig is not defined` 错误
+6. **Issue #156** → systemd PATH 问题修复
+7. **Issue #159/#151** → Docker 部署模式 + Gateway 冲突，考虑加环境变量开关
+8. **Issue #166** → Skills 检测失败（今天新报的）
+
+### 📝 待排期
+9. **Issue #149** → OAuth 模型拉取
+10. **Issue #148** → AI 助手 API 联通
+11. **Issue #147** → 自然时间格式（功能需求）
+12. 关闭/整理冲突 PRs (#130 #129 #115 #101)
+
+---
+
+## 🔢 按模块归类
+
+| 模块 | 相关 Issues |
+|------|------------|
+| **版本检测/升级** | #150 #152 #146 #157 |
+| **Gateway/服务管理** | #160 #151 #159 |
+| **Skills 管理** | #166 #157 |
+| **Docker 部署** | #159 |
+| **Linux 部署** | #156 |
+| **消息渠道/插件** | #165 #158 |
+| **AI 助手** | #148 |
+| **设备管理** | #153 |
+| **OAuth/模型** | #149 |
+| **Mac 兼容性** | #144 #143 |
--- a/scripts/dev-api.js
+++ b/scripts/dev-api.js
@@ -1089,6 +1089,9 @@ function findOpenclawBin() {
    '/usr/bin/openclaw',
    '/snap/bin/openclaw',
    path.join(home, '.local/bin/openclaw'),
+    // npm 全局安装路径（修复 #156：systemd 服务缺少 PATH 时 which 失败）
+    path.join(home, '.npm-global/bin/openclaw'),
+    path.join(home, '.npm/bin/openclaw'),
  ]

  // nvm
@@ -1141,8 +1144,19 @@ function linuxCheckGateway() {
  try {
    const out = execSync(`ss -tlnp 'sport = :${port}' 2>/dev/null`, { timeout: 3000 }).toString().trim()
    const pidMatch = out.match(/pid=(\d+)/)
-    if (pidMatch) return { running: true, pid: parseInt(pidMatch[1]) }
-    if (out.includes(`:${port}`)) return { running: true, pid: null }
+    if (pidMatch) {
+      const pid = parseInt(pidMatch[1])
+      // 修复 #151: 验证进程是否是 OpenClaw，避免与其他占用同端口的程序冲突
+      let isOpenClaw = false
+      try {
+        const cmdline = fs.readFileSync(`/proc/${pid}/cmdline`, 'utf8').replace(/\0/g, ' ')
+        isOpenClaw = /openclaw/i.test(cmdline)
+      } catch {
+        isOpenClaw = true // 无法读取进程信息时保守认为是
+      }
+      return { running: true, pid, manageable: isOpenClaw }
+    }
+    if (out.includes(`:${port}`)) return { running: true, pid: null, manageable: false }
  } catch {}
  // fallback: lsof
  try {
@@ -1182,8 +1196,10 @@ function linuxStartGateway() {
 }

 function linuxStopGateway() {
-  const { running, pid } = linuxCheckGateway()
+  const { running, pid, manageable } = linuxCheckGateway()
  if (!running || !pid) throw new Error('Gateway 未运行')
+  // 修复 #151: 检测到非 OpenClaw 进程占用端口时拒绝操作
+  if (manageable === false) throw new Error(`端口已被其他进程 (PID ${pid}) 占用，无法操作`)
  try {
    process.kill(pid, 'SIGTERM')
  } catch (e) {
@@ -1597,6 +1613,10 @@ const handlers = {
  },

  start_service({ label }) {
+    // 修复 #159: Docker 双容器模式下禁止本地启动 Gateway
+    if (process.env.DISABLE_GATEWAY_SPAWN === '1' || process.env.DISABLE_GATEWAY_SPAWN === 'true') {
+      throw new Error('本地 Gateway 启动已禁用（DISABLE_GATEWAY_SPAWN=1），请使用远程 Gateway')
+    }
    if (isMac) { macStartService(label); return true }
    if (isLinux) { linuxStartGateway(); return true }
    winStartGateway()
@@ -1633,6 +1653,9 @@ const handlers = {
  },

  reload_gateway() {
+    if (process.env.DISABLE_GATEWAY_SPAWN === '1' || process.env.DISABLE_GATEWAY_SPAWN === 'true') {
+      throw new Error('本地 Gateway 启动已禁用（DISABLE_GATEWAY_SPAWN=1）')
+    }
    if (isMac) {
      macRestartService('ai.openclaw.gateway')
      return 'Gateway 已重启'
@@ -1646,6 +1669,9 @@ const handlers = {
  },

  restart_gateway() {
+    if (process.env.DISABLE_GATEWAY_SPAWN === '1' || process.env.DISABLE_GATEWAY_SPAWN === 'true') {
+      throw new Error('本地 Gateway 启动已禁用（DISABLE_GATEWAY_SPAWN=1）')
+    }
    if (isMac) {
      macRestartService('ai.openclaw.gateway')
      return 'Gateway 已重启'
@@ -3195,13 +3221,13 @@ const handlers = {

  // Agent 渠道绑定管理
  list_all_bindings() {
-    const cfg = readConfig()
+    const cfg = fs.existsSync(CONFIG_PATH) ? JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')) : {}
    const bindings = cfg.bindings || []
    return { bindings }
  },

  save_agent_binding({ agentId, channel, accountId, bindingConfig }) {
-    const cfg = readConfig()
+    const cfg = fs.existsSync(CONFIG_PATH) ? JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')) : {}
    if (!cfg.bindings) cfg.bindings = []
    const bindings = cfg.bindings

@@ -3240,12 +3266,12 @@ const handlers = {
      bindings.push(newBinding)
    }

-    saveConfig(cfg)
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2))
    return { ok: true }
  },

  delete_agent_binding({ agentId, channel, accountId }) {
-    const cfg = readConfig()
+    const cfg = fs.existsSync(CONFIG_PATH) ? JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')) : {}
    if (!cfg.bindings) cfg.bindings = []
    const bindings = cfg.bindings
    const accountKey = accountId || ''
@@ -3258,7 +3284,7 @@ const handlers = {
      return existingAccount !== accountKey
    })

-    saveConfig(cfg)
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2))
    return { ok: true, removed: before - cfg.bindings.length }
  },

--- a/scripts/linux-deploy.sh
+++ b/scripts/linux-deploy.sh
@@ -254,6 +254,7 @@ Restart=on-failure
 RestartSec=5
 Environment=NODE_ENV=production
 Environment=HOME=$HOME
+Environment=PATH=$HOME/.npm-global/bin:$HOME/.local/bin:$HOME/.volta/bin:$(dirname $(which node)):$PATH

 [Install]
 WantedBy=multi-user.target
@@ -275,6 +276,7 @@ Restart=on-failure
 RestartSec=5
 Environment=NODE_ENV=production
 Environment=HOME=$HOME
+Environment=PATH=$HOME/.npm-global/bin:$HOME/.local/bin:$HOME/.volta/bin:$(dirname $(which node)):$PATH

 [Install]
 WantedBy=default.target
--- a/src/lib/ws-client.js
+++ b/src/lib/ws-client.js
@@ -324,12 +324,16 @@ export class WsClient {
        console.warn('[ws] reloadGateway 失败（非致命）:', e)
      }

-      console.log('[ws] 配对成功，2秒后重新连接...')
+      // 修复 #160: 不调用 reconnect()（它会重置 _autoPairAttempts 导致无限循环），
+      // 而是直接重连一次。如果仍然失败，_autoPairAttempts 不会被重置，不会再次触发自动修复。
+      console.log('[ws] 配对成功，3秒后重新连接...')
      setTimeout(() => {
        if (!this._intentionalClose) {
-          this.reconnect()
+          this._reconnectAttempts = 0
+          this._closeWs()
+          this._doConnect()
        }
-      }, 2000)
+      }, 3000)
    } catch (e) {
      console.error('[ws] 自动配对失败:', e)
      this._setConnected(false, 'error', `配对失败: ${e}`)