@core-workspace/infoflow-openclaw-plugin 2026.3.8

package/openclaw.plugin.json

@@ -0,0 +1,138 @@
+{
+  "id": "infoflow",
+  "channels": ["infoflow"],
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiHost": { "type": "string" },
+      "enabled": { "type": "boolean" },
+      "name": { "type": "string" },
+      "checkToken": { "type": "string" },
+      "encodingAESKey": { "type": "string" },
+      "appKey": { "type": "string" },
+      "appSecret": { "type": "string" },
+      "connectionMode": {
+        "type": "string",
+        "enum": ["webhook", "websocket"],
+        "default": "webhook",
+        "description": "消息接收方式：webhook（HTTP 回调）或 websocket（长连接）"
+      },
+      "wsGateway": {
+        "type": "string",
+        "description": "WebSocket Gateway 域名（仅 websocket 模式使用）"
+      },
+      "robotName": { "type": "string" },
+      "appAgentId": {
+        "type": "number",
+        "description": "如流企业后台的应用ID，私聊消息撤回依赖此字段"
+      },
+      "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"] },
+      "allowFrom": { "type": "array", "items": { "type": "string" } },
+      "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+      "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
+      "requireMention": { "type": "boolean" },
+      "replyMode": {
+        "type": "string",
+        "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"],
+        "default": "mention-and-watch"
+      },
+      "followUp": { "type": "boolean", "default": true },
+      "followUpWindow": { "type": "number", "default": 300 },
+      "watchMentions": { "type": "array", "items": { "type": "string" } },
+      "watchRegex": { "type": "string" },
+      "groups": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "replyMode": {
+              "type": "string",
+              "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
+            },
+            "watchMentions": { "type": "array", "items": { "type": "string" } },
+            "watchRegex": { "type": "string" },
+            "followUp": { "type": "boolean" },
+            "followUpWindow": { "type": "number" },
+            "systemPrompt": { "type": "string" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "name": { "type": "string" },
+            "checkToken": { "type": "string" },
+            "encodingAESKey": { "type": "string" },
+            "appKey": { "type": "string" },
+            "appSecret": { "type": "string" },
+            "connectionMode": {
+              "type": "string",
+              "enum": ["webhook", "websocket"],
+              "default": "webhook"
+            },
+            "wsGateway": { "type": "string" },
+            "robotName": { "type": "string" },
+            "appAgentId": {
+              "type": "number",
+              "description": "如流企业后台的应用ID，私聊消息撤回依赖此字段"
+            },
+            "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"] },
+            "allowFrom": { "type": "array", "items": { "type": "string" } },
+            "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+            "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
+            "requireMention": { "type": "boolean" },
+            "replyMode": {
+              "type": "string",
+              "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
+            },
+            "followUp": { "type": "boolean" },
+            "followUpWindow": { "type": "number" },
+            "watchMentions": { "type": "array", "items": { "type": "string" } },
+            "watchRegex": { "type": "string" },
+            "groups": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "replyMode": {
+                    "type": "string",
+                    "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
+                  },
+                  "watchMentions": { "type": "array", "items": { "type": "string" } },
+                  "watchRegex": { "type": "string" },
+                  "followUp": { "type": "boolean" },
+                  "followUpWindow": { "type": "number" },
+                  "systemPrompt": { "type": "string" }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        }
+      },
+      "defaultAccount": { "type": "string" },
+      "processingHint": {
+        "type": "boolean",
+        "default": true,
+        "description": "响应超时后发送\"⏳ 处理中...\"提示"
+      },
+      "processingHintDelay": {
+        "type": "number",
+        "default": 5,
+        "description": "发送处理中提示前的等待秒数，设为 0 则立即发送"
+      },
+      "messageFormat": {
+        "type": "string",
+        "enum": ["text", "markdown"],
+        "default": "text",
+        "description": "群聊消息格式：text（纯文本）或 markdown（富文本，不支持引用回复）"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@core-workspace/infoflow-openclaw-plugin",
+  "version": "2026.3.8",
+  "description": "OpenClaw Infoflow (如流) channel plugin for Baidu enterprise messaging",
+  "type": "module",
+  "main": "index.ts",
+  "license": "MIT",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "infoflow",
+    "baidu",
+    "chatbot",
+    "ai-agent",
+    "enterprise-messaging"
+  ],
+  "peerDependencies": {
+    "openclaw": ">=2026.3.2"
+  },
+  "dependencies": {
+    "@core-workspace/infoflow-sdk-nodejs": "^0.1.1"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "infoflow",
+      "label": "Infoflow",
+      "selectionLabel": "Infoflow (如流)",
+      "docsPath": "/channels/infoflow",
+      "blurb": "Baidu Infoflow messaging platform.",
+      "order": 40
+    },
+    "install": {
+      "npmSpec": "@core-workspace/infoflow-openclaw-plugin",
+      "defaultChoice": "npm"
+    }
+  }
+}

