mcpField
N
node-ops

node-ops

github.com/alphaonedev云与 DevOps42 次安装
代码仓库

关于 node-ops

node-ops 是用于管理分布式通信集群节点的技能，支持通过认证进行配对、远程执行命令、访问设备功能及管理 System76，适用于集群和设备队列运维。

主要功能

  1. 01批准或拒绝节点配对
  2. 02在已配对节点运行命令
  3. 03录制屏幕并拍摄相机快照
  4. 04获取 GPS 或网络定位
  5. 05管理 System76 固件与诊断
  6. 06加密集群操作

适用场景

  1. 01批准节点加入通信集群
  2. 02在已配对的远程节点运行命令
  3. 03采集屏幕、相机或位置数据
  4. 04管理设备队列中的 System76 设备

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill node-ops

安装后在 Claude Code 中输入/node-ops确认已加载。

详细介绍

node-ops

用途

此技能用于在分布式通信环境中执行节点操作，重点包括配对节点（批准/拒绝）、执行命令，以及管理屏幕录制、摄像头快照、位置跟踪和 System76 设备等硬件。它专为 distributed-comms 等环境中的安全集群交互而设计。

适用场景

在集群中设置或管理节点配对时使用此技能，例如批准新节点进行通信、调用远程命令或访问设备功能。可将其用于 IoT 设备、远程监控或 System76 硬件集成等场景，例如设备群管理或实时数据采集。

主要功能

  • 通过经过身份验证的请求批准或拒绝节点配对。
  • 在已配对的节点上调用或运行命令，并支持异步执行。
  • 录制目标节点的屏幕会话或拍摄摄像头快照。
  • 使用 GPS 或基于网络的方法获取节点的位置数据。
  • 管理 System76 设备，包括固件更新和硬件诊断。
  • 在 distributed-comms 集群内处理安全通信，并对所有操作进行加密。

使用模式

执行操作前，始终使用 $NODE_OPS_API_KEY 环境变量进行身份验证。先配对节点，再执行命令或访问硬件。快速任务可使用 CLI，以编程方式集成则可使用 API。例如，先检查节点状态，再执行操作。在代码中，将此技能作为模块导入，并使用必需的参数调用方法；在脚本中，可通过管道传递输出以串联命令。

常用命令/API

使用 CLI 工具 node-ops 或访问 https://api.distributed-comms.com/v1/node-ops 上的 REST API。身份验证要求在环境中设置 $NODE_OPS_API_KEY。

  • 用于配对的 CLI：node-ops pair approve --node-id 123 --reason "Verified"。拒绝配对：node-ops pair reject --node-id 123 --reason "Unauthorized"。
  • 用于运行命令的 CLI：node-ops run --node-id 123 --command "ls -la" --async。输出示例：包含命令状态的 JSON。
  • 用于屏幕录制的 API 端点：POST /api/screen_record，请求体为：{"node_id": "123", "duration": 30}。响应：200 OK，并附带录制 URL。
  • 用于摄像头快照的 API：GET /api/camera_snap?node_id=123。需要设置请求头：Authorization: Bearer $NODE_OPS_API_KEY。
  • 用于调用命令的代码片段： 
    const nodeOps = require('node-ops-sdk');
nodeOps.invoke({ nodeId: '123', command: 'echo Hello' })
  .then(result => console.log(result));
  • 用于获取位置的代码片段： 
    import node_ops
location = node_ops.get_location(node_id='123')
print(location)  # Returns dict: {'lat': 37.7749, 'lon': -122.4194}
  • 配置格式：使用 JSON 文件存储节点配置文件，例如 {"node_id": "123", "pair_status": "approved", "api_key": "$NODE_OPS_API_KEY"}。

集成说明

在应用中将 $NODE_OPS_API_KEY 设置为环境变量，以完成集成。进行集群交互时，请确保代码引用 distributed-comms 端点。可使用 node-ops-sdk 等 SDK（适用于 Node.js），或 Python 封装程序。与其他技能组合使用时，通过添加集群 ID 前缀来处理跨集群调用，例如 distributed-comms:node-ops run ...。避免将密钥硬编码；请使用安全保管库或环境文件。

错误处理

常见错误包括身份验证失败（HTTP 401）、找不到节点（404）或命令超时。请检查响应代码，并使用 try-catch 块处理错误。对于 CLI，可使用 --verbose 标志解析错误。例如，如果配对失败，请检查 $NODE_OPS_API_KEY 后重试。在代码中：

try {
  await nodeOps.pairApprove({ nodeId: '123' });
} catch (error) {
  if (error.code === 'AUTH_ERROR') console.error('Invalid API key');
}

使用此技能内置的日志记录功能记录详细错误；通过 --debug 标志启用该功能。

关系图

此技能与以下内容相关：distributed-comms 集群（上级）、带有以下标签的技能：nodes（同级）、pairing（相关）、system76（依赖）、screen 和 camera（集成硬件功能）。关联：使用 distributed-comms 发现节点；与 system76 管理技能共享数据。

评论

支持 Markdown