dlinkclaw-openclaw 1.0.0 → 1.0.2

package/README.md

@@ -1,15 +1,78 @@
-# dlinkclaw-openclaw
-
-### 特别提示
-内部调试中
-
-#### 介绍
-openclaw channel 中继，实现内外自由连接，让openclaw部署在家或公司里.
-
-### DLinkClaw-Openclaw插件安装步骤
-- openclaw plugins install npm:dlinkclaw-openclaw
-- openclaw channels add --channel dlink
-- openclaw configure
-
-#### 使用说明
-- 整理中...
+# dlinkclaw-openclaw
+
+**DLinkClaw（朵联统一 AI 工作台）的 OpenClaw 接入通道插件**
+
+DLinkClaw 朵联统一 AI 工作台是一款企业级即时通讯 + 多智能体协作客户端，支持机器人、群组、语音、文件等多形态消息互通。本插件作为 **OpenClaw 的 channel 中继**，将你的 OpenClaw 网关安全地接入 DLinkClaw —— 让部署在家或公司内网的 OpenClaw 通过朵联工作台随时随地使用，实现内外自由连接。
+
+---
+
+## 界面一览
+
+![DLinkClaw 朵联统一 AI 工作台](./docs/screenshot.jpg)
+
+> 截图：DLinkClaw 客户端 —— 左侧机器人/群组会话列表、中间多智能体对话区、右侧工作区/自动化面板。
+
+---
+
+## 特性
+
+- **多 OpenClaw 实例**：可同时接入多个 OpenClaw 网关，每个实例独立部署、独立账号，工作台内自由切换。
+- **多 DSH 实例**：同样支持接入多个 DSH（DeepSeek）实例，与 OpenClaw 实例统一管理。
+- **更多 Agent 实例**：单个实例可暴露任意数量的 Agent（技术专家、研究员、文案专员、小红书助手等），在工作台中以机器人形式呈现。
+- **单聊 / 群聊**：支持与机器人一对一对话，也可拉入群组协作，群内多 Agent 可互相调用。
+- **双向中继**：OpenClaw 的回复、主动出站消息经 MQTT 中继到 DLinkClaw 客户端；客户端消息实时推送到 OpenClaw 会话。
+- **扩展能力**：内置语音合成 / 语音转写等扩展能力（`ext_capabilities`），开箱即用。
+- **安全接入**：AES 签名认证 + MQTT 加密通道，内网部署无需暴露公网端口。
+
+> 更多多实例、多 Agent 的能力与配置方式，请到**官网了解**：https://dlinkclaw.com
+
+---
+
+## 客户端下载
+
+使用本插件需要 **DLinkClaw（朵联统一 AI 工作台）客户端**：
+
+👉 **下载地址：https://dlinkclaw.com**
+
+---
+
+## 插件安装（OpenClaw 侧）
+
+```bash
+# 1. 安装插件
+openclaw plugins install npm:dlinkclaw-openclaw
+
+# 2. 添加 dlink 通道
+openclaw channels add --channel dlink
+
+# 3. 配置（填入朵联 apiKey / secret / baseUrl）
+openclaw configure
+```
+
+安装完成后，在 DLinkClaw 客户端中即可看到接入的 OpenClaw 机器人并开始对话。
+
+---
+
+## 配置说明
+
+| 配置项 | 说明 |
+| --- | --- |
+| `apiKey` | 朵联平台分配的 apiKey |
+| `secret` | 朵联签名密钥（AES 加密通信用）|
+| `baseUrl` | 朵联服务回调 URL |
+| `accountId` | 账号标识，默认 `default` |
+| `mediaMaxMb` | 媒体大小上限（MB），默认 100 |
+
+---
+
+## 使用说明
+
+1. 在 DLinkClaw 客户端登录并进入 **机器人** 列表。
+2. 添加/打开接入的 OpenClaw Agent 即可开始对话。
+3. 需要模型切换、上下文占用率等高级能力，请确保 OpenClaw 网关运行正常。
+
+---
+
+## 许可
+
+[MIT](./LICENSE)

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dlinkclaw-openclaw",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "description": "DLinkClaw OpenClaw channel plugin — 朵联 OpenClaw 接入通道",
     "keywords": [
         "DLinkClaw",
@@ -35,7 +35,8 @@
         "skills",
         "ext_capabilities",
         "openclaw.plugin.json",
-        "README.md"
+        "README.md",
+        "docs"
     ],
     "dependencies": {
         "axios": "^1.15.2",

package/dist/src/services/services.js

@@ -439,21 +439,46 @@ export class ClawServices extends EventEmitter {
     }
     async handleAgentCreate(params) {
         const workspace_path = getOpenclawPath('workspace', params.id.toLowerCase().replace(/\s+/g, '-'));
+        const provider = params.provider ?? '';
+        // 2026-09-18：新版 agents.create 直接支持 model，这里一步写入（不再依赖 update 补写）
         const createParams = {
             name: params.id,
             workspace: workspace_path,
             emoji: params.emoji,
-            avatar: (params.avatar && params.avatar.length > 0) ? this.options.baseUrl + params.avatar : undefined
-        };
-        const result = await this.client.createAgent(createParams);
-        const provider = params.provider ?? '';
-        const udpateParams = {
-            agentId: result.agentId,
-            name: params.name,
-            workspace: workspace_path,
+            avatar: (params.avatar && params.avatar.length > 0) ? this.options.baseUrl + params.avatar : undefined,
             model: provider.length > 0 ? `${provider}/${params.model}` : params.model,
         };
-        await this.client?.updateAgent(udpateParams);
+        const result = await this.client.createAgent(createParams);
+        // 2026-09-18 修复（石头哥报：首次点击创建失败，且 name 未写入 openclaw.json）：
+        // agents.create 后网关是「异步热加载配置」的（日志：create 186ms 成功，紧跟的
+        // agents.update 报 agent "xiaoha" not found，1 秒后 config hot reload applied）。
+        // 这里改用「update 快速失败重试」：agents.update 对未就绪 agent 是 2ms 快速返回 not found
+        // （ws-client.send 在 WS 未连接时也快速抛错），不会挂起；热加载完成后下一次即成功。
+        // 避免原 waitAgentReady 用 listAgents 轮询导致客户端 loading 超时的问题。
+        const MAX_UPDATE_RETRY = 10;
+        const UPDATE_RETRY_MS = 500;
+        let nameWritten = false;
+        for (let i = 0; i < MAX_UPDATE_RETRY && !nameWritten; i++) {
+            try {
+                const up = await this.client.updateAgent({
+                    agentId: result.agentId,
+                    name: params.name,
+                    workspace: workspace_path,
+                });
+                if (up?.ok) {
+                    nameWritten = true;
+                }
+            }
+            catch {
+                // not found / WS 未连接 → 快速失败，等待热加载后重试
+            }
+            if (!nameWritten) {
+                await new Promise((r) => setTimeout(r, UPDATE_RETRY_MS));
+            }
+        }
+        if (!nameWritten) {
+            this.log(`⚠ agent ${result.agentId} 显示名写入超时（${MAX_UPDATE_RETRY * UPDATE_RETRY_MS}ms），可稍后在 openclaw.json 修改 name`, 'warn');
+        }
         const sessionKey = `agent:${params.agentId}:${this.options.channelId}:direct:${params.userId.toLowerCase()}`;
         await this.handleUpdateSessionModel({
             sessionKey,

package/dist/src/services/types.d.ts

@@ -74,6 +74,7 @@ export interface AgentCreateParams {
     workspace?: string;
     emoji?: string;
     avatar?: string;
+    model?: string;
 }
 export interface AgentCreateResponse {
     ok: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dlinkclaw-openclaw",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "DLinkClaw OpenClaw channel plugin — 朵联 OpenClaw 接入通道",
   "keywords": [
     "DLinkClaw",
@@ -35,7 +35,8 @@
     "skills",
     "ext_capabilities",
     "openclaw.plugin.json",
-    "README.md"
+    "README.md",
+    "docs"
   ],
   "dependencies": {
     "axios": "^1.15.2",
@@ -92,4 +93,4 @@
   "bugs": {
     "url": "https://github.com/dlinkclaw/dlinkclaw-openclaw-channel/issues"
   }
-}
+}