@searchfe/openclaw-baiduapp 0.1.1 → 0.1.3

package/README.md

@@ -2,20 +2,16 @@
 
 本指南帮助你配置百度App渠道，并接入 OpenClaw。
 
-> **⚠️ 重要提示**：Baidu App 插件专注于**文本私聊场景**，不支持群聊和媒体消息（图片/语音/文件）。
-
 ## 功能概览
 
-| 功能           | 状态 |
-| :------------- | :--: |
-| 文本消息       |  ✅  |
-| 主动发送消息   |  ✅  |
-| 私聊           |  ✅  |
-| 群聊           |  ❌  |
-| 图片/语音/文件 |  ❌  |
-| Webhook 回调   |  ✅  |
-| 多账户         |  ✅  |
-| 访问控制策略   |  ✅  |
+| 功能         | 状态 |
+| :----------- | :--: |
+| 文本消息     |  ✅  |
+| 主动发送消息 |  ✅  |
+| 私聊         |  ✅  |
+| Webhook 回调 |  ✅  |
+
+> 更多消息类型支持敬请期待。
 
 ## 前置条件
 
@@ -23,18 +19,12 @@
 2. 公网可访问的 HTTPS 服务器（用于接收回调）
 3. OpenClaw 已安装并运行
 
----
-
 ## 步骤一：安装插件
 
-### 方式一：从 npm 安装
-
 ```bash
 openclaw plugins install @searchfe/openclaw-baiduapp
 ```
 
----
-
 ## 步骤二：获取百度平台凭证
 
 <!-- TODO: 补充百度平台注册具体步骤和截图 -->
@@ -46,15 +36,11 @@ openclaw plugins install @searchfe/openclaw-baiduapp
 - **Token**：消息校验 Token
 - **EncodingAESKey**：消息加密密钥（43 位字符）
 
----
-
 ## 步骤三：配置 OpenClaw
 
 ### 使用命令行配置
 
 ```bash
-openclaw config set channels.openclaw-baiduapp.enabled true
-openclaw config set channels.openclaw-baiduapp.webhookPath /openclaw-baiduapp
 openclaw config set channels.openclaw-baiduapp.token your-token
 openclaw config set channels.openclaw-baiduapp.encodingAESKey your-43-char-encoding-aes-key
 openclaw config set channels.openclaw-baiduapp.appKey your-app-key
@@ -69,8 +55,6 @@ openclaw config set channels.openclaw-baiduapp.appSecret your-app-secret
 {
     "channels": {
         "openclaw-baiduapp": {
-            "enabled": true,
-            "webhookPath": "/openclaw-baiduapp",
             "token": "your-token",
             "encodingAESKey": "your-43-char-encoding-aes-key",
             "appKey": "your-app-key",
@@ -90,9 +74,6 @@ openclaw config set channels.openclaw-baiduapp.appSecret your-app-secret
 | `encodingAESKey` |  ✅  | 消息加密密钥（43 位）           |
 | `appKey`         |  ✅  | 应用 App Key（主动发送必需）    |
 | `appSecret`      |  ✅  | 应用 App Secret（主动发送必需） |
-| `welcomeText`    |  ❌  | 用户首次进入时的欢迎语          |
-| `dmPolicy`       |  ❌  | 私聊策略（默认 `pairing`）      |
-| `allowFrom`      |  ❌  | 私聊白名单用户 ID 列表          |
 
 ### 环境变量支持
 
@@ -105,77 +86,18 @@ openclaw config set channels.openclaw-baiduapp.appSecret your-app-secret
 | `BAIDU_APP_KEY`              | `appKey`         |
 | `BAIDU_APP_SECRET`           | `appSecret`      |
 
----
-
 ## 步骤四：重启 Gateway
 
 ```bash
 openclaw gateway restart
 ```
 
----
-
 ## 步骤五：验证配置
 
 1. 在百度平台配置 Webhook 回调地址，指向你的 OpenClaw Gateway
 2. 平台验证通过后，发送一条测试消息
 3. 查看 OpenClaw 日志确认消息接收和回复
 
----
-
-## 高级配置
-
-### 访问控制
-
-```json
-{
-    "channels": {
-        "openclaw-baiduapp": {
-            "enabled": true,
-            "dmPolicy": "open",
-            "allowFrom": []
-        }
-    }
-}
-```
-
-| 字段        | 说明                                                                                     |
-| :---------- | :--------------------------------------------------------------------------------------- |
-| `dmPolicy`  | 私聊策略：`open`（任何人）/ `pairing`（配对）/ `allowlist`（白名单）/ `disabled`（禁用） |
-| `allowFrom` | 私聊白名单用户 ID 列表（当 `dmPolicy` 为 `allowlist` 时生效）                            |
-
-### 多账户配置
-
-```json
-{
-    "channels": {
-        "openclaw-baiduapp": {
-            "enabled": true,
-            "accounts": {
-                "bot1": {
-                    "webhookPath": "/openclaw-baiduapp-1",
-                    "token": "token-1",
-                    "encodingAESKey": "key-1",
-                    "appKey": "app-key-1",
-                    "appSecret": "secret-1"
-                },
-                "bot2": {
-                    "webhookPath": "/openclaw-baiduapp-2",
-                    "token": "token-2",
-                    "encodingAESKey": "key-2",
-                    "appKey": "app-key-2",
-                    "appSecret": "secret-2"
-                }
-            }
-        }
-    }
-}
-```
-
-> 提示：多账号共用同一路径/Token 时，系统会使用第一个匹配的账号。建议每个账号使用独立的 `webhookPath`。
-
----
-
 ## 常见问题
 
 ### Q: 保存配置时提示验证失败？
@@ -190,21 +112,6 @@ openclaw gateway restart
 1. 检查 `appKey`、`appSecret` 是否正确
 2. 查看 OpenClaw 日志获取详细错误信息
 
-### Q: 如何使用 target 发送消息？
-
-```bash
-# 使用 user: 前缀
-send user:userId123 你好
-
-# 使用 openclaw-baiduapp: 完整前缀
-send openclaw-baiduapp:user:userId123 你好
-
-# 指定账户
-send user:userId123@bot1 你好
-```
-
----
-
 ## 开发验证
 
 ```bash

