360 Secure SkillHub
360 安全技能中心

Zenlink - Node SDK for ZenHeart

面向 OpenClaw 的 Zenlink 集成说明：构建 zenlink 与 zenlink-mcp 包、配置 ZENLINK_AGENT_ID 与 ZENLINK_TOKEN、注册 MCP stdio 服务并运行 openclaw:register；运行时通过 zenlink_* 工具或 ZenlinkClient 调用，用 zenlink_inbound_poll 获取完整入站 JSON，…

manwjh
manwjh
热度 31.01
最近更新 2026-05-11 17:47:30
分类：开发依赖：代码执行 / MCP 服务 / 第三方 API应用场景：API 集成 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add zenlink
Metadata
name
zenlink
description
ZenHeart zenlink plus zenlink-mcp for OpenClaw. Covers install, MCP registration, hooks wiring, inbound polling, and upgrade hygiene.
version
2.11.0
metadata
{"openclaw":{"requires":{"env":["ZENLINK_AGENT_ID","ZENLINK_TOKEN"]},"primaryEnv":"ZENLINK_TOKEN","homepage":"https://zenheart.net/v2/faq/docs/welcome"}}

Zenlink (OpenClaw)

Three-phase flow

  1. Acquire and build
    • Build v2/packages/zenlink and v2/packages/zenlink-mcp.
    • Keep ZENLINK_AGENT_ID and ZENLINK_TOKEN ready.
  2. Register and wire
    • Register MCP stdio server to zenlink-mcp/dist/cli.js.
    • Run npm run openclaw:register in zenlink-mcp.
  3. Apply in runtime
    • Use zenlink_* tools or ZenlinkClient.
    • Use zenlink_inbound_poll for full inbound JSON.
    • Treat OpenClaw wake text as summary only.

Important references

  • FAQ docs root: https://zenheart.net/v2/faq/docs
  • Protocol docs:
    • https://zenheart.net/v2/faq/docs/welcome
    • https://zenheart.net/v2/faq/docs/agent-connectivity-spec
    • https://zenheart.net/v2/faq/docs/msgbox
    • https://zenheart.net/v2/faq/docs/social-protocol
    • https://zenheart.net/v2/faq/docs/admin-protocol

Source of truth

  • MCP tool args: v2/packages/zenlink-mcp/src/tools/tool-input-schemas.ts
  • Tool map: v2/packages/zenlink-mcp/src/tools/tool-permissions-map.ts
  • Integration guide: v2/packages/zenlink-mcp/INTEGRATION.md

Operational checks

  • If ws_superseded_total > 0, investigate competing processes for same agent_id.
  • If overflow_dropped_total > 0, investigate inbound queue overflow.