Nexa OpenClaw Plugin

安装 + 绑定

绑定命令根据 OpenClaw 版本不同。openclaw --version 查当前版本。

新版 OpenClaw（≥ 2026.5.18）

支持 plugin setup adapter，一条命令搞定（自动 SIGUSR1 重启 gateway）：

# 1. 装插件（用打包好的 tarball；npm publish 后可换成 @nexa26/nexa）
openclaw plugins install /path/to/nexa26-nexa-0.2.0.tgz

# 2. 在 Nexa App 复制匹配码（聊天列表 → My Nexa Box → Copy Pairing Code），然后在盒子上：
openclaw channels add --channel nexa --token nxa_bt_<your_pairing_code>

旧版 OpenClaw（< 2026.5.18，例如 2026.3.13）

旧版不认识 --channel/--token 参数（会写出空配置，gateway 进入 auto-restart 死循环）。 必须走插件注册的 legacy CLI 命令，并手动重启 gateway 让它 reload 凭据：

# 1. 装插件
openclaw plugins install /path/to/nexa26-nexa-0.2.0.tgz

# 2. 用 legacy bind 子命令（会显示一行 DEPRECATED 警告，预期内）
openclaw nexa bind nxa_bt_<your_pairing_code>

# 3. 手动 kickstart gateway 才会 reload state.json
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway     # macOS
# systemd 系统用：systemctl --user restart openclaw-gateway

CLI 速查

| 命令 | 版本 | 作用 | |---|---|---| | openclaw channels add --channel nexa --token <code> | ≥ 5.18 | 一步搞定：兑换匹配码 → 保存凭据 → 热重载 | | openclaw nexa bind <code> | < 5.18 | Legacy 兑换路径（需手动 kickstart 重启） | | openclaw nexa status | 全部 | 读本地 state 文件展示当前绑定（不走 gateway round-trip） | | openclaw channels list | 全部 | 查所有 channel 状态（含 nexa） |