OpenClaw Nexconn 插件

English | 中文

openclaw-nexconn 是一个面向 Nexconn 的 OpenClaw 渠道插件，支持 Windows、Linux 和 macOS，可将文本与多媒体消息接入 OpenClaw 回复链路。

功能特性

• 支持单聊
• 支持文本、图片、语音、文件、视频消息接入
• 支持将 OpenClaw 生成的文本、多媒体回复发送回 Nexconn
• 使用 areaCode + cloudType + appKey + naviServer + token 进行认证
• 启动时打印脱敏后的 channels.nexconn 配置
• 图片、音频、视频、文件会优先落到 OpenClaw 媒体目录，再交给模型处理
• 已在 Windows、Linux 和 macOS 上验证可用

安装

安装 Node.js

要求 Node.js 版本 >= 22。

方式一：官方安装包

1. 访问 nodejs.org。
2. 下载 22 或更高版本。
3. 安装完成后重新打开终端。

方式二：使用 Node.js 版本管理器

1. 安装 nvm、fnm 或 Volta 等版本管理器。
2. 执行：

nvm install 22
nvm use 22

验证安装

node --version
npm --version

安装 OpenClaw

当前插件的最低适配版本为 OpenClaw 2026.3.23-1。

npm install -g openclaw@latest

安装 FFmpeg

如果你希望插件处理语音、视频缩略图或媒体元数据，建议安装 ffmpeg 和 ffprobe，并确保它们在 PATH 中可用。

验证方式：

ffmpeg -version
ffprobe -version

安装插件

发布后可直接安装已发布包：

openclaw plugins install openclaw-nexconn

OpenClaw 会优先从 ClawHub 解析包，再自动回退到 npm。

本地开发安装

如果你修改了插件源码，通常需要重新执行一次安装命令，让 OpenClaw 重新加载本地最新版本：

openclaw plugins install "/path/to/openclaw-nexconn"

配置

可前往控制台获取 appKey 和 token。
融云用户：https://console.rongcloud.cn/agile/apps/km
Nexconn 用户：https://console.nexconn.ai/agile/apps/km

快速配置（CLI）

配置公有云

openclaw config set channels.nexconn.areaCode 1
openclaw config set channels.nexconn.appKey "your-app-key"
openclaw config set channels.nexconn.token "your-token"
openclaw config set channels.nexconn.enabled true

完整配置（JSON）

{
  "channels": {
    "nexconn": {
      "enabled": true,
      "areaCode": 1,
      "appKey": "your-app-key",
      "token": "your-token"
    }
  }
}

配置私有云

私有云需要额外配置 cloudType 和 naviServer

openclaw config set channels.nexconn.areaCode 1
openclaw config set channels.nexconn.cloudType 1
openclaw config set channels.nexconn.appKey "your-app-key"
openclaw config set channels.nexconn.naviServer "your-navi-server"
openclaw config set channels.nexconn.token "your-token"
openclaw config set channels.nexconn.enabled true

完整配置（JSON）

{
  "channels": {
    "nexconn": {
      "enabled": true,
      "areaCode": 1,
      "cloudType": 1,
      "appKey": "your-app-key",
      "naviServer": "your-navi-server",
      "token": "your-token"
    }
  }
}

配置参考

| 字段 | 类型 | 默认值 | 是否必选 | 说明 | | ------------ | ------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | areaCode | number | 1 | 必选 | Nexconn 地区码（1：北京数据中心， 2：新加坡数据中心，3：北美数据中心，4： 新加坡 B 企业合作数据中心， 5：沙特数据中心，6：阿曼数据中心 ） | | cloudType | number | 0 | 可选 | Nexconn 云类型，公有云不需要设置，私有云必须设置（0：PublicCloud，1：PrivateCloud，2：PrivateCloud104） | | appKey | string | "" | 必选 | Nexconn AppKey | | naviServer | string | "" | 可选 | 可选的自定义 NaviServer 地址（仅私有云需要）；如需配置多个地址，请使用 ; 分隔 | | token | string | "" | 必选 | Nexconn Token | | enabled | boolean | false | 必选 | 是否启用 Nexconn 渠道 |

启动

完成安装和配置后，运行：

openclaw gateway run --verbose

如果插件正常加载，你通常会看到：

• 插件注册日志
• loaded nexconn config 脱敏配置日志
• Nexconn client 初始化与连接日志

也可以在另一个终端查看日志：

openclaw logs --follow --plain

已支持的消息类型

| 类型 | 接收 | 发送 | | ---- | ---- | ---- | | 文本 | ✅ | ✅ | | 图片 | ✅ | ✅ | | 语音 | ✅ | ✅ | | 文件 | ✅ | ✅ | | 视频 | ✅ | ✅ | | 引用 | ✅ | ✅ |

许可

MIT

内置命令

可通过以下命令查看插件版本信息：

/nexconn env

FAQ

执行 openclaw plugins install openclaw-nexconn 安装插件失败按照下面两步尝试

1. 切换 npm registry 为 npm 官方镜像

查看当前的 npm registry 镜像地址

npm config get registry

openclaw-nexconn 插件是在 npm 官方镜像的，如果不是 https://registry.npmjs.org/ ，则需要进行更改

npm config set registry https://registry.npmjs.org/

切换镜像后重新安装插件

2. 切换镜像还是安装插件失败

创建并进入一个临时目录，执行下面命令，手动将插件下载到本地

npm install openclaw-nexconn --verbose

如果此步失败会有具体的报错信息，可以根据报错信息进行排查

如果成功，则代表插件已缓存本地，再次执行 openclaw plugins install openclaw-nexconn 进行安装

原因是 openclaw 插件安装有超时时间，如果网络不佳有概率会导致安装超时

执行 npm install 可以提前将插件缓存到本地，后续安装会用本地缓存的插件