@soimy/dingtalk 3.0.0-beta.1 → 3.0.0

package/README.md

@@ -44,10 +44,70 @@ openclaw plugins install -l .
 2. 确保包含 `index.ts`, `openclaw.plugin.json` 和 `package.json`。
 3. 运行 `openclaw plugins list` 确认 `dingtalk` 已显示在列表中。
 
+### 安装后必做：配置插件信任白名单（`plugins.allow`）
+
+从 OpenClaw 新版本开始，如果发现了非内置插件且 `plugins.allow` 为空，会提示：
+
+```text
+[plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load ...
+```
+
+这是一条安全告警（不是安装失败），建议显式写入你信任的插件 id。
+
+#### 步骤 1：确认插件 id
+
+本插件 id 固定为：`dingtalk`（定义于 `openclaw.plugin.json`）。
+
+也可用下面命令查看已发现插件：
+
+```bash
+openclaw plugins list
+```
+
+#### 步骤 2：在 `~/.openclaw/openclaw.json` 添加 `plugins.allow`
+
+```json5
+{
+  "plugins": {
+    "enabled": true,
+    "allow": ["dingtalk"]
+  }
+}
+```
+
+如果你还有其他已安装且需要启用的插件，请一并加入，例如：
+
+```json5
+{
+  "plugins": {
+    "allow": ["dingtalk", "telegram", "voice-call"]
+  }
+}
+```
+
+#### 步骤 3：重启 Gateway
+
+```bash
+openclaw gateway restart
+```
+
+> 注意：如果你之前已经配置过 `plugins.allow`，但没有 `dingtalk`，那么插件不会被加载。请把 `dingtalk` 加入该列表。
+
 ## 更新
 
+`openclaw plugins update` 使用插件 id（不是 npm 包名），并且仅适用于 npm 安装来源。
+
+如果你是通过 npm 安装本插件：
+
+```bash
+openclaw plugins update dingtalk
 ```
-openclaw plugins update @soimy/dingtalk
+
+如果你是本地源码/链接安装（`openclaw plugins install -l .`），请在插件目录更新代码后重启 Gateway：
+
+```bash
+git pull
+openclaw gateway restart
 ```
 
 ## 配置
@@ -140,12 +200,17 @@ openclaw configure --section channels
 
 ### 方法 2：手动配置文件
 
-在 `~/.openclaw/openclaw.json` 的 `channels` 下添加（仅作参考，交互式配置会自动生成）：
+在 `~/.openclaw/openclaw.json` 中添加（仅作参考，交互式配置会自动生成）：
 
-> 只添加dingtalk部分，内容参考上文钉钉开发者配置指南
+> 至少包含 `plugins.allow` 和 `channels.dingtalk` 两部分，内容参考上文钉钉开发者配置指南
 
 ```json5
 {
+  "plugins": {
+    "enabled": true,
+    "allow": ["dingtalk"]
+  },
+
   ...
   "channels": {
     "telegram": { ... },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soimy/dingtalk",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.0",
   "description": "DingTalk (钉钉) channel plugin for OpenClaw",
   "keywords": [
     "bot",

package/src/group-members-store.ts

@@ -0,0 +1,45 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+function groupMembersFilePath(storePath: string, groupId: string): string {
+  const dir = path.join(path.dirname(storePath), "dingtalk-members");
+  const safeId = groupId.replace(/\+/g, "-").replace(/\//g, "_");
+  return path.join(dir, `${safeId}.json`);
+}
+
+export function noteGroupMember(
+  storePath: string,
+  groupId: string,
+  userId: string,
+  name: string,
+): void {
+  if (!userId || !name) {
+    return;
+  }
+  const filePath = groupMembersFilePath(storePath, groupId);
+  let roster: Record<string, string> = {};
+  try {
+    roster = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {}
+  if (roster[userId] === name) {
+    return;
+  }
+  roster[userId] = name;
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, JSON.stringify(roster, null, 2));
+}
+
+export function formatGroupMembers(storePath: string, groupId: string): string | undefined {
+  const filePath = groupMembersFilePath(storePath, groupId);
+  let roster: Record<string, string> = {};
+  try {
+    roster = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {
+    return undefined;
+  }
+  const entries = Object.entries(roster);
+  if (entries.length === 0) {
+    return undefined;
+  }
+  return entries.map(([id, name]) => `${name} (${id})`).join(", ");
+}

package/src/inbound-handler.ts

@@ -1,5 +1,3 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
 import axios from "axios";
 import { normalizeAllowFrom, isSenderAllowed, isSenderGroupAllowed } from "./access-control";
 import { getAccessToken } from "./auth";
@@ -14,6 +12,7 @@ import {
   streamAICard,
 } from "./card-service";
 import { resolveGroupConfig } from "./config";
+import { formatGroupMembers, noteGroupMember } from "./group-members-store";
 import { setCurrentLogger } from "./logger-context";
 import { extractMessageContent } from "./message-utils";
 import { registerPeerId } from "./peer-id-registry";
@@ -23,46 +22,6 @@ import type { DingTalkConfig, HandleDingTalkMessageParams, MediaFile } from "./t
 import { AICardStatus } from "./types";
 import { maskSensitiveData } from "./utils";
 
-// ============ Group Members Persistence ============
-
-function groupMembersFilePath(storePath: string, groupId: string): string {
-  const dir = path.join(path.dirname(storePath), "dingtalk-members");
-  const safeId = groupId.replace(/\+/g, "-").replace(/\//g, "_");
-  return path.join(dir, `${safeId}.json`);
-}
-
-function noteGroupMember(storePath: string, groupId: string, userId: string, name: string): void {
-  if (!userId || !name) {
-    return;
-  }
-  const filePath = groupMembersFilePath(storePath, groupId);
-  let roster: Record<string, string> = {};
-  try {
-    roster = JSON.parse(fs.readFileSync(filePath, "utf-8"));
-  } catch {}
-  if (roster[userId] === name) {
-    return;
-  }
-  roster[userId] = name;
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, JSON.stringify(roster, null, 2));
-}
-
-function formatGroupMembers(storePath: string, groupId: string): string | undefined {
-  const filePath = groupMembersFilePath(storePath, groupId);
-  let roster: Record<string, string> = {};
-  try {
-    roster = JSON.parse(fs.readFileSync(filePath, "utf-8"));
-  } catch {
-    return undefined;
-  }
-  const entries = Object.entries(roster);
-  if (entries.length === 0) {
-    return undefined;
-  }
-  return entries.map(([id, name]) => `${name} (${id})`).join(", ");
-}
-
 /**
  * Download DingTalk media file via runtime media service (sandbox-compatible).
  * Files are stored in the global media inbound directory.