mirror of
https://github.com/qingchencloud/clawpanel.git
synced 2026-05-06 20:02:49 +08:00
985d263dc6
i18n: - Add 9 new locale files (ja/ko/de/es/fr/pt/ru/vi/zh-TW) - Add multilingual README files for all 11 languages - Add locale helper, index, and modular translation system - Add translation generation scripts Website (docs/index.html): - Replace 公益AI接口 branding with 晴辰云AI接口 - Remove OpenClaw 独立安装包 promotion block - Update SEO meta tags (description, keywords, OG, Twitter, JSON-LD) - Add 11-language README links to footer - Update 元宝派 link to new URL Bug fixes: - fix(cron): delivery format mode:'push' → mode:'announce', remove invalid 'to' field (fixes #141) - fix(cron): allow single-channel users to select delivery channel - fix(cron): preserve delivery field in job state for editing - fix(models): add 'ollama' as recognized API type, prevent overwriting native ollama config (fixes #140) - fix(models): skip /v1 append for ollama native API baseUrl - fix(assistant): normalize 'google-generative-ai' consistently, add ollama hints - fix(version): use CLI path classification for source detection on Windows (fixes #139) - fix(version): default to 'official' instead of 'chinese' when source unknown - fix(version): reorder npm global package check based on active CLI
179 lines
7.6 KiB
Markdown
179 lines
7.6 KiB
Markdown
<p align="center">
|
||
<img src="public/images/logo-brand.png" width="360" alt="ClawPanel">
|
||
</p>
|
||
|
||
<p align="center">
|
||
內建 AI 助手的 OpenClaw 管理面板 — 一鍵安裝、設定、診斷、修復
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="README.md">🇨🇳 中文</a> | <a href="README.en.md">🇺🇸 English</a> | <strong>🇹🇼 繁體中文</strong> | <a href="README.ja.md">🇯🇵 日本語</a> | <a href="README.ko.md">🇰🇷 한국어</a> | <a href="README.vi.md">🇻🇳 Tiếng Việt</a> | <a href="README.es.md">🇪🇸 Español</a> | <a href="README.pt.md">🇧🇷 Português</a> | <a href="README.ru.md">🇷🇺 Русский</a> | <a href="README.fr.md">🇫🇷 Français</a> | <a href="README.de.md">🇩🇪 Deutsch</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/qingchencloud/clawpanel/releases/latest">
|
||
<img src="https://img.shields.io/github/v/release/qingchencloud/clawpanel?style=flat-square&color=6366f1" alt="Release">
|
||
</a>
|
||
<a href="https://github.com/qingchencloud/clawpanel/releases/latest">
|
||
<img src="https://img.shields.io/github/downloads/qingchencloud/clawpanel/total?style=flat-square&color=8b5cf6" alt="Downloads">
|
||
</a>
|
||
<a href="https://github.com/qingchencloud/clawpanel/blob/main/LICENSE">
|
||
<img src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg?style=flat-square" alt="License">
|
||
</a>
|
||
</p>
|
||
|
||
---
|
||
|
||
<p align="center">
|
||
<img src="docs/feature-showcase.gif" width="800" alt="ClawPanel 功能展示">
|
||
</p>
|
||
|
||
ClawPanel 是 [OpenClaw](https://github.com/1186258278/OpenClawChineseTranslation) AI Agent 框架的視覺化管理面板。**內建智慧 AI 助手**，幫你一鍵安裝 OpenClaw、自動診斷設定、排查問題、修復錯誤。8 大工具 + 4 種模式 + 互動式問答，從新手到老手都能輕鬆管理。
|
||
|
||
> 🌐 **官網**: [claw.qt.cool](https://claw.qt.cool/) | 📦 **下載**: [GitHub Releases](https://github.com/qingchencloud/clawpanel/releases/latest)
|
||
|
||
### 🎁 晴辰雲 AI 介面
|
||
|
||
> 內部技術測試平台，面向部分使用者開放體驗。簽到領額度，邀請得更多。
|
||
|
||
<p align="center">
|
||
<a href="https://gpt.qt.cool"><img src="https://img.shields.io/badge/🔑 晴辰雲 AI-gpt.qt.cool-6366f1?style=for-the-badge" alt="晴辰雲 AI"></a>
|
||
</p>
|
||
|
||
- **簽到領測試額度** — 每日簽到 + 邀請好友，持續獲取測試額度
|
||
- **相容 OpenAI 介面** — 無縫對接 OpenClaw，即開即用
|
||
- **資源策略** — 限速 + 請求上限，高峰期可能排隊
|
||
- **模型可用性** — 模型/介面以實際頁面為準，可能灰度或版本切換
|
||
|
||
> ⚠️ **合規與責任邊界**：本平台僅提供技術測試，禁止用於違法違規、繞過安全機制等用途。妥善保管 API Key。具體規則以平台最新政策為準。
|
||
|
||
### 🔥 開發板 / 嵌入式裝置支援
|
||
|
||
- **Orange Pi / 樹莓派 / RK3588** — `npm run serve` 即可執行
|
||
- **Docker ARM64** — `docker run ghcr.io/qingchencloud/openclaw:latest`
|
||
- **Armbian / Debian / Ubuntu Server** — 自動偵測架構
|
||
- 無需 Rust / Tauri / GUI — **只要有 Node.js 18+ 就能跑**
|
||
|
||
## 社群
|
||
|
||
一群對 AI Agent 充滿熱情的開發者和玩家，歡迎加入交流。
|
||
|
||
<p align="center">
|
||
<a href="https://discord.gg/U9AttmsNHh"><strong>Discord</strong></a>
|
||
·
|
||
<a href="https://github.com/qingchencloud/clawpanel/discussions"><strong>Discussions</strong></a>
|
||
·
|
||
<a href="https://github.com/qingchencloud/clawpanel/issues/new"><strong>回報 Issue</strong></a>
|
||
</p>
|
||
|
||
## 功能特性
|
||
|
||
- **🤖 AI 助手（全新）** — 內建 AI 助手，4 種模式 + 8 大工具 + 互動式問答
|
||
- **🖼️ 圖片辨識** — 貼上截圖或拖曳圖片，AI 自動辨識分析
|
||
- **儀表板** — 系統概覽，即時服務狀態監控，快捷操作
|
||
- **服務管理** — OpenClaw 啟停控制、版本偵測與一鍵升級
|
||
- **模型設定** — 多服務商管理、批次連通性測試、拖曳排序、自動儲存
|
||
- **閘道設定** — 埠口、存取權限、認證 Token、Tailscale
|
||
- **訊息頻道** — 統一管理 Telegram、Discord、飛書、釘釘、QQ
|
||
- **通訊與自動化** — 訊息設定、廣播策略、Webhook、執行審批
|
||
- **使用情況** — Token 用量、API 費用、模型/服務商排行
|
||
- **Agent 管理** — Agent 增刪改查、身分編輯、工作區管理
|
||
- **聊天** — 串流回應、Markdown 渲染、對話管理
|
||
- **定時任務** — Cron 定時執行，多頻道投遞
|
||
- **日誌檢視** — 多來源即時日誌與關鍵字搜尋
|
||
- **記憶管理** — 記憶檔案檢視/編輯、ZIP 匯出、Agent 切換
|
||
- **晴辰雲 AI 介面** — 內部測試平台，相容 OpenAI
|
||
- **擴充工具** — cftunnel 隧道管理、ClawApp 狀態監控
|
||
- **關於** — 版本資訊、社群入口、相關專案連結
|
||
|
||
## 下載安裝
|
||
|
||
前往 [Releases](https://github.com/qingchencloud/clawpanel/releases/latest) 下載最新版本：
|
||
|
||
| 平台 | 安裝檔 |
|
||
|------|--------|
|
||
| **Windows** | `.exe` 安裝程式（推薦）或 `.msi` |
|
||
| **macOS Apple Silicon** | `.dmg` (aarch64) |
|
||
| **macOS Intel** | `.dmg` (x64) |
|
||
| **Linux** | `.AppImage` / `.deb` / `.rpm` |
|
||
|
||
### Linux 伺服器（Web 版）
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash
|
||
```
|
||
|
||
### Docker
|
||
|
||
```bash
|
||
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"
|
||
```
|
||
|
||
## 快速上手
|
||
|
||
1. **初始設定** — 首次啟動自動偵測 Node.js、Git、OpenClaw。未安裝則一鍵安裝
|
||
2. **設定模型** — 新增 AI 服務商（DeepSeek、OpenAI、Ollama 等），測試連線
|
||
3. **啟動 Gateway** — 前往服務管理，點擊「啟動」。綠色狀態 = 就緒
|
||
4. **開始聊天** — 前往即時聊天，選擇模型後開始對話
|
||
|
||
## 🤖 AI 助手亮點
|
||
|
||
可**直接操作系統**的 AI 助手 — 診斷、修復、甚至提交 PR。
|
||
|
||
### 四種模式
|
||
|
||
| 模式 | 工具 | 寫入檔案 | 確認 | 適用場景 |
|
||
|------|------|---------|------|---------|
|
||
| **聊天** 💬 | ❌ | ❌ | — | 純問答 |
|
||
| **規劃** 📋 | ✅ | ❌ | ✅ | 讀取設定/日誌，輸出方案 |
|
||
| **執行** ⚡ | ✅ | ✅ | ✅ | 正常作業，危險操作需確認 |
|
||
| **無限** ∞ | ✅ | ✅ | ❌ | 全自動 |
|
||
|
||
## 技術架構
|
||
|
||
| 層級 | 技術 | 說明 |
|
||
|------|------|------|
|
||
| 前端 | Vanilla JS + Vite | 零框架依賴，輕量 |
|
||
| 後端 | Rust + Tauri v2 | 原生效能，跨平台 |
|
||
| 通訊 | Tauri IPC + Shell Plugin | 前後端橋接 |
|
||
| 樣式 | Pure CSS (CSS Variables) | 暗色/亮色主題 |
|
||
|
||
## 從原始碼建置
|
||
|
||
```bash
|
||
git clone https://github.com/qingchencloud/clawpanel.git
|
||
cd clawpanel && npm install
|
||
|
||
# 桌面版（需要 Rust + Tauri v2）
|
||
npm run tauri dev # 開發
|
||
npm run tauri build # 正式版
|
||
|
||
# 僅 Web（無需 Rust）
|
||
npm run dev # 熱更新開發
|
||
npm run build && npm run serve # 正式版
|
||
```
|
||
|
||
## 相關專案
|
||
|
||
| 專案 | 說明 |
|
||
|------|------|
|
||
| [OpenClaw](https://github.com/1186258278/OpenClawChineseTranslation) | AI Agent 框架 |
|
||
| [ClawApp](https://github.com/qingchencloud/clawapp) | 跨平台行動聊天客戶端 |
|
||
| [cftunnel](https://github.com/qingchencloud/cftunnel) | Cloudflare Tunnel 工具 |
|
||
|
||
## 貢獻
|
||
|
||
歡迎提交 Issue 和 Pull Request。詳見 [CONTRIBUTING.md](CONTRIBUTING.md)。
|
||
|
||
## 授權條款
|
||
|
||
[AGPL-3.0](LICENSE) 開源授權。商用需求請聯繫取得商業授權。
|
||
|
||
© 2026 QingchenCloud | [claw.qt.cool](https://claw.qt.cool)
|