HiLight 安装说明

OpenClaw 安装：https://github.com/openclaw/openclaw#install-recommended

npm 包地址：https://www.npmjs.com/package/@art_style666/hi-light

安装前准备

先确认电脑里有这两个工具：

• Node.js（建议 22 或更高）
• OpenClaw

在终端里输入下面两行，能看到版本号就说明已经装好：

node -v
openclaw --version

版本兼容

| 插件版本 | 兼容的 OpenClaw 版本 | | --- | --- | | 2.1.0 及以上 | OpenClaw ≥ 2026.8.1 | | 2.0.x | 2026.8.1 之前的旧版 OpenClaw |

OpenClaw 2026.8.1 起删除了旧的 SDK 总入口（openclaw/plugin-sdk），2.0.x 插件在新版上无法加载。 通过 npm 安装时，OpenClaw 会根据自身版本自动挑选兼容的插件版本，一般不需要手动指定。

安装方式

1. npm 安装（推荐）

openclaw plugins install @art_style666/hi-light

如果安装时提示 requires capability consent（OpenClaw ≥ 2026.8.1 的能力授权机制）， 追加 --accept-capabilities 后重试：

openclaw plugins install @art_style666/hi-light --accept-capabilities

2. ClawHub Skill 安装（适合想一步配置的用户）

先安装 skill：

npx clawhub@latest install hi-light-openclaw

安装后，在 OpenClaw 里直接这样使用：

用 $hi-light-openclaw 帮我安装 HiLight，我的 API Key 是 xxx

如果你有自定义 ws 地址：

用 $hi-light-openclaw 帮我安装 HiLight，我的 API Key 是 xxx，ws 地址是 wss://example/path

默认会使用官方 HiLight ws 地址；不填也可以。

3. 源码安装（开发调试）

git clone [email protected]:Gongcong/hi-light-plugin.git
cd hi-light-plugin
npm install
npm run build
openclaw plugins install --link /绝对路径/hi-light-plugin

手动配置（方式一和方式三需要）

如果你使用方式二，skill 会在第一次调用时帮你安装插件并写入配置。 如果你使用方式一或方式三，请手动编辑：

编辑文件：~/.openclaw/openclaw.json

把下面这段加到 channels 里（没有就新建）：

"channels": {
  "hi-light": {
    "enabled": true,
    "wsUrl": "wss://open.guangfan.com/open-apis/device-agent/v1/websocket",
    "authToken": "你的API KEY",
    "dmPolicy": "open",
    "allowFrom": [
        "*"
      ]
  }
}

dmPolicy 和 allowFrom 必须按上面填写，否则私聊消息会被拦截。

API KEY 获取方式： 各大应用商店下载 HiLight App，点击设置 -> 帐号管理 -> 获取 API KEY。

让配置生效

openclaw gateway restart

安装完成怎么检查

重启后如果没有报错，基本就安装成功了。 如果想更稳妥，可以看网关日志里是否出现 hi-light 连接成功的信息。