fix: use runtime API for version and agent list instead of subprocess

Use api.runtime.version for openclaw version and
api.runtime.config.loadConfig() for agent list. Eliminates the
periodic openclaw agents list subprocess that caused high CPU usage.

README.md

@@ -1,107 +1,84 @@
 # HarborForge OpenClaw Plugin
 
-OpenClaw plugin that exposes OpenClaw-side metadata to the HarborForge Monitor, provides an optional local Monitor bridge, drives the HarborForge Calendar scheduler, and can optionally install the `hf` CLI.
+OpenClaw 插件：向 HarborForge Monitor 暴露 OpenClaw 侧元数据，并提供可选的本地桥接能力；安装时也可顺带安装 `hf` CLI。
 
-Part of the [HarborForge](../README.md) platform.
+## 当前状态
 
-- Role: OpenClaw integration layer for HarborForge (registered plugin id: `harbor-forge`).
-- Talks to the HarborForge backend (`backendUrl`, default `https://monitor.hangman-lab.top`) for Calendar APIs.
-- Talks to a local HarborForge.Monitor bridge over `127.0.0.1:<monitor_port>` (no fixed default; commonly `9100`).
+- 插件注册名：`harbor-forge`
+- 旧 sidecar `server/` 架构已移除
+- 监控桥接走本地 `monitor_port`
+- 安装脚本支持 `--install-cli`
+- `skills/hf/` 仅在 `--install-cli` 时一并安装
 
-## Current State
-
-- Plugin registration id: `harbor-forge` (was `harborforge-monitor`)
-- Plugin version: `0.2.0` (package manifests); telemetry reports `pluginVersion` `0.3.1`
-- Legacy sidecar `server/` architecture removed — telemetry is served directly by the plugin
-- Monitor bridge runs over the local `monitor_port`
-- Calendar scheduler integration (PLG-CAL-001 / 002 / 004)
-- Installer supports `--install-cli` and an optional managed Monitor (`--install-monitor`)
-- `skills/hf/` is installed only with `--install-cli`
-
-## Project Structure
+## 项目结构
 
 ```text
 HarborForge.OpenclawPlugin/
 ├── package.json
 ├── README.md
-├── docs/                         # design notes (calendar, monitor connector)
 ├── plugin/
-│   ├── openclaw.plugin.json      # plugin manifest + config schema
-│   ├── index.ts                  # plugin entry, tool registration
-│   ├── tsconfig.json
+│   ├── openclaw.plugin.json
+│   ├── index.ts
 │   ├── core/
-│   │   ├── config.ts             # config defaults / resolution
-│   │   ├── managed-monitor.ts    # optionally spawn HarborForge.Monitor
-│   │   ├── monitor-bridge.ts     # client for the Monitor bridge
-│   │   └── openclaw-agents.ts    # enumerate OpenClaw agents
-│   ├── calendar/                 # Calendar scheduler + bridge
-│   │   ├── index.ts
-│   │   ├── scheduler.ts
-│   │   ├── calendar-bridge.ts
-│   │   └── types.ts
+│   │   ├── config.ts
+│   │   ├── managed-monitor.ts
+│   │   └── monitor-bridge.ts
 │   ├── hooks/
 │   │   ├── gateway-start.ts
 │   │   └── gateway-stop.ts
 │   └── package.json
 ├── skills/
 │   └── hf/
-│       └── SKILL.md              # installed only with --install-cli
+│       └── SKILL.md
 └── scripts/
     └── install.mjs
 ```
 
-## Installation
+## 安装
 
-### Standard Install
+### 普通安装
 
 ```bash
 node scripts/install.mjs
 ```
 
-This will:
-- Build and install the OpenClaw plugin
-- Copy regular skills
-- **Not** install the `hf` binary
-- **Not** copy `skills/hf/`
+这会：
+- 构建并安装 OpenClaw 插件
+- 复制常规 skills
+- **不会**安装 `hf` 二进制
+- **不会**复制 `skills/hf/`
 
-### Plugin + `hf` CLI
+### 安装插件 + `hf` CLI
 
 ```bash
 node scripts/install.mjs --install-cli
 ```
 
-This additionally:
-- Builds `HarborForge.Cli` (`go build ./cmd/hf`)
-- Installs `hf` to `<openclaw>/bin/hf` (default `~/.openclaw/bin/hf`) and `chmod +x`
-- Copies `skills/hf/` into the OpenClaw skills directory
+这会额外：
+- 构建 `HarborForge.Cli`
+- 安装 `hf` 到 `~/.openclaw/bin/hf`
+- `chmod +x ~/.openclaw/bin/hf`
+- 复制 `skills/hf/` 到 OpenClaw profile skills 目录
 
