# HarborForge Monitor / OpenClaw Plugin Connector Plan

## 目标

使用 **API Key + HTTP heartbeat** 连接 HarborForge Monitor 与远程 OpenClaw 节点。

## 认证方式

- 管理员为服务器生成 API Key
- 插件通过 `X-API-Key` 调用 heartbeat 接口
- 不再使用 challenge / RSA 公钥 / WebSocket 握手

## 上报接口

`POST /monitor/server/heartbeat-v2`

### Headers
- `X-API-Key: <server-api-key>`

### Payload
```json
{
  "identifier": "vps.t1",
  "openclaw_version": "OpenClaw 2026.3.13 (61d171a)",
  "plugin_version": "0.1.0",
  "agents": [
    { "id": "agent-bot1", "name": "agent-bot1", "status": "configured" }
  ],
  "cpu_pct": 12.3,
  "mem_pct": 45.6,
  "disk_pct": 78.9,
  "swap_pct": 0,
  "load_avg": [0.12, 0.08, 0.03],
  "uptime_seconds": 12345
}
```

## 语义

- `openclaw_version`: 远程主机上的 OpenClaw 版本
- `plugin_version`: harborforge-monitor 插件版本

## 插件生命周期

- 插件注册到 Gateway
- 在 `gateway_start` 启动 `server/telemetry.mjs`
- 在 `gateway_stop` 停止 sidecar

## 配置位置

`~/.openclaw/openclaw.json`

```json
{
  "plugins": {
    "entries": {
      "harborforge-monitor": {
        "enabled": true,
        "config": {
          "enabled": true,
          "backendUrl": "http://127.0.0.1:8000",
          "identifier": "vps.t1",
          "apiKey": "your-api-key"
        }
      }
    }
  }
}
```

## 已废弃

- challenge UUID
- server public key
- WebSocket telemetry
- encrypted handshake payload