package/dist/index.d.ts

@@ -10,6 +10,7 @@ interface BaiduAppAccountConfig {
     appSecret?: string;
     apiBase?: string;
     welcomeText?: string;
+    touser?: string;
 }
 type BaiduAppConfig = BaiduAppAccountConfig & {
     accounts?: Record<string, BaiduAppAccountConfig>;
@@ -26,6 +27,7 @@ interface ResolvedBaiduAppAccount {
     appSecret?: string;
     apiBase: string;
     canSendActive: boolean;
+    touser?: string;
     config: BaiduAppAccountConfig;
 }
 interface BaiduAppInboundBase {
@@ -128,6 +130,10 @@ declare const baiduAppPlugin: {
                 welcomeText: {
                     type: string;
                 };
+                touser: {
+                    type: string;
+                    description: string;
+                };
                 defaultAccount: {
                     type: string;
                 };
@@ -164,6 +170,10 @@ declare const baiduAppPlugin: {
                             welcomeText: {
                                 type: string;
                             };
+                            touser: {
+                                type: string;
+                                description: string;
+                            };
                         };
                     };
                 };
@@ -369,6 +379,7 @@ interface SendMessageOptions$1 {
     msgid?: string;
     streamId?: string;
     chunkKey?: number;
+    touser?: string;
 }
 declare function sendBaiduAppMessage(account: ResolvedBaiduAppAccount, message: string, options?: SendMessageOptions$1): Promise<SendMessageResult>;
 

package/dist/index.js

@@ -1,4 +1,5 @@
 import crypto from 'crypto';
+import { createRequire } from 'module';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -4058,7 +4059,8 @@ var BaiduAppAccountSchema = external_exports.object({
   appKey: external_exports.string().optional(),
   appSecret: external_exports.string().optional(),
   apiBase: external_exports.string().optional(),
-  welcomeText: external_exports.string().optional()
+  welcomeText: external_exports.string().optional(),
+  touser: external_exports.string().optional()
 });
 BaiduAppAccountSchema.extend({
   defaultAccount: external_exports.string().optional(),
@@ -4078,6 +4080,7 @@ var BaiduAppConfigJsonSchema = {
       appSecret: { type: "string" },
       apiBase: { type: "string" },
       welcomeText: { type: "string" },
+      touser: { type: "string", description: "Default target user ID for outbound messages" },
       defaultAccount: { type: "string" },
       accounts: {
         type: "object",
@@ -4093,7 +4096,8 @@ var BaiduAppConfigJsonSchema = {
             appKey: { type: "string" },
             appSecret: { type: "string" },
             apiBase: { type: "string" },
-            welcomeText: { type: "string" }
+            welcomeText: { type: "string" },
+            touser: { type: "string", description: "Default target user ID for outbound messages" }
           }
         }
       }
@@ -4156,6 +4160,7 @@ function resolveBaiduAppAccount(params) {
   const canSendActive = Boolean(appKey && token && encodingAESKey);
   const rawApiBase = merged.apiBase?.trim() || (isDefaultAccount ? process.env.BAIDU_API_BASE?.trim() : void 0) || void 0;
   const apiBase = (rawApiBase || DEFAULT_API_BASE).replace(/\/+$/, "");
+  const touser = merged.touser?.trim() || (isDefaultAccount ? process.env.BAIDU_APP_TOUSER?.trim() : void 0) || void 0;
   return {
     accountId,
     name: merged.name?.trim() || void 0,
@@ -4167,6 +4172,7 @@ function resolveBaiduAppAccount(params) {
     appSecret,
     apiBase,
     canSendActive,
+    touser,
     config: merged
   };
 }
@@ -4263,6 +4269,9 @@ function encryptBaiduAppPlaintext(params) {
   const encrypted = Buffer.concat([cipher.update(padded), cipher.final()]);
   return encrypted.toString("base64");
 }
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../package.json");
+var PLUGIN_VERSION = pkg.version;
 
 // src/api.ts
 var logger = createLogger("openclaw-baiduapp");
@@ -4277,8 +4286,16 @@ async function sendBaiduAppMessage(account, message, options) {
   }
   const payload = {
     msgtype: "text",
-    text: { content: message }
+    text: { content: message },
+    version: PLUGIN_VERSION,
+    ...options?.msgid != null ? { msgid: options.msgid } : {},
+    ...options?.streamId != null ? { streamId: options.streamId } : {},
+    ...options?.chunkKey != null ? { chunkKey: options.chunkKey } : {}
   };
+  const touser = options?.touser?.trim() || account.touser;
+  if (touser) {
+    payload.touser = touser;
+  }
   const plaintext = JSON.stringify(payload);
   const encrypt = encryptBaiduAppPlaintext({
     encodingAESKey: account.encodingAESKey ?? "",
@@ -4294,12 +4311,7 @@ async function sendBaiduAppMessage(account, message, options) {
   });
   const sendMessageUrl = `${account.apiBase}/chat/openclaw/callback`;
   const url = `${sendMessageUrl}?timestamp=${encodeURIComponent(timestamp)}&ak=${encodeURIComponent(account.appKey ?? "")}&nonce=${encodeURIComponent(nonce)}&msg_signature=${encodeURIComponent(msgSignature)}`;
-  const body = JSON.stringify({
-    encrypt,
-    ...options?.msgid != null ? { msgid: options.msgid } : {},
-    ...options?.streamId != null ? { streamId: options.streamId } : {},
-    ...options?.chunkKey != null ? { chunkKey: options.chunkKey } : {}
-  });
+  const body = JSON.stringify({ encrypt });
   logger.info(`POST ${url}`);
   logger.debug(`request body: ${body}`);
   const resp = await fetch(url, {
@@ -4383,7 +4395,7 @@ async function dispatchBaiduAppMessage(params) {
   const envelopeOptions = channel.reply?.resolveEnvelopeFormatOptions ? channel.reply.resolveEnvelopeFormatOptions(safeCfg) : void 0;
   const body = channel.reply?.formatAgentEnvelope ? channel.reply.formatAgentEnvelope({
     channel: "Baidu App",
-    from: "",
+    from: "openclaw-baiduapp:user",
     previousTimestamp,
     envelope: envelopeOptions,
     body: rawBody
@@ -4595,7 +4607,8 @@ function isXmlFormat(raw) {
   return trimmed.startsWith("<") && trimmed.endsWith(">");
 }
 function buildEncryptedJsonReply(params) {
-  const plaintext = JSON.stringify(params.plaintextJson ?? {});
+  const base = params.plaintextJson != null && typeof params.plaintextJson === "object" ? params.plaintextJson : {};
+  const plaintext = JSON.stringify({ ...base, version: PLUGIN_VERSION });
   const encrypt = encryptBaiduAppPlaintext({
     encodingAESKey: params.account.encodingAESKey ?? "",
     plaintext
@@ -4915,7 +4928,7 @@ async function handleBaiduAppWebhookRequest(req, res) {
       const welcome = target.account.config.welcomeText?.trim();
       if (welcome && target.account.canSendActive) {
         logger2.info("sending welcome message");
-        sendBaiduAppMessage(target.account, welcome).catch((err) => {
+        sendBaiduAppMessage(target.account, welcome, { touser: target.account.touser }).catch((err) => {
           logger2.error(`failed to send welcome message: ${String(err)}`);
         });
       }
@@ -5019,7 +5032,8 @@ async function handleBaiduAppWebhookRequest(req, res) {
               await sendBaiduAppMessage(target.account, chunks[i], {
                 msgid,
                 streamId,
-                chunkKey: i
+                chunkKey: i,
+                touser: target.account.touser
               });
               logger2.debug(`active send chunk ${i + 1}/${chunks.length} sent: streamId=${streamId}`);
             }
@@ -5242,7 +5256,9 @@ var baiduAppPlugin = {
         };
       }
       try {
-        const result = await sendBaiduAppMessage(account, params.text);
+        const result = await sendBaiduAppMessage(account, params.text, {
+          touser: params.to || account.touser
+        });
         return {
           channel: "openclaw-baiduapp",
           ok: result.ok,
@@ -5278,7 +5294,9 @@ var baiduAppPlugin = {
         };
       }
       try {
-        const result = await sendBaiduAppMessage(account, content);
+        const result = await sendBaiduAppMessage(account, content, {
+          touser: params.to || account.touser
+        });
         return {
           channel: "openclaw-baiduapp",
           ok: result.ok,
@@ -5367,7 +5385,7 @@ async function sendMessage(account, options) {
     };
   }
   try {
-    const textResult = await sendBaiduAppMessage(account, options.text);
+    const textResult = await sendBaiduAppMessage(account, options.text, { touser: account.touser });
     return {
       ok: textResult.ok,
       msgid: textResult.msgid,