# raspi-openclaw

**Repository Path**: anlinxi/raspi-openclaw

## Basic Information

- **Project Name**: raspi-openclaw
- **Description**: # OpenClaw 树莓派监控中心

一个功能强大的树莓派系统监控和设备管理面板，支持实时监控、WebSocket推送以及OpenClaw设备管理。

- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🦞 OpenClaw 树莓派监控中心

一个功能强大的树莓派系统监控和设备管理面板，支持实时监控、WebSocket推送以及OpenClaw设备管理。使用OpenClaw开发。

## ✨ 功能特性

### 系统监控
- **实时系统信息**：主机名、系统版本、内核版本、架构、启动时间、温度等
- **性能指标**：CPU使用率、内存使用率、磁盘使用率、CPU温度
- **网络监控**：实时网络流量（上传/下载）统计
- **磁盘IO**：磁盘读写速度监控
- **历史数据图表**：使用ECharts展示各项指标的历史数据

### 设备管理
- **待审批设备**：查看并审批新连接的设备
- **已授权设备**：管理已授权的设备，支持撤销授权
- **设备状态**：显示设备的最后活跃时间

### 其他功能
- **深色/浅色主题切换**
- **快捷入口**：一键访问宝塔面板、群晖NAS、OpenClaw、文档中心
- **WebSocket实时推送**：数据自动更新

## 📸 项目截图

![首页1](assets/img/demo/homepage-1.png)

![首页2](assets/img/demo/homepage-2.png)

![首页3](assets/img/demo/homepage-3.png)

![首页4](assets/img/demo/homepage-4.png)

## 🛠️ 技术栈

### 前端
- **Vue 3**：渐进式JavaScript框架
- **ECharts**：数据可视化图表库

### 后端
- **PHP**：服务端编程语言
- **Workerman**：高性能PHP socket框架（用于WebSocket服务）

## 📁 项目结构

```
raspi-openclaw/
├── api/
│   └── index.php              # API接口文件
├── assets/
│   ├── css/
│   │   └── style.css          # 样式文件
│   ├── img/
│   │   ├── demo/              # 示例截图
│   │   └── favicon.svg        # 网站图标
│   └── js/
│       ├── app.js             # 主应用脚本
│       ├── echarts.min.js     # ECharts库
│       └── vue.global.prod.js # Vue 3库
├── vendor/
│   └── workerman/             # Workerman依赖
├── websocket/
│   ├── server.php             # WebSocket服务器
│   └── simple_server.php      # 简化版服务器
├── .htaccess                  # Apache配置
├── .user.ini                  # PHP配置
├── 404.html                   # 404页面
├── index.html                 # 主页面
└── monitor.sh                 # 监控脚本
```

## 🚀 部署说明

### 环境要求
- PHP 7.4+
- Apache/Nginx
- 树莓派（推荐）或其他Linux系统

### 安装步骤

1. **克隆项目到服务器**
```bash
git clone https://gitee.com/anlinxi/raspi-openclaw.git /path/to/raspi-openclaw
cd /path/to/raspi-openclaw
```

2. **启动WebSocket服务器**
```bash
cd /path/to/raspi-openclaw
php websocket/server.php start -d
```

3. **配置Web服务器**
确保Apache/Nginx正确配置，指向项目根目录。

### OpenClaw配置

项目集成了OpenClaw设备管理功能，需要确保：
- OpenClaw已正确安装
- 用户有权限访问 `/home/pi/.openclaw/devices/` 目录
- Node.js环境已配置（在 `api/index.php` 中修改路径）

## 📖 使用指南

### 访问监控面板
在浏览器中访问：
```
http://your-domain/
```

### WebSocket服务管理
```bash
# 启动
php websocket/server.php start -d

# 停止
php websocket/server.php stop

# 重启
php websocket/server.php restart

# 查看状态
php websocket/server.php status
```

### API接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `?action=system` | GET | 获取系统信息 |
| `?action=realtime` | GET | 获取实时数据 |
| `?action=network` | GET | 获取网络流量 |
| `?action=io` | GET | 获取磁盘IO |
| `?action=devices` | GET | 获取设备列表 |
| `?action=approve` | POST | 批准设备 |
| `?action=reject` | POST | 拒绝设备 |
| `?action=revoke` | POST | 撤销授权 |

## 🔧 配置说明

### 快捷入口
在 `index.html` 中修改快捷入口链接：
```html
<a href="http://your-baota-url" target="_blank" class="shortcut-item">
    <span class="shortcut-icon">🔧</span>
    <span class="shortcut-label">宝塔面板</span>
</a>
```

### 主题切换
点击右上角的太阳/月亮图标可以在深色和浅色主题之间切换。

## 📝 注意事项

1. 确保PHP有权限读取 `/proc/` 目录下的系统文件
2. WebSocket服务器默认监听2346端口，请确保防火墙已开放该端口

## 📄 许可证

本项目使用 MIT 许可证。

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📧 联系方式

- 文档中心：https://docs.openclaw.ai
- OpenClaw官网：https://openclaw.ai

---

🦞 OpenClaw on Raspberry Pi - 让树莓派管理更简单！