SEVENTEEN-TAN 87d7c227d8 fix: 重构版本源检测逻辑 + standalone 目录集中化 + Linux 平台检测补全 (#161)
* fix: Windows 版本检测错误——优先从活跃 CLI 读取版本,修复源判断和包检查顺序

- get_local_version() Windows 块新增活跃 CLI 优先检测(与 macOS 一致),
  避免残留的 standalone 汉化版目录被优先扫描到
- detect_installed_source() 修复 standalone 被错误映射为 official(应为 chinese)
- read_version_from_installation() 根据 classify_cli_source 动态决定
  package.json 检查顺序,避免硬编码汉化版优先导致官方版用户看到错误版本

🤖 Generated with [Qoder][https://qoder.com]

* fix: Windows 版本检测忽略残留文件,仅当 CLI 二进制存在时才读取版本

standalone 目录和 npm 全局目录中可能存在卸载后的残留 node_modules/
package.json,导致面板误判 OpenClaw 已安装并显示错误版本号。
现在在读取版本前先检查 openclaw.cmd 是否实际存在。

🤖 Generated with [Qoder][https://qoder.com]

* fix: 重构版本源检测逻辑,修复跨源切换后显示旧源的问题

- 新增 detect_source_from_cmd_shim() 通过读取 Windows .cmd shim 内容判断
  npm 包归属,替代不可靠的文件系统残留目录扫描
- 重写 detect_installed_source() Windows 检测块,优先使用 shim 内容信号
- upgrade_openclaw_inner() 跨源切换时清理 standalone 安装目录
- get_local_version() npm 段改用 shim 内容判断活跃包
- build_enhanced_path() 三平台添加 standalone 安装目录,避免 dashboard 超时
- 所有平台 fallback 从 "official" 改为 "unknown",支持非面板安装场景
- 前端 dashboard/about 支持 official/chinese/unknown 三源显示
- 新增 unknownSource i18n key(中/英/繁/日/韩)

🤖 Generated with [Qoder][https://qoder.com]

* fix: 移除 config.rs 末尾多余的闭合括号,修复编译错误

🤖 Generated with [Qoder][https://qoder.com]

* fix: 移除 config.rs 末尾重复的 configure_git_https 和 invalidate_path_cache 定义

🤖 Generated with [Qoder][https://qoder.com]

* refactor: standalone 目录集中化、unsafe set_var 适配、Linux 平台检测补全

- 提升 all_standalone_dirs() / standalone_install_dir() 为 pub(crate),
  作为全局唯一的 standalone 路径来源
- build_enhanced_path() 三平台块改为调用 config::all_standalone_dirs()
- service.rs 三平台 candidate 函数改为调用 super::config::all_standalone_dirs()
- utils.rs common_non_windows_cli_candidates() 改为调用集中函数
- std::env::set_var 包裹 unsafe 块,附 SAFETY 注释,适配 Rust 1.83+
- 补全 Linux detect_installed_source(): CLI 路径分类 -> symlink -> standalone -> npm list
- 补全 Linux get_local_version(): 活跃 CLI -> standalone VERSION -> symlink package.json

🤖 Generated with [Qoder][https://qoder.com]

* fix: service.rs 模块路径修正 super::config -> crate::commands::config

mod platform 内部 super 指向 service 模块而非 commands,
需要完整路径 crate::commands::config 才能访问 all_standalone_dirs()

🤖 Generated with [Qoder][https://qoder.com]

---------

Co-authored-by: SEVENTEEN-TAN <SEVENTEEN-TAN@users.noreply.github.com>
2026-03-30 22:50:11 +08:00
2026-03-08 02:02:01 +08:00
2026-03-25 22:48:12 +00:00

ClawPanel

OpenClaw Management Panel with Built-in AI Assistant — One-click Install, Configure, Diagnose & Fix

🇨🇳 中文 | 🇺🇸 English | 🇹🇼 繁體中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇻🇳 Tiếng Việt | 🇪🇸 Español | 🇧🇷 Português | 🇷🇺 Русский | 🇫🇷 Français | 🇩🇪 Deutsch

Release Downloads License CI


ClawPanel Feature Showcase

ClawPanel is a visual management panel for the OpenClaw AI Agent framework. It features a built-in intelligent AI assistant that helps you install OpenClaw with one click, auto-diagnose configurations, troubleshoot issues, and fix errors. 8 tools + 4 modes + interactive Q&A — easy to manage for beginners and experts alike.

🌐 Website: claw.qt.cool | 📦 Download: GitHub Releases

🎁 QingchenCloud AI API

Internal technical testing platform, open for selected users. Sign in daily to earn credits.

QingchenCloud AI

  • Daily Sign-in Credits — Sign in daily + invite friends to earn test credits
  • OpenAI-Compatible API — Seamless integration with OpenClaw, plug and play
  • Resource Policy — Rate limiting + request caps, may queue during peak hours
  • Model Availability — Models/APIs subject to actual page display, may rotate versions

⚠️ Compliance: This platform is for technical testing only. Illegal use or circumventing security mechanisms is prohibited. Keep your API Key secure. Rules subject to latest platform policies.

🔥 Dev Board / Embedded Device Support

ClawPanel provides a pure Web deployment mode (zero GUI dependency), natively compatible with ARM64 boards:

  • Orange Pi / Raspberry Pi / RK3588npm run serve to run
  • Docker ARM64docker run ghcr.io/qingchencloud/openclaw:latest
  • Armbian / Debian / Ubuntu Server — Auto-detect architecture
  • No Rust / Tauri / GUI needed — only Node.js 18+ required

📖 See Armbian Deployment Guide | Web Dev Mode

Community

A community of passionate AI Agent developers and enthusiasts — join us!

Discord  ·  Discussions  ·  Report Issue

Features

  • 🤖 AI Assistant (New) — Built-in AI assistant, 4 modes + 8 tools + interactive Q&A. See AI Assistant Highlights
  • 🖼️ Image Recognition — Paste screenshots or drag images, AI auto-analyzes, multimodal conversations
  • Dashboard — System overview, real-time service monitoring, quick actions
  • Service Management — OpenClaw start/stop, version detection & one-click upgrade, Gateway install/uninstall, config backup & restore
  • Model Configuration — Multi-provider management, model CRUD, batch connectivity tests, latency detection, drag-to-reorder, auto-save + undo
  • Gateway Configuration — Port, access scope (localhost/LAN), auth Token, Tailscale networking
  • Messaging Channels — Unified Telegram, Discord, Feishu, DingTalk, QQ management, multi-Agent binding per platform
  • Communication & Automation — Message settings, broadcast strategies, slash commands, Webhooks, execution approval
  • Usage Analytics — Token usage, API costs, model/provider/tool rankings, daily usage charts
  • Agent Management — Agent CRUD, identity editing, model config, workspace management
  • Chat — Streaming, Markdown rendering, session management, /fast /think /verbose /reasoning commands
  • Cron Jobs — Cron-based scheduled execution, multi-channel delivery
  • Log Viewer — Multi-source real-time logs with keyword search
  • Memory Management — Memory file view/edit, categorized management, ZIP export, Agent switching
  • QingchenCloud AI API — Internal testing platform, OpenAI-compatible, daily sign-in credits
  • Extensions — cftunnel tunnel management, ClawApp status monitoring
  • About — Version info, community links, related projects, one-click upgrade

Download & Install

Go to Releases for the latest version:

macOS

Chip Installer Notes
Apple Silicon (M1/M2/M3/M4) ClawPanel_x.x.x_aarch64.dmg Macs from late 2020+
Intel ClawPanel_x.x.x_x64.dmg Macs 2020 and earlier

⚠️ "Damaged" or "unverified developer"? App is unsigned. Run: sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

Windows

Format Installer Notes
EXE ClawPanel_x.x.x_x64-setup.exe Recommended
MSI ClawPanel_x.x.x_x64_en-US.msi Enterprise / silent install

Linux

Format Installer Notes
AppImage ClawPanel_x.x.x_amd64.AppImage No install, chmod +x and run
DEB ClawPanel_x.x.x_amd64.deb sudo dpkg -i *.deb
RPM ClawPanel-x.x.x-1.x86_64.rpm sudo rpm -i *.rpm

Linux Server (Web Version)

curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash

Visit http://YOUR_SERVER_IP:1420 after deployment. 📖 Linux Deployment Guide

Docker

docker run -d --name clawpanel --restart unless-stopped \
  -p 1420:1420 -v clawpanel-data:/root/.openclaw \
  node:22-slim \
  sh -c "apt-get update && apt-get install -y git && \
    npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com && \
    git clone https://github.com/qingchencloud/clawpanel.git /app && \
    cd /app && npm install && npm run build && npm run serve"

📖 Docker Deployment Guide

Quick Start

  1. Initial Setup — First launch auto-detects Node.js, Git, OpenClaw. One-click install if missing.
  2. Configure Models — Add AI providers (DeepSeek, MiniMax, OpenAI, Ollama, etc.) with API keys. Test connectivity.
  3. Start Gateway — Go to Service Management, click Start. Green status = ready.
  4. Start Chatting — Go to Live Chat, select model, start conversation with streaming & Markdown.

🤖 AI Assistant Highlights

Built-in AI assistant that can directly operate your system — diagnose, fix, even submit PRs.

Four Modes

Mode Icon Tools Write Confirm Use Case
Chat 💬 Pure Q&A
Plan 📋 Read configs/logs, output plans
Execute Normal work, dangerous ops need confirm
Unlimited Full auto, no prompts

Eight Tools

Tool Function
ask_user Ask user questions (single/multi/text)
get_system_info Get OS, architecture, home directory
run_command Execute shell commands
read_file / write_file Read/write files
list_directory Browse directories
list_processes View processes
check_port Check port usage

Tech Architecture

Layer Technology Description
Frontend Vanilla JS + Vite Zero framework, lightweight
Backend Rust + Tauri v2 Native performance, cross-platform
Communication Tauri IPC + Shell Plugin Frontend-backend bridge
Styling Pure CSS (CSS Variables) Dark/Light themes, glassmorphism

Build from Source

git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel && npm install

# Desktop (requires Rust + Tauri v2)
npm run tauri dev        # Development
npm run tauri build      # Production

# Web only (no Rust needed)
npm run dev              # Dev with hot reload
npm run build && npm run serve  # Production
Project Description
OpenClaw AI Agent Framework
ClawApp Cross-platform mobile chat client
cftunnel Cloudflare Tunnel tool

Contributing

Issues and Pull Requests are welcome. See CONTRIBUTING.md for guidelines.

Acknowledgements

ClawPanel keeps growing because of every contributor in the community. Thank you for helping make the project better.

Code Contributors

Thanks to these developers for submitting Pull Requests and contributing directly to the codebase:


liucong2013

#88

axdlee

#58

ATGCS

#107

livisun

#106

kiss-kedaya

#101 #94

wzh4869

#82

0xsline

#15

jonntd

#18

Community Reporters

Thanks to community members who opened issues, reported bugs, and suggested features:

If we missed your contribution, please open an issue and we will add it promptly.

Sponsor

If you find this project useful, consider supporting us via USDT (BNB Smart Chain):

Sponsor QR
0xbdd7ebdf2b30d873e556799711021c6671ffe88f

Contact

License

This project is licensed under AGPL-3.0. For commercial/proprietary use without open-source requirements, contact us for a commercial license.

© 2026 QingchenCloud (武汉晴辰天下网络科技有限公司) | claw.qt.cool

Languages
JavaScript 60.2%
Rust 30.8%
CSS 7.8%
Shell 0.7%
HTML 0.4%