package/scripts/deploy.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# 部署 openclaw_infoflow 插件到本地 OpenClaw 并重启 gateway
+
+set -e
+
+PLUGIN_DIR="$HOME/.openclaw/extensions/infoflow"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+
+echo "==> 同步插件文件到 $PLUGIN_DIR"
+mkdir -p "$PLUGIN_DIR"
+rsync -av --delete "$PROJECT_DIR/" "$PLUGIN_DIR/" \
+  --exclude node_modules \
+  --exclude dist \
+  --exclude .git \
+  --exclude scripts
+
+echo "==> 安装依赖"
+cd "$PLUGIN_DIR" && npm install --silent
+
+echo "==> 重启 OpenClaw gateway"
+pkill -f "openclaw" 2>/dev/null || true
+sleep 1
+nohup openclaw gateway > /tmp/openclaw.log 2>&1 &
+sleep 2
+
+echo "==> 检查启动状态"
+if pgrep -f "openclaw" > /dev/null; then
+  echo "✓ gateway 已启动（PID: $(pgrep -f openclaw | head -1)）"
+  echo "  日志: tail -f /tmp/openclaw.log"
+else
+  echo "✗ gateway 启动失败，查看日志: cat /tmp/openclaw.log"
+  exit 1
+fi

package/skills/infoflow-dev/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: infoflow-dev
+description: 如流（Infoflow）机器人开发指南。包含如流 API 参考、消息格式、鉴权机制、OpenClaw 插件架构和配置说明。当用户需要：(1) 开发如流机器人或 OpenClaw infoflow 插件，(2) 查询如流消息 API 格式（发消息/撤回/AT/图片），(3) 了解如流配置参数（dmPolicy/groupPolicy/replyMode 等），(4) 调试如流相关问题时使用此 skill。触发场景：「如流怎么发群消息」「infoflow 插件配置」「如流 AT 消息格式」「replyMode 怎么用」「如流鉴权」。
+---
+
+# 如流（Infoflow）开发指南
+
+## 核心资料
+
+- **完整 API 参考**：[references/api.md](references/api.md)
+  - 消息格式（TEXT/MD/AT/LINK/IMAGE）
+  - 发私聊/群消息 API
+  - 消息撤回 API
+  - 鉴权（Token 获取，Bearer- 格式）
+  - Webhook 解密、限流规则、错误码
+
+## 关键速查
+
+### 鉴权格式
+```
+Authorization: Bearer-<token>   ← 注意是连字符，不是空格
+```
+
+### 发群消息端点
+```
+POST http://apiin.im.baidu.com/api/v1/robot/msg/groupmsgsend
+```
+
+### 发私聊端点
+```
+POST http://apiin.im.baidu.com/api/v1/app/message/send
+```
+
+### 消息类型
+| 类型 | 说明 |
+|------|------|
+| TEXT | 纯文本 |
+| MD | Markdown |
+| AT | @提及（atall/atuserids） |
+| LINK | 链接（仅群聊，必须单独发送） |
+| IMAGE | 图片 base64（仅群聊，必须单独发送） |
+
+> LINK 和 IMAGE 必须单独发送，不能和 TEXT/MD 混在同一请求。
+
+### 大整数精度
+messageid / msgseqid 超过 JS Number 精度（> 2^53），必须用字符串处理或手动拼 JSON：
+```typescript
+const bodyStr = `{"groupId":${groupId},"messageid":${messageid},"msgseqid":${msgseqid}}`;
+```
+
+## OpenClaw 插件配置速查
+
+### 访问控制
+| 字段 | 可选值 | 说明 |
+|------|--------|------|
+| `dmPolicy` | `open` / `pairing` / `allowlist` | 私聊策略 |
+| `groupPolicy` | `open` / `allowlist` / `disabled` | 群聊策略 |
+| `allowFrom` | string[] | 私聊白名单（uuapName） |
+| `groupAllowFrom` | string[] | 群聊白名单（群 ID 字符串） |
+
+### 回复行为
+| 字段 | 说明 |
+|------|------|
+| `replyMode` | `ignore` / `record` / `mention-only` / `mention-and-watch` / `proactive` |
+| `watchMentions` | 监控被 @ 的人，代为回复 |
+| `watchRegex` | 正则匹配消息内容触发回复 |
+| `followUp` | 回复后继续监听跟进问题（默认 true） |
+| `followUpWindow` | 跟进窗口秒数（默认 300） |
+
+### 消息格式
+| 字段 | 说明 |
+|------|------|
+| `messageFormat` | `text`（默认）或 `markdown`（群聊，不支持 replyTo） |
+| `processingHint` | 处理中提示（默认 true） |
+| `processingHintDelay` | 提示延迟秒数（默认 5） |
+
+## 调试建议
+
+```bash
+# 查看最新日志
+tail -200 ~/.openclaw/logs/gateway.log | grep -E "(infoflow|ERROR)"
+
+# 部署插件
+rsync -av --exclude='.git' --exclude='node_modules' . ~/.openclaw/extensions/infoflow/
+openclaw gateway restart
+```
+
+遇到问题先查 [references/api.md](references/api.md) 确认请求格式和错误码。