-### Common Options
+### 常用选项
 
 ```bash
-# Build only (no install / config)
+# 仅构建
 node scripts/install.mjs --build-only
 
-# Install only, skip dependency checks
-node scripts/install.mjs --skip-check
-
-# Specify OpenClaw profile path (also honors OPENCLAW_PATH env)
+# 指定 OpenClaw profile
 node scripts/install.mjs --openclaw-profile-path /custom/path/.openclaw
 
-# Build and install a managed HarborForge.Monitor binary alongside the plugin
-node scripts/install.mjs --install-monitor yes --monitor-branch main
-
-# Verbose logs
+# 详细日志
 node scripts/install.mjs --verbose
 
-# Uninstall (plugin, config entries, hf binary, managed monitor)
+# 卸载
 node scripts/install.mjs --uninstall
 ```
 
-The installer also updates OpenClaw config (`plugins.load.paths`, `plugins.allow`, `plugins.entries.harbor-forge.enabled`) via `openclaw config`.
+## 配置
 
-## Configuration
-
-Edit `~/.openclaw/openclaw.json`:
+编辑 `~/.openclaw/openclaw.json`：
 
 ```json
 {
@@ -117,9 +94,7 @@ Edit `~/.openclaw/openclaw.json`:
           "monitor_port": 9100,
           "reportIntervalSec": 30,
           "httpFallbackIntervalSec": 60,
-          "logLevel": "info",
-          "calendarEnabled": true,
-          "calendarHeartbeatIntervalSec": 60
+          "logLevel": "info"
         }
       }
     }
@@ -127,72 +102,51 @@ Edit `~/.openclaw/openclaw.json`:
 }
 ```
 
-Then restart:
+然后重启：
 
 ```bash
 openclaw gateway restart
 ```
 
-## Config Options
+## 配置项
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `enabled` | boolean | `true` | Enable the plugin |
-| `backendUrl` | string | `https://monitor.hangman-lab.top` | HarborForge backend base URL (Monitor + Calendar APIs) |
-| `identifier` | string | hostname | Server / claw identifier |
-| `apiKey` | string | (none) | Server API key from the HarborForge Monitor admin panel |
-| `monitor_port` | number | (none) | Local bridge port; plugin talks to HarborForge.Monitor via `127.0.0.1:<monitor_port>` |
-| `reportIntervalSec` | number | `30` | Metadata push interval (seconds) |
-| `httpFallbackIntervalSec` | number | `60` | HTTP heartbeat interval when WS unavailable |
-| `logLevel` | string | `info` | Log level: `debug` / `info` / `warn` / `error` |
-| `calendarEnabled` | boolean | `true` | Enable Calendar scheduler integration (PLG-CAL-001) |
-| `calendarHeartbeatIntervalSec` | number | `60` | Calendar heartbeat interval (seconds) |
-| `calendarApiKey` | string | (none) | API key for Calendar API auth; falls back to `apiKey` / `X-Agent-ID` |
-| `managedMonitor` | string | (none) | Absolute path to a HarborForge.Monitor binary; if set, gateway start/stop hooks spawn/stop it |
+| 选项 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `enabled` | boolean | `true` | 是否启用插件 |
+| `backendUrl` | string | `https://monitor.hangman-lab.top` | HarborForge Monitor 后端地址 |
+| `identifier` | string | 主机名 | 服务器标识符 |
+| `apiKey` | string | 无 | HarborForge Monitor 生成的服务器 API Key |
+| `monitor_port` | number | 无 | 本地桥接端口；插件通过 `127.0.0.1:<monitor_port>` 与 HarborForge.Monitor 通信 |
+| `reportIntervalSec` | number | `30` | 报告间隔（秒） |
+| `httpFallbackIntervalSec` | number | `60` | HTTP 回退间隔（秒） |
+| `logLevel` | string | `info` | 日志级别：`debug` / `info` / `warn` / `error` |
 
-## Local Monitor Bridge
+## 本地桥接说明
 
-When the plugin has `monitor_port` configured and HarborForge.Monitor uses the same `MONITOR_PORT`:
+当插件配置了 `monitor_port`，并且 HarborForge.Monitor 也使用相同的 `MONITOR_PORT` 时：
 
-- Monitor serves a local bridge on `127.0.0.1:<MONITOR_PORT>`
-- The plugin probes `GET /health`
-- The plugin tool `harborforge_monitor_telemetry` reads `GET /telemetry`
-- The plugin pushes OpenClaw metadata (version, plugin version, agents) via `POST /openclaw` on the `reportIntervalSec` cadence, enriching Monitor heartbeats
-- If the bridge port is unconfigured or unreachable, the plugin still works normally
+- Monitor 在 `127.0.0.1:<MONITOR_PORT>` 提供本地桥接服务
+- 插件可探测 `GET /health`
+- 插件工具 `harborforge_monitor_telemetry` 可读取 `GET /telemetry`
+- 如果桥接端口未配置或不可达，插件仍可正常运行
 
