clawd/README.md

clawd

Claw Box 守护进程，将本地 Linux 设备通过 WebSocket 长连接接入 claw.cutos.ai。

功能

• 自动生成硬件唯一指纹（box_id）
• 首次连接自动注册，获取 claw_id + token 并持久化
• 每 30 秒上报系统指标（CPU、内存、磁盘、温度、负载、运行时间）
• 断线自动重连（指数退避，最大 60 秒）
• systemd 管理，开机自启

快速安装（Linux，需要 root）

curl -fsSL https://raw.githubusercontent.com/stswangzhiping/clawd/main/install.sh | sudo bash

要求：

• Node.js >= 18
• Linux（systemd）

手动运行（开发调试）

git clone https://github.com/stswangzhiping/clawd.git
cd clawd
npm install
node bin/clawd.js

首次启动输出示例

[clawd] 启动中...
[clawd] box_id    = a1b2c3d4e5f6...
[clawd] 服务器    = wss://claw.cutos.ai/ws
[clawd] WebSocket 已连接
[clawd] 注册成功！claw_id = 1000

╔══════════════════════════════════╗
║  激活 PIN 码：  779413          ║
║  请在管理后台或前台输入此 PIN 码  ║
╚══════════════════════════════════╝

[clawd] 等待激活中，心跳正常运行...

配置文件

路径：/etc/clawd/config.json（root 运行）或 ~/.clawd/config.json（普通用户）

{
  "server": "wss://claw.cutos.ai/ws",
  "claw_id": 1000,
  "token": "6e0c182e...",
  "heartbeat_interval": 30
}

服务管理

systemctl status clawd      # 查看状态
journalctl -u clawd -f      # 实时日志
systemctl restart clawd     # 重启
systemctl stop clawd        # 停止
systemctl disable clawd     # 取消开机自启

心跳上报字段

字段	说明	单位
cpu	CPU 使用率	%
mem_total / mem_used	内存总量 / 已用	KB
disk_total / disk_used	根分区总量 / 已用	KB
temperature	CPU 温度	°C
load_1m / load_5m / load_15m	系统负载	—
uptime	运行时间	秒

License

MIT