OpenClaw NEX 桥接
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f9be8d90/openclaw-nex-bridge。
技能介绍
要解决什么问题
在 OpenClaw 里接入 NEX Bridge 时,常见问题不是「缺文档」,而是状态不清晰:扩展目录在磁盘上、但 openclaw plugins list 里看不到;插件已加载却收不到消息;dmPolicy 与发送方不匹配导致消息被拒;长回复被 textChunkLimit 截断。本技能围绕 @soundwisdomai/openclaw-nex-bridge 插件,把安装位置、加载状态、配置项与日志串成可执行的排查路径。
技能如何工作
技能会先引导你确认三件事:包是否在 ~/.openclaw/extensions/openclaw-nex-bridge/、插件是否出现在插件列表、是否在改配置前读过 schema。
配置层面,必填项是 apiKey;常见项包括 enabled、serverUrl(桥接 API 端点)、reconnectInterval / heartbeatInterval、dmPolicy(open、pairing、allowlist)、allowFrom 以及出站文本的 textChunkLimit。回答用户时倾向给出精确的配置键、最小安全改动集,并以一条验证命令或检查项收尾。
排障路径大致分为:未出现在列表(检查 plugins.allow、目录名必须为 openclaw-nex-bridge)、加载但不通(apiKey、serverUrl、桥接服务可达性、dmPolicy)、消息被拒(allowlist 与 allowFrom、pairing 流程)、流式或长回复截断(调高 textChunkLimit)。
适用边界
本技能描述的是 OpenClaw 侧扩展与插件配置,不替代桥接服务端自身的部署与鉴权策略。若 serverUrl 指向的环境不可达或密钥无效,需在服务端与网络层一并核实;dmPolicy 的语义以插件与桥接约定为准,改配置前应先对照 schema 避免无效字段。
使用场景
- 刚把 openclaw-nex-bridge 装进 extensions,要在 plugins list 里确认已加载并补齐必填的 apiKey
- 插件目录存在但列表里没有,需要核对 plugins.allow 与文件夹名是否为 openclaw-nex-bridge
- 桥接已连上但私信发不出去或被拒,要按 dmPolicy 检查 allowFrom 或走完 pairing
- 流式或长回复在出站时被截断,需要对照下游能力调整 textChunkLimit
适合人员
- 负责 OpenClaw 实例运维、需要按 schema 维护 NEX Bridge 扩展与重启/重载流程的工程师
- 对接自建或指定 serverUrl 的桥接 API,要调心跳、重连间隔并验证服务可达性的集成开发
- 维护私信入口的运营或 bot 负责人,需要把 dmPolicy 与发送方白名单、配对流程对齐的人
- 在插件「已安装未加载」场景下,习惯从配置与日志排查 apiKey、serverUrl 或非法 schema 值的支持人员