Official Verified

Openclaw Connect Node

Skill by ai-scarlett

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/ai-scarlett/openclaw-connect-node

Download Source Code (.zip)

OpenClaw Connect Enterprise — Node 节点

版本: 0.1.5

子节点是 OpenClaw Connect Enterprise 的分布式执行单元，通过 WebSocket 长连接注册到 Hub，接收并执行 Hub 下发的任务。

快速安装

# 1. 解压包
unzip openclaw-connect-enterprise-node.zip
cd openclaw-connect-enterprise

# 2. 安装依赖
cd node/server && npm install && cd ../..
cd node/frontend && npm install && cd ../..

# 3. 启动（生产环境）
cd node/server
HUB_URL=http://你的Hub地址:3100 \
APP_ID=你的APP_ID \
APP_KEY=你的APP_KEY \
APP_TOKEN=你的APP_TOKEN \
npx tsx src/index.ts

# 4. 启动（开发环境）
npm run dev

环境变量

变量	必填	说明
`HUB_URL`	✅	Hub 服务器地址，如 `http://YOUR_HUB_IP:3100`
`APP_ID`	✅	节点唯一标识，在 Hub 后台创建节点获得
`APP_KEY`	✅	节点密钥，在 Hub 后台创建节点获得
`APP_TOKEN`	✅	节点令牌，在 Hub 后台创建节点获得
`NODE_NAME`	否	节点显示名称，默认取主机名
`NODE_PORT`	否	节点本地端口，默认 `3100`
`OPENCLAW_GATEWAY_PORT`	否	本地 OpenClaw Gateway 端口，默认 `18789`

凭证持久化

首次注册成功后，凭证会自动保存到 ~/.openclaw-node/node.json。重启后会自动恢复连接，无需重新配置。

前端界面

cd node/frontend && npm run build
# 访问 http://节点地址:3100

API 端点

Hub → Node（节点本地）

方法	路径	说明
`GET`	`/api/status`	节点运行状态
`GET`	`/api/agents`	本地 Agent 列表
`GET`	`/api/tasks`	同步的任务列表
`POST`	`/api/tasks/:id/start`	标记任务开始
`POST`	`/api/tasks/:id/complete`	标记任务完成
`POST`	`/api/tasks/:id/fail`	标记任务失败

Node → Hub（Hub 端点）

方法	路径	说明
`POST`	`/api/nodes/register`	注册到 Hub
`POST`	`/api/nodes/:id/heartbeat`	心跳（30秒/次）
`GET`	`/api/nodes/:id/tasks`	拉取分配的任务
`POST`	`/api/nodes/:id/agents/register`	注册 Agent
`POST`	`/node/api/tasks/:id/complete`	上报任务完成
`POST`	`/node/api/tasks/report`	上报本地任务到 Hub

任务执行流程

节点每 30 秒向 Hub 拉取新任务（fetchTasks）
任务进入执行队列，按优先级依次执行
执行方式（按优先级）：
- 本地 OpenClaw Gateway（POST /tools/invoke）
- Hub Execute API（代理执行）
- OpenClaw CLI（openclaw agent）
完成后自动上报结果到 Hub

目录结构

node/
├── package.json           # 节点总包管理
├── install-node.sh        # 安装脚本
├── uninstall-node.sh      # 卸载脚本
├── README.md              # 英文说明
├── SKILL.md               # 本文档
├── server/
│   ├── src/
│   │   └── index.ts       # 节点服务端主程序
│   ├── package.json
│   └── tsconfig.json
└── frontend/
    ├── src/               # 节点前端页面源码
    ├── package.json
    └── tailwind.config.js

与 Hub 的连接架构

Read Full Documentation on GitHub

Metadata

Author@ai-scarlett

Stars4473

Updated2026-05-01

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-ai-scarlett-openclaw-connect-node": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

Ai Love World Skill

Skill by ai-scarlett

ai-scarlett 4473

lingxi

灵犀 v3.3.6 - 智慧调度系统。心有灵犀，一点就通。智能理解用户意图，自动调度模型/技能/工具，编排多步骤任务，汇总结果反馈。支持多Agent协作架构。

ai-scarlett 4473

crebee-social-media-gateway

CreBee 社交媒体网关。当用户需要管理社交媒体账号、发布内容（视频/图文/文章）、获取数据分析、访问粉丝画像、搜索话题/活动/音乐、或与抖音、B站、小红书、快手等 12 个平台交互时触发此技能。适用于 AI Agent 自动化管理中国社交媒体平台运营。触发场景： - 发布内容到社交媒体平台 - 获取账号列表或账号信息 - 查询分析数据、数据概览、表现指标 - 访问粉丝/观众画像 - 搜索话题、标签、音乐、活动 - 管理抖音、B站、小红书、快手等平台的内容

ai-scarlett 4473