ClawOS

你的私有云桌面，运行在浏览器里

一个自托管的 Web 桌面系统，在浏览器中提供接近原生桌面的操作体验。
AI 炒股分析、影音娱乐、文件管理、笔记、RSS 资讯 —— 一站式整合。

> English Docs

以下数据来自作者使用 ClawOS AI 炒股模块的真实 A 股交易记录（2026年4月），非回测、非模拟盘。

↑ ClawOS AI 炒股持仓风控面板截图（2026-04-13 实盘数据）

2026-04-13，A 股大盘普遍下跌，中证 500 近 20 日跌幅 -4.67%。ClawOS AI 系统给出 天华新能 (300390) 强烈买入 信号 —— 45 位 AI 专家投票，综合评分 80.08 分，趋势交易专家给出 99 分信心度。

结果：天华新能当天暴涨 +17.42%，买入即盈利。

这不是事后诸葛亮。信号在盘前生成，用户确认后买入，系统完整记录了整个决策链。

从 2026-04-04 系统启用至今，共完成 8 轮完整交易（买入→卖出），涉及 6 只 A 股：

胜率: 87.5%  （8 笔中 7 笔盈利，仅 1 笔亏损）
平均收益: +1.71%/笔
平均持仓: 2 个交易日
唯一亏损: 亨通光电 -4.33%（触发止损纪律性卖出）
最大单笔盈利: 光迅科技 +6.94%
当日最大涨幅: 天华新能 +17.42%（04-13 买入当天）

当前持仓：天华新能 (300390)，成本 73.58，现价 80.20，浮盈 +9.00%，已触发第二止盈。

买入当天涨幅 +17.42%，在大盘下跌的市场环境下逆势暴涨。

这不是运气，是系统性的风控纪律：

• 45 位 AI 专家投票 — 30 位 LLM 专家覆盖产业链、基本面、宏观、情绪等 9 个维度 + 15 个规则专家，三流评分加权，不靠单一指标拍脑袋
• 严格止损 — 亏损 ≥3% 立即卖出，不扛单。唯一亏损的亨通光电正是纪律性止损，避免了更大损失
• 风控前置 — 重大事件一票否决（MH1）、次新股/停牌股自动剔除、持仓上限 3 只
• 每日两次数据采集 — 盘后 16:00 全量采集 + 次日 07:30 晨间增量采集，不遗漏夜间重大新闻
• 专家记忆系统 — 三级记忆（短期/中期/长期），专家从历史错误中学习，不重复犯错
• 人机协作 — AI 给建议，人做最终决策，系统忠实记录每次决策并反馈学习

大多数自托管面板只是给你一个书签网格。ClawOS 给你一个真正的桌面 —— 可拖拽窗口、macOS 风格 Dock、桌面小组件、壁纸、15 个互相联动的内置应用。

它只为一个人设计：你自己。单用户、单机部署、零云端依赖。通过 Tailscale 或任何 VPN 远程访问，一切开箱即用。

• 完整桌面壳层 —— Dock 栏、窗口管理、壁纸系统、通知中心、系统状态栏
• AI 智能炒股 —— A 股行情信号、多专家模型投票、持仓风控、记忆复盘
• 影音中心 —— 网易云在线播放、本地音乐库、影视搜索 + HLS 播放
• 效率工具 —— Markdown 笔记（富文本编辑器）、滴答清单集成、RSS 每日简报
• 文件与网盘 —— FileBrowser 本地文件管理、百度 / 夸克网盘（AList 挂载）
• 系统监控 —— CPU/内存/磁盘/网络实时 Widget、systemd 服务健康面板
• 下载管理 —— Aria2 引擎驱动，速度显示 + 队列管理

浏览器 ──> ClawOS (:3001)
             ├── 静态前端 (React SPA)
             ├── REST API (/api/system/*)
             ├── 反向代理 ──> OpenClaw AI   (:18789)
             ├── 反向代理 ──> FileBrowser    (:18790)
             └── RPC 调用 ──> Aria2          (:6800)
                           ──> AList          (:5244)

• 操作系统：Linux（推荐 Ubuntu 24.04+）
• Node.js：20+
• Python 3：AI 炒股数据采集需要（AKShare）
• 可选：Tailscale、Aria2、AList、FileBrowser、OpenClaw

git clone https://github.com/gumustudio/ClawOS.git
cd ClawOS
npm install --prefix frontend
npm install --prefix backend

# 设置登录密码（Basic Auth，用户名固定为 clawos）
mkdir -p ~/.clawos
echo "CLAWOS_PASSWORD=你的密码" > ~/.clawos/.env

# 构建前后端
./scripts/build.sh

# 开发模式（热重载）
./scripts/start-dev.sh
# 前端: http://localhost:5173
# 后端: http://localhost:3001

# 生产模式（systemd 常驻服务）
./scripts/install-systemd.sh
# 访问: http://localhost:3001

• 窗口管理 —— macOS 风格窗口，红/黄/绿按钮（关闭/最小化/最大化），可切换窗口/全屏
• Dock 栏 —— 自动隐藏、可调大小（32–80px）、悬停动画、运行中应用指示器
• 桌面小组件 —— 滴答待办（支持自然语言创建任务）、时钟日历、系统资源、下载队列、正在播放
• 通知中心 —— 后端持久化通知 + SSE 实时推送 + Toast 提醒
• 壁纸系统 —— 多壁纸可选，打开应用时自动模糊效果
• 系统设置 —— 个性化、下载路径、账号授权、系统信息

所有工作目录可通过设置界面或 ~/.clawos/config.json 修改：

{
  "paths": {
    "downloadsDir": "~/下载",
    "musicDownloadsDir": "~/音乐",
    "notesDir": "~/文档/随手小记",
    "readerDir": "~/文档/RSS资讯",
    "stockAnalysisDir": "~/文档/AI炒股分析",
    "videoDownloadsDir": "~/视频"
  }
}

• 所有路由受 HTTP Basic Auth 保护（用户名：clawos）
• 前端内置登录页面
• FileBrowser 代理使用二次 Cookie 鉴权（clawos_filebrowser_auth）
• 本地音乐流媒体使用 Cookie 鉴权（clawos_media_auth），因为 <audio> 标签无法携带 Auth 头
• 不设置 CLAWOS_PASSWORD 则跳过鉴权（仅限本地开发）

所有外部服务均为可选，不安装不影响核心桌面和其他应用。

install-systemd.sh 安装以下 user-level 服务：

# 后端测试
npm --prefix backend test

# 前端测试
npm --prefix frontend test

# 仅类型检查
npx --prefix frontend tsc --noEmit
npx --prefix backend tsc --noEmit

ClawOS/
├── frontend/           # React 前端
│   ├── src/
│   │   ├── apps/       # 各应用组件（AIQuant、Notes、Music 等）
│   │   ├── components/ # 通用组件（通知中心、Dock、桌面 Widget）
│   │   ├── store/      # Zustand 全局状态
│   │   ├── lib/        # 工具库（通知 SDK、服务端配置）
│   │   └── App.tsx     # 桌面壳层 + 应用注册
│   └── public/         # 静态资源（壁纸、图标）
├── backend/
│   ├── src/
│   │   ├── routes/     # Express 路由
│   │   ├── services/   # 业务逻辑（AI 炒股、资讯、通知）
│   │   ├── utils/      # 工具模块（配置、日志、探针）
│   │   └── server.ts   # 入口：鉴权、代理、静态托管
│   └── tests/          # 后端测试
├── scripts/            # 构建、部署、systemd 安装脚本
└── filebrowser/        # FileBrowser 相关文件

不装 Aria2/AList/OpenClaw 能用吗？
可以。这些都是可选集成，对应功能会显示为不可用状态，其他一切正常。

怎么远程访问？
后端默认绑定 127.0.0.1:3001，不暴露外网。推荐通过 Tailscale、WireGuard 或反向代理访问。

怎么更新？

git pull
./scripts/build.sh
systemctl --user restart clawos.service

本项目基于 GNU General Public License v3.0 开源。