@youdu/openclaw-youdu 2026.3.25

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Xinda Jiuzhou Youdu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# YouDu OpenClaw Plugin
+
+有度机器人接入插件，基于 WebSocket 长连接实现消息收发。
+
+## 功能特性
+
+- 🔗 WebSocket 长连接 — 基于 wss 建立持久连接（可通过配置自定义）
+- 🔐 自动认证 — 连接建立后自动发送认证帧（bot_id + secret）
+- 💓 心跳保活 — 自动维护心跳，连续未收到 ack 时自动判定连接异常
+- 🔄 断线重连 — 指数退避重连策略（1s → 2s → 4s → ... → 30s 上限）
+- 📨 消息转发 — 自动接收有度消息并转发给 OpenClaw，将 OpenClaw 回复回传有度
+
+## 安装
+
+##### 1.在 OpenClaw 中安装插件
+```bash
+openclaw plugins install @youdu/openclaw-youdu
+```
+
+## 配置
+
+##### 1.交互式设置
+
+```
+openclaw channels add
+```
+
+选择有度插件，按照提示输入你的 机器人的 ID 、secret和服务器地址，其他配置项默认值即可使用
+配置完成后，重启 OpenClaw 使配置生效
+
+```
+openclaw gateway restart
+```
+
+第一次连接的时候需要配对码，给对应机器人发送一条消息后，会返回一个配对码
+复制最后的指令到 OpenClaw 中执行
+
+```
+openclaw pairing approve youdu 你的配对码
+```
+
+##### 2.CLI 快速设置
+
+```
+openclaw channels add --channel youdu --token <YOUR_BOT_ID> --private-key <YOUR_BOT_SECRET> --url <YOUR_HOST> && openclaw config set channels.youdu.dmPolicy allowlist && openclaw config set channels.youdu.allowFrom "['<YOUR_ACCOUNT>']"
+
+openclaw gateway restart
+```
+
+### 配置项说明
+
+| 配置路径                        | 说明           | 选项                                  | 默认值  |
+| ------------------------------- | -------------- | ------------------------------------- | ------- |
+| `channels.youdu.botId`          | 有度机器人 ID  | —                                     | —       |
+| `channels.youdu.secret`         | 有度机器人密钥 | —                                     | —       |
+| `channels.youdu.enabled`        | 启用频道       | true / false                          | false   |
+| `channels.youdu.websocketUrl`   | WebSocket 地址 | —                                     | —       |
+| `channels.youdu.dmPolicy`       | 私聊访问策略   | pairing / open / allowlist / disabled | pairing |
+| `channels.youdu.allowFrom`      | 私聊允许列表   | —                                     | []      |
+
+## 使用
+
+```bash
+# 重启 OpenClaw 使配置生效
+openclaw gateway restart
+
+# 查看状态
+openclaw status
+
+# 查看频道状态
+openclaw channels status youdu
+```
+
+## 消息处理流程
+
+1. 插件通过 WebSocket 连接到有度服务
+2. 认证成功后，监听来自有度的消息
+3. 收到消息后，解析并转发给 OpenClaw 核心处理
+4. OpenClaw 处理完成后，通过 WebSocket 将回复发送回有度服务
+
+## License
+
+MIT