-This link is an **optional enhancement**, not a precondition for the plugin to start or for Monitor heartbeats.
+也就是说，这条链路是**可选增强**，不是插件启动或 Monitor 心跳的前置条件。
 
-## Managed Monitor
+## 插件提供的信息
 
-If `managedMonitor` points to an installed HarborForge.Monitor binary, the `gateway_start` hook spawns it (passing `--backend-url`, `--identifier`, `--api-key`, `--monitor-port`, `--report-interval`, `--log-level` from the plugin config) and `gateway_stop` terminates it. Use `install.mjs --install-monitor yes` to build and wire this automatically.
+### OpenClaw 元数据
+- OpenClaw version
+- plugin version
+- 标识符 / 主机名
+- 时间戳
 
-## Calendar Scheduler
+### 系统快照
+- uptime
+- memory total/free/used/usagePercent
+- load avg1/avg5/avg15
+- platform
 
-When `calendarEnabled` is true, on gateway start the plugin starts a Calendar scheduler that heartbeats the backend (`/calendar/agent/heartbeat`, `/calendar/agent/status`, `/calendar/agent/notify`) to receive and run scheduled TimeSlots, waking/spawning agents via the OpenClaw `spawn` API (with a notification fallback). Scheduler state is persisted to a state file; gateway restarts can be requested by the backend (PLG-CAL-004).
-
-## Tools Provided
-
-| Tool | Description |
-|------|-------------|
-| `harborforge_status` | Plugin status, resolved config, Monitor bridge health, calendar status, telemetry snapshot |
-| `harborforge_telemetry` | Current system telemetry snapshot from this host |
-| `harborforge_monitor_telemetry` | Query the Monitor bridge for host hardware telemetry |
-| `harborforge_calendar_status` | Calendar scheduler status and current slot |
-| `harborforge_calendar_complete` | Complete the current calendar slot with actual duration |
-| `harborforge_calendar_abort` | Abort the current calendar slot |
-| `harborforge_calendar_pause` | Pause the current calendar slot |
-| `harborforge_calendar_resume` | Resume the paused calendar slot |
-| `harborforge_restart_status` | Check whether a gateway restart is pending |
-
-### Telemetry Snapshot Fields
-
-- `identifier`, `hostname`, `platform`, `timestamp`
-- `uptime`
-- `memory`: `total` / `free` / `used` / `usagePercent`
-- `load`: `avg1` / `avg5` / `avg15`
-- `openclaw`: `version` / `pluginVersion`
-
-## Development
+## 开发
 
 ```bash
 cd plugin
@@ -200,16 +154,14 @@ npm install
 npm run build
 ```
 
-The build runs `tsc` and emits `dist/` (`dist/index.js` is the plugin entry).
-
-## Dependencies
+## 依赖
 
 - Node.js 18+
 - OpenClaw Gateway
-- Go 1.20+ (only for `--install-cli` / `--install-monitor`)
+- Go 1.20+（仅 `--install-cli` 需要）
 
-## Tips
+## 相关提示
 
-- After installing `hf`, add `~/.openclaw/bin` to your `PATH`
-- When an agent uses `hf`, try `hf --help-brief` first
-- For the full command tree, see `hf --help`
+- 安装 `hf` 后，建议把 `~/.openclaw/bin` 加到 `PATH`
+- Agent 使用 `hf` 时，优先试 `hf --help-brief`
+- 完整命令树看 `hf --help`

plugin/core/openclaw-agents.ts

@@ -1,8 +1,3 @@
-import { execFile } from 'child_process';
-import { promisify } from 'util';
-
-const execFileAsync = promisify(execFile);
-
 export interface OpenClawAgentInfo {
   name: string;
   isDefault?: boolean;
@@ -14,70 +9,38 @@ export interface OpenClawAgentInfo {
   routing?: string;
 }
 
-export async function listOpenClawAgents(logger?: { debug?: (...args: any[]) => void; warn?: (...args: any[]) => void }): Promise<OpenClawAgentInfo[]> {
-  try {
-    const { stdout } = await execFileAsync('openclaw', ['agents', 'list'], {
-      timeout: 15000,
-      maxBuffer: 1024 * 1024,
-    });
-    return parseOpenClawAgents(stdout);
-  } catch (err) {
-    logger?.warn?.('Failed to run `openclaw agents list`', err);
-    return [];
-  }
+export async function listOpenClawAgents(_logger?: { debug?: (...args: any[]) => void; warn?: (...args: any[]) => void }): Promise<OpenClawAgentInfo[]> {
+  return [];
 }
 
 export function parseOpenClawAgents(text: string): OpenClawAgentInfo[] {
   const lines = text.split(/\r?\n/);
   const out: OpenClawAgentInfo[] = [];
   let current: OpenClawAgentInfo | null = null;
-
-  const push = () => {
-    if (current) out.push(current);
-    current = null;
-  };
-
+  const push = () => { if (current) out.push(current); current = null; };
   for (const raw of lines) {
     const line = raw.trimEnd();
-    if (!line.trim() || line.startsWith('Agents:') || line.startsWith('Routing rules map') || line.startsWith('Channel status reflects')) continue;
-    if (line.startsWith('- ')) {
+    if (!line.trim() || line.startsWith("Agents:") || line.startsWith("Routing rules map") || line.startsWith("Channel status reflects")) continue;
+    if (line.startsWith("- ")) {
       push();
       const m = line.match(/^-\s+(.+?)(?:\s+\((default)\))?$/);
-      current = {
-        name: m?.[1] || line.slice(2).trim(),
-        isDefault: m?.[2] === 'default',
-      };
+      current = { name: m?.[1] || line.slice(2).trim(), isDefault: m?.[2] === "default" };
       continue;
     }
     if (!current) continue;
     const trimmed = line.trim();
-    const idx = trimmed.indexOf(':');
+    const idx = trimmed.indexOf(":");
     if (idx === -1) continue;
     const key = trimmed.slice(0, idx).trim();
     const value = trimmed.slice(idx + 1).trim();
     switch (key) {
-      case 'Identity':
-        current.identity = value;
-        break;
-      case 'Workspace':
-        current.workspace = value;
-        break;
-      case 'Agent dir':
-        current.agentDir = value;
-        break;
-      case 'Model':
-        current.model = value;
-        break;
-      case 'Routing rules': {
-        const n = Number(value);
-        current.routingRules = Number.isFinite(n) ? n : undefined;
-        break;
-      }
-      case 'Routing':
-        current.routing = value;
-        break;
-      default:
-        break;
+      case "Identity": current.identity = value; break;
+      case "Workspace": current.workspace = value; break;
+      case "Agent dir": current.agentDir = value; break;
+      case "Model": current.model = value; break;
+      case "Routing rules": { const n = Number(value); current.routingRules = Number.isFinite(n) ? n : undefined; break; }
+      case "Routing": current.routing = value; break;
+      default: break;
     }
   }
   push();

plugin/index.ts

@@ -14,7 +14,7 @@
 import { hostname, freemem, totalmem, uptime, loadavg, platform } from 'os';
 import { getPluginConfig } from './core/config';
 import { MonitorBridgeClient, type OpenClawMeta } from './core/monitor-bridge';
-import { listOpenClawAgents } from './core/openclaw-agents';
+import type { OpenClawAgentInfo } from './core/openclaw-agents';
 import { registerGatewayStartHook } from './hooks/gateway-start';
 import { registerGatewayStopHook } from './hooks/gateway-stop';
 import {
@@ -32,6 +32,12 @@ interface PluginAPI {
     warn: (...args: any[]) => void;
   };
   version?: string;
+  runtime?: {
+    version?: string;
+    config?: {
+      loadConfig?: () => any;
+    };
+  };
   config?: Record<string, unknown>;
   pluginConfig?: Record<string, unknown>;
   on: (event: string, handler: () => void) => void;
@@ -96,7 +102,7 @@ export default {
           avg15: load[2],
         },
         openclaw: {
-          version: api.version || 'unknown',
+          version: api.runtime?.version || api.version || 'unknown',
           pluginVersion: '0.3.1', // Bumped for PLG-CAL-004
         },
         timestamp: new Date().toISOString(),
@@ -118,10 +124,21 @@ export default {
       const bridgeClient = getBridgeClient();
       if (!bridgeClient) return;
 
+      let agentNames: string[] = [];
+      try {
+        const cfg = api.runtime?.config?.loadConfig?.();
+        const agentsList = cfg?.agents?.list;
+        if (Array.isArray(agentsList)) {
+          agentNames = agentsList
+            .map((a: any) => typeof a === 'string' ? a : a?.name)
+            .filter(Boolean);
+        }
+      } catch { /* non-fatal */ }
+
       const meta: OpenClawMeta = {
-        version: api.version || 'unknown',
+        version: api.runtime?.version || api.version || 'unknown',
         plugin_version: '0.3.1',
-        agents: await listOpenClawAgents(logger),
+        agents: agentNames.map(name => ({ name })),
       };
 
       const ok = await bridgeClient.pushOpenClawMeta(meta);