OpenClaw Dashboard 技能

启动并管理 OpenClaw Dashboard 网页界面，用于监控您的所有 bots、agents、models 和 sessions。

激活条件

当用户说出以下任一指令时激活：

• "打开 OpenClaw-bot-review"
• "打开 Openclaw dashboard"
• "打开 bot review"
• "打开机器人大盘"
• "打开 bot-review"
• "打开openclaw机器人大盘"
• "open openclaw dashboard"
• "open OpenClaw-bot-review"
• "open bot review"
• "open bot-review"
• "launch bot review"
• "start dashboard"

该技能的功能

1. 检测操作系统（macOS / Windows）
2. 检查是否已安装 git
3. 若项目尚未存在，则下载或克隆 OpenClaw Dashboard 项目
4. 安装依赖（执行 npm install）
5. 在后台启动开发服务器
6. 向用户返回访问地址 URL

安装目录

• macOS/Linux: ~/projects/OpenClaw-bot-review/
• Windows: %USERPROFILE%projectsOpenClaw-bot-review

前提条件

• 必须已安装 Node.js 18+
• 需存在 OpenClaw 配置文件：~/.openclaw/openclaw.json（Windows 下为 %USERPROFILE%.openclawopenclaw.json）

工作流程

步骤 1：检查服务是否已在运行，如是则先停止

# 检查端口 3000 上是否有进程正在运行
# macOS/Linux
lsof -ti:3000

# Windows
netstat -ano | findstr :3000

若已运行：

• 首先停止服务（确保干净重启）

macOS/Linux：

lsof -ti:3000 | xargs kill -9 2>/dev/null
echo "已停止旧服务"

Windows（PowerShell）：

Get-Process -Id (Get-NetTCPConnection -LocalPort 3000).OwningProcess | Stop-Process -Force
Write-Host "已停止旧服务"

Windows（cmd）：

for /f "tokens=5" %a in ('netstat -ano ^| findstr :3000') do taskkill /F /PID %a
echo 已停止旧服务

然后进入步骤 1.5。

步骤 1.5：检查更新（仅当项目已存在时）

若项目已存在，检查是否存在新版本：

若已安装 git：

# macOS/Linux
cd ~/projects/OpenClaw-bot-review
git fetch origin main 2>/dev/null
LOCAL=$(git rev-parse HEAD 2>/dev/null)
REMOTE=$(git rev-parse origin/main 2>/dev/null)

if [ "$LOCAL" != "$REMOTE" ]; then
  echo "update_available"
else
  echo "up_to_date"
fi

# Windows（PowerShell）
cd "$env:USERPROFILEprojectsOpenClaw-bot-review"
git fetch origin main 2>$null
$local = git rev-parse HEAD 2>$null
$remote = git rev-parse origin/main 2>$null
if ($local -ne $remote) { "update_available" } else { "up_to_date" }

若检测到更新：

• 提示用户：“检测到新版本，正在更新...”
• 拉取最新代码：git pull origin main
• 重新安装依赖：npm install
• 继续执行步骤 5（启动服务）

若已是最新版本：

• 直接进入步骤 5（启动服务）

若未安装 git：

• 提示用户：“检测到项目无 git 管理，正在重新下载最新版本...”
• 删除旧项目目录：

  # macOS/Linux
  rm -rf ~/projects/OpenClaw-bot-review
  
  # Windows（PowerShell）
  Remove-Item -Recurse -Force "$env:USERPROFILEprojectsOpenClaw-bot-review"
  

• 跳转至步骤 3（通过 ZIP 方式下载项目）

步骤 2：检查项目是否存在

# macOS/Linux
test -d ~/projects/OpenClaw-bot-review && echo "exists" || echo "not found"

# Windows（PowerShell）
Test-Path "$env:USERPROFILEprojectsOpenClaw-bot-review"

若存在，跳过后续下载步骤，直接进入步骤 4。

步骤 3：下载项目

选项 A：使用 git（推荐）

# macOS/Linux
mkdir -p ~/projects
cd ~/projects
git clone https://github.com/xmanrui/OpenClaw-bot-review.git

# Windows（PowerShell）
New-Item -ItemType Directory -Force -Path "$env:USERPROFILEprojects"
cd "$env:USERPROFILEprojects"
git clone https://github.com/xmanrui/OpenClaw-bot-review.git

选项 B：不使用 git（备用方案）

macOS/Linux：

mkdir -p ~/projects
cd ~/projects
curl -L https://github.com/xmanrui/OpenClaw-bot-review/archive/refs/heads/main.zip -o openclaw-dashboard.zip
unzip openclaw-dashboard.zip
mv OpenClaw-bot-review-main OpenClaw-bot-review
rm openclaw-dashboard.zip

Windows（PowerShell）：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILEprojects"
cd "$env:USERPROFILEprojects"
Invoke-WebRequest -Uri "https://github.com/xmanrui/OpenClaw-bot-review/archive/refs/heads/main.zip" -OutFile "openclaw-dashboard.zip"
Expand-Archive -Path "openclaw-dashboard.zip" -DestinationPath "."
Rename-Item -Path "OpenClaw-bot-review-main" -NewName "OpenClaw-bot-review"
Remove-Item "openclaw-dashboard.zip"

Windows（cmd，Windows 10+ 自带 curl）：

mkdir "%USERPROFILE%projects" 2>nul
cd /d "%USERPROFILE%projects"
curl -L https://github.com/xmanrui/OpenClaw-bot-review/archive/refs/heads/main.zip -o openclaw-dashboard.zip
tar -xf openclaw-dashboard.zip
ren OpenClaw-bot-review-main OpenClaw-bot-review
del openclaw-dashboard.zip

步骤 4：安装依赖（如尚未安装）

检查 node_modules 目录是否存在。若不存在：

# macOS/Linux
cd ~/projects/OpenClaw-bot-review
npm install

# Windows
cd "%USERPROFILE%projectsOpenClaw-bot-review"
npm install

步骤 5：启动服务

macOS/Linux：

cd ~/projects/OpenClaw-bot-review
npm run dev > /dev/null 2>&1 &

Windows（PowerShell）：

cd "$env:USERPROFILEprojectsOpenClaw-bot-review"
Start-Process -NoNewWindow -FilePath "npm" -ArgumentList "run", "dev"

Windows（cmd）：

cd /d "%USERPROFILE%projectsOpenClaw-bot-review"
start /B npm run dev

步骤 6：等待服务就绪

轮询 http://localhost:3000，直至响应成功（最长等待 30 秒）。

# macOS/Linux
for i in {1..30}; do
  curl -s http://localhost:3000 > /dev/null && break
  sleep 1
done

# Windows（PowerShell）
for ($i=0; $i -lt 30; $i++) {
  try {
    Invoke-WebRequest -Uri "http://localhost:3000" -UseBasicParsing -TimeoutSec 1 | Out-Null
    break
  } catch {
    Start-Sleep -Seconds 1
  }
}

步骤 7：返回访问地址（必需）

必须同时返回以下两项：

• 本地访问地址（localhost）
• 局域网访问地址（LAN IP）

首先，**真实探测本机的局域网 IPv4 地址**，不得猜测。

macOS/Linux：

(ipconfig getifaddr en0 || ipconfig getifaddr en1 || hostname -I | awk '{print $1}') 2>/dev/null

Windows（PowerShell）：

(Get-NetIPAddress -AddressFamily IPv4 -InterfaceAlias "Ethernet*","Wi-Fi*" | Select-Object -First 1).IPAddress

规则：

• 必须在生成最终回复前，**实际执行一次 IP 探测命令**。
• 禁止猜测或伪造局域网 IP。
• 即使 localhost 可用，也**不得省略局域网访问地址**。
• 最终回复中**必须同时包含本地 URL 和局域网 URL**。
• 若局域网 IP 探测失败，仍须包含本地 URL，并明确说明：
  • 局域网访问地址：获取失败
  • 并简要说明“局域网 IPv4 地址探测失败”。
• 最终回复**不得仅以 localhost URL 结尾**。

返回消息格式如下：

✅ OpenClaw Dashboard 已启动！

访问地址：
- 本地访问：http://localhost:3000
- 局域网访问：http://:3000

Dashboard 会自动读取你的 OpenClaw 配置，展示所有机器人、模型、会话的状态。

需要停止服务时告诉我一声。

若局域网 IP 探测失败，则使用：

✅ OpenClaw Dashboard 已启动！

访问地址：
- 本地访问：http://localhost:3000
- 局域网访问：获取失败

原因：未能检测到当前机器的局域网 IPv4 地址。

需要停止服务时告诉我一声。

停止服务

当用户要求停止服务时执行：

macOS/Linux：

lsof -ti:3000 | xargs kill -9

Windows（PowerShell）：

Get-Process -Id (Get-NetTCPConnection -LocalPort 3000).OwningProcess | Stop-Process -Force

Windows（cmd）：

for /f "tokens=5" %a in ('netstat -ano ^| findstr :3000') do taskkill /F /PID %a

错误处理

• 未找到 Node.js：提示用户从 https://nodejs.org/ 安装 Node.js 18+
• 端口 3000 已被占用：判断是否为 Dashboard 占用（返回对应 URL），否则建议改用其他端口（例如 PORT=3001 npm run dev）
• 未找到 OpenClaw 配置：警告 Dashboard 可能无法正常工作，缺少 ~/.openclaw/openclaw.json
• 下载失败：建议检查网络连接，或手动从 GitHub 下载
• npm install 失败：建议执行 npm cache clean --force 后重试

注意事项

• 服务以后台方式持续运行，直到被手动停止或系统重启
• Dashboard 直接读取 ~/.openclaw/openclaw.json 配置，无需数据库
• 支持自动刷新、深色/浅色主题、国际化（中文/英文）
• 内置像素风办公室动画，用于趣味化状态可视化

平台识别

# 检测操作系统
uname -s  # macOS 返回 Darwin，Linux 返回 Linux，Windows（Git Bash）返回 MINGW*/MSYS*

# PowerShell 中识别 Windows
$PSVersionTable.Platform  # Windows 返回 Win32NT，其他系统可能为空

Git 识别

# 检查 git 是否可用
git --version
# 返回码为 0 表示已安装，非零表示未安装

识别逻辑：

1. 在流程起始处执行 git --version
2. 记录结果（可用 / 不可用）
3. 在整个工作流中复用该结果

若 git 不可用：

• 始终采用 ZIP 方式下载
• 只要项目目录存在，即强制重新下载（确保获取最新版本）
• 下载前清理旧目录

实现建议

1. 始终优先停止旧服务——确保以最新代码干净重启
2. 在流程开始时检查 git 可用性——决定后续更新策略
3. 使用 git 时：检查更新并按需拉取
4. 未使用 git 时：强制重新下载 ZIP 包以确保最新版本
5. 无需用户确认——自动更新与重启以提供最佳用户体验
6. 使用后台进程管理，避免阻塞主流程
7. 每一步均提供清晰反馈（如“已停止旧服务”、“检测到新版本，正在更新...”、“正在重新下载最新版本...”）
8. 同时兼容 Windows 下的 PowerShell 和 cmd
9. 清理临时文件（如 ZIP 压缩包）
10. 记录错误日志用于调试，但面向用户的提示保持简洁
11. 始终确保使用最新代码——通过 git pull 或完整重下载实现