dlinkclaw-openclaw 1.0.0

package/ext_capabilities/workrelay-transcribe/status.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# WorkRelay 语音转录状态检查
+# 返回值: 0=已启用, 1=未安装, 2=部分安装, 3=配置缺失
+# 同时输出 JSON 给客户端解析
+
+set -e
+
+STATUS_OK=0
+STATUS_NOT_INSTALLED=1
+STATUS_PARTIAL=2
+STATUS_CONFIG_MISSING=3
+
+INSTALL_DIR="${WR_INSTALL_DIR:-$HOME/.workrelay/transcribe}"
+MODEL_CACHE="${WR_WHISPER_CACHE:-$HOME/.cache/faster-whisper}"
+
+checks=()
+
+# 检查1: faster-whisper 包
+check_dep=0
+python3 -c "import faster_whisper" 2>/dev/null && check_dep=1 || true
+
+# 检查2: 模型（small 模型 ~460MB，阈值从 500 降到 200，避免误报未下载）
+check_model=0
+if [ -d "$MODEL_CACHE" ]; then
+  model_size=$(du -sm "$MODEL_CACHE" 2>/dev/null | cut -f1 || echo 0)
+  [ "$model_size" -gt 200 ] && check_model=1
+fi
+
+# 检查3: 脚本
+check_scripts=0
+[ -f "$INSTALL_DIR/transcribe.py" ] && [ -f "$INSTALL_DIR/voicebox-transcribe.sh" ] && check_scripts=1
+
+# 检查4: OpenClaw 配置（2026-09-14 openclaw 升级后：1) config 路径变更 audio.transcription.* → tools.media.models；2) 不再调 openclaw CLI——升级后 CLI 可能挂起卡住插件队列，改为直接读 openclaw.json，毫秒级返回）
+check_config=0
+OC_JSON="${OPENCLAW_HOME:-$HOME/.openclaw}/openclaw.json"
+if [ -f "$OC_JSON" ]; then
+  grep -q 'voicebox-transcribe' "$OC_JSON" && check_config=1 || true
+fi
+
+# ── 汇总状态 ──
+total=$((check_dep + check_model + check_scripts + check_config))
+
+case $total in
+  4) status="enabled";  desc="语音转录已启用"; exit_code=$STATUS_OK ;;
+  0) status="disabled"; desc="未安装";          exit_code=$STATUS_NOT_INSTALLED ;;
+  *) status="partial";  desc="部分安装";        exit_code=$STATUS_PARTIAL ;;
+esac
+
+# ── 输出 JSON ──
+cat <<EOF
+{
+  "status": "$status",
+  "description": "$desc",
+  "checks": {
+    "faster_whisper": $([ $check_dep -eq 1 ] && echo true || echo false),
+    "model": $([ $check_model -eq 1 ] && echo true || echo false),
+    "scripts": $([ $check_scripts -eq 1 ] && echo true || echo false),
+    "openclaw_config": $([ $check_config -eq 1 ] && echo true || echo false)
+  }
+}
+EOF
+
+exit $exit_code

package/ext_capabilities/workrelay-transcribe/transcribe.py

@@ -0,0 +1,56 @@
+#!/usr/bin/env python3
+"""WorkRelay 语音转录引擎 - 基于 faster-whisper."""
+
+import sys
+import os
+from faster_whisper import WhisperModel
+
+MODEL_NAME = os.environ.get("WR_WHISPER_MODEL", "small")
+MODEL = None
+MODEL_CACHE = os.environ.get(
+    "WR_WHISPER_CACHE",
+    os.path.join(os.path.expanduser("~"), ".cache", "faster-whisper"),
+)
+
+
+def load_model():
+    global MODEL
+    MODEL = WhisperModel(
+        MODEL_NAME,
+        device="cpu",
+        compute_type="int8",
+        download_root=MODEL_CACHE,
+    )
+    print(f"[WorkRelay] Whisper model '{MODEL_NAME}' loaded", file=sys.stderr)
+
+
+def transcribe(audio_path: str, language: str = "zh") -> str:
+    if MODEL is None:
+        load_model()
+    segments, info = MODEL.transcribe(
+        audio_path,
+        language=language,
+        beam_size=5,
+        vad_filter=True,
+    )
+    return " ".join(s.text.strip() for s in segments)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: transcribe.py <audio_file> [language]", file=sys.stderr)
+        sys.exit(1)
+
+    audio_file = sys.argv[1]
+    lang = sys.argv[2] if len(sys.argv) > 2 else "zh"
+
+    if not os.path.isfile(audio_file):
+        print(f"ERROR: file not found: {audio_file}", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        result = transcribe(audio_file, lang)
+        print(result.strip())
+    except Exception as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        sys.exit(1)

package/ext_capabilities/workrelay-transcribe/transcribe_server.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""WorkRelay 语音转录常驻服务（2026-08-12）
+faster-whisper 模型加载一次后常驻内存，避免每次转写重复加载模型（省 3-5 秒）。
+HTTP 接口：
+  POST /transcribe  multipart/form-data: file=<audio>
+  GET  /health      健康检查
+启动：python3 transcribe_server.py [port]   （默认 17890）
+"""
+import sys
+import os
+import json
+import tempfile
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+from urllib.parse import urlparse
+
+from faster_whisper import WhisperModel
+
+PORT = int(os.environ.get("WR_WHISPER_PORT", "17890"))
+MODEL_NAME = os.environ.get("WR_WHISPER_MODEL", "small")
+MODEL_CACHE = os.environ.get(
+    "WR_WHISPER_CACHE",
+    os.path.join(os.path.expanduser("~"), ".cache", "faster-whisper"),
+)
+LANGUAGE = os.environ.get("WR_WHISPER_LANG", "zh")
+
+_model = None
+
+
+def get_model():
+    global _model
+    if _model is None:
+        _model = WhisperModel(
+            MODEL_NAME,
+            device="cpu",
+            compute_type="int8",
+            download_root=MODEL_CACHE,
+        )
+    return _model
+
+
+class Handler(BaseHTTPRequestHandler):
+    def log_message(self, fmt, *args):  # 安静模式
+        pass
+
+    def _send_json(self, code: int, obj: dict):
+        body = json.dumps(obj, ensure_ascii=False).encode("utf-8")
+        self.send_response(code)
+        self.send_header("Content-Type", "application/json; charset=utf-8")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+    def do_GET(self):
+        path = urlparse(self.path).path
+        if path == "/health":
+            self._send_json(200, {"status": "ok", "model": MODEL_NAME})
+        else:
+            self._send_json(404, {"error": "not found"})
+
+    def do_POST(self):
+        path = urlparse(self.path).path
+        if path != "/transcribe":
+            self._send_json(404, {"error": "not found"})
+            return
+        try:
+            # 解析 multipart（只取第一个 file 字段）
+            content_type = self.headers.get("Content-Type", "")
+            boundary = None
+            if "boundary=" in content_type:
+                boundary = content_type.split("boundary=")[1].strip().strip('"')
+            if not boundary:
+                self._send_json(400, {"error": "missing boundary"})
+                return
+
+            body = self.rfile.read(int(self.headers.get("Content-Length", "0")))
+            # 极简 multipart 解析：按 boundary 切块，找 filename + 内容
+            parts = body.split(b"--" + boundary.encode())
+            audio_data = None
+            for part in parts:
+                if b'filename="' in part and b"\r\n\r\n" in part:
+                    _, data = part.split(b"\r\n\r\n", 1)
+                    audio_data = data.rstrip(b"\r\n--")
+                    break
+            if audio_data is None:
+                self._send_json(400, {"error": "no file part"})
+                return
+
+            with tempfile.NamedTemporaryFile(suffix=".webm", delete=False) as tmp:
+                tmp.write(audio_data)
+                tmp_path = tmp.name
+            try:
+                model = get_model()
+                segments, _info = model.transcribe(
+                    tmp_path, language=LANGUAGE, beam_size=5, vad_filter=True
+                )
+                text = " ".join(s.text.strip() for s in segments)
+                self._send_json(200, {"text": text})
+            finally:
+                try:
+                    os.remove(tmp_path)
+                except OSError:
+                    pass
+        except Exception as e:  # noqa: BLE001
+            self._send_json(500, {"error": str(e)})
+
+
+def main():
+    server = ThreadingHTTPServer(("127.0.0.1", PORT), Handler)
+    # 先加载模型（启动即常驻）
+    get_model()
+    print(f"[WorkRelay] whisper server ready: http://127.0.0.1:{PORT} model={MODEL_NAME}", flush=True)
+    server.serve_forever()
+
+
+if __name__ == "__main__":
+    main()

package/ext_capabilities/workrelay-transcribe/voicebox-transcribe.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# WorkRelay 语音转录桥接脚本
+# 优先本地 faster-whisper 常驻服务（模型常驻内存，免重复加载），服务不可用时回退直接转写
+# 环境变量：
+#   WR_WHISPER_HOST   - 常驻服务地址（默认 127.0.0.1）
+#   WR_WHISPER_PORT   - 常驻服务端口（默认 17890）
+#   WR_WHISPER_MODEL  - 本地模型名（默认 small）
+#   WR_FALLBACK_URL   - 远程转录服务 URL（可选，不设则仅本地）
+
+set -e
+
+AUDIO_FILE="$1"
+SCRIPT_DIR="$(dirname "$(readlink -f "$0")")"
+
+if [ ! -f "$AUDIO_FILE" ]; then
+  echo "ERROR: audio file not found: $AUDIO_FILE" >&2
+  exit 1
+fi
+
+WH_HOST="${WR_WHISPER_HOST:-127.0.0.1}"
+WH_PORT="${WR_WHISPER_PORT:-17890}"
+
+# ── 第1步：常驻服务（模型常驻内存，转写快）──
+result=$(curl -s --connect-timeout 2 --max-time 60 \
+  -X POST "http://${WH_HOST}:${WH_PORT}/transcribe" \
+  -F "file=@${AUDIO_FILE}" 2>/dev/null)
+if [ -n "$result" ]; then
+  text=$(echo "$result" | python3 -c "
+import sys, json
+try:
+    data = json.load(sys.stdin)
+    if data.get('text'):
+        print(data['text'].strip())
+    else:
+        print('ERROR: ' + str(data.get('error', 'unknown')))
+except Exception:
+    print('ERROR: bad response')
+" 2>/dev/null)
+  if [ -n "$text" ] && [[ "$text" != ERROR:* ]]; then
+    echo "$text"
+    exit 0
+  fi
+fi
+
+# ── 第2步：直接本地 faster-whisper（常驻服务未启动时的回退）──
+result=$(python3 "$SCRIPT_DIR/transcribe.py" "$AUDIO_FILE" 2>/tmp/wr-transcribe-err.log)
+exit_code=$?
+
+if [ $exit_code -eq 0 ] && [ -n "$result" ]; then
+  # 排除以 ERROR: 开头的输出（有些 Python 错误仍返回 exit 0）
+  if [[ "$result" != ERROR:* ]]; then
+    echo "$result"
+    exit 0
+  fi
+fi
+
+# 本地失败日志
+cat /tmp/wr-transcribe-err.log >&2
+rm -f /tmp/wr-transcribe-err.log
+
+# ── 第3步：远程 fallback（如果配置了） ──
+if [ -n "${WR_FALLBACK_URL:-}" ]; then
+  result=$(curl -s --connect-timeout 5 --max-time 60 \
+    -X POST "$WR_FALLBACK_URL" \
+    -F "file=@${AUDIO_FILE}" \
+    -F "language=zh" 2>&1)
+
+  # 尝试解析 JSON 响应
+  text=$(echo "$result" | python3 -c "
+import sys, json
+try:
+    data = json.load(sys.stdin)
+    for key in ('text','transcript','result'):
+        if data.get(key):
+            print(data[key].strip())
+            break
+except:
+    pass
+" 2>/dev/null)
+
+  if [ -n "$text" ]; then
+    echo "$text"
+    exit 0
+  fi
+fi
+
+echo "ERROR: transcription failed (local whisper + remote fallback both failed)" >&2
+exit 1

package/openclaw.plugin.json

@@ -0,0 +1,142 @@
+{
+  "id": "dlink",
+  "channels": [
+    "dlink"
+  ],
+  "skills": [
+    "./skills"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "朵联 apiKey"
+      },
+      "baseUrl": {
+        "type": "string",
+        "description": "朵联回调URL",
+        "default": "https://your-dlink-server.example.com"
+      },
+      "secret": {
+        "type": "string",
+        "description": "朵联签名密钥"
+      },
+      "enabled": {
+        "type": "boolean",
+        "default": true
+      },
+      "accountId": {
+        "type": "string",
+        "description": "账号标识",
+        "default": "default"
+      },
+      "mediaMaxMb": {
+        "type": "number",
+        "description": "媒体大小上限(MB)，OpenClaw 核心出站媒体校验读取，默认 100",
+        "default": 100
+      }
+    }
+  },
+  "setup": {
+    "requiresRuntime": true,
+    "prompts": [
+      {
+        "name": "apiKey",
+        "type": "input",
+        "message": "请输入朵联 API Key:",
+        "validate": "required"
+      },
+      {
+        "name": "secret",
+        "type": "input",
+        "message": "请输入朵联签名密钥:",
+        "validate": "required"
+      },
+      {
+        "name": "baseUrl",
+        "type": "input",
+        "message": "请输入朵联回调地址:",
+        "default": "https://your-dlink-server.example.com",
+        "validate": "required"
+      },
+      {
+        "name": "accountId",
+        "type": "input",
+        "message": "请输入账号标识（默认: default）:",
+        "default": "default"
+      },
+      {
+        "name": "enabled",
+        "type": "confirm",
+        "message": "是否立即启用朵联通道？",
+        "default": true
+      }
+    ]
+  },
+  "channelConfigs": {
+    "dlink": {
+      "schema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "apiKey": {
+            "type": "string",
+            "description": "朵联 apiKey"
+          },
+          "baseUrl": {
+            "type": "string",
+            "description": "朵联回调URL",
+            "default": "https://your-dlink-server.example.com"
+          },
+          "secret": {
+            "type": "string",
+            "description": "朵联签名密钥"
+          },
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "accountId": {
+            "type": "string",
+            "description": "账号标识",
+            "default": "default"
+          },
+          "mediaMaxMb": {
+            "type": "number",
+            "description": "媒体大小上限(MB)，OpenClaw 核心出站媒体校验读取，默认 100",
+            "default": 100
+          }
+        }
+      },
+      "label": "朵联 DLinkClaw",
+      "description": "朵联 DLinkClaw OpenClaw 接入通道",
+      "commands": {
+        "nativeCommandsAutoEnabled": false
+      },
+      "uiHints": {
+        "apiKey": {
+          "label": "API Key",
+          "help": "朵联平台的 API 密钥，在朵联控制台获取",
+          "placeholder": "请输入 API Key",
+          "sensitive": true
+        },
+        "secret": {
+          "label": "签名密钥",
+          "help": "朵联平台的签名密钥，用于消息加解密与签名认证",
+          "placeholder": "请输入签名密钥",
+          "sensitive": true
+        },
+        "baseUrl": {
+          "label": "回调地址",
+          "help": "朵联消息回调的服务器地址",
+          "placeholder": "https://your-dlink-server.example.com"
+        },
+        "enabled": {
+          "label": "启用通道"
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "dlinkclaw-openclaw",
+  "version": "1.0.0",
+  "description": "DLinkClaw OpenClaw channel plugin — 朵联 OpenClaw 接入通道",
+  "keywords": [
+    "DLinkClaw",
+    "openclaw",
+    "朵联",
+    "钉钉",
+    "QQ",
+    "企业微信",
+    "飞书"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && terser dist/index.js --output dist/index.js --compress --mangle --module",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "author": "rock.chen<szygnet@qq.com>",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "main": "./index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    "ext_capabilities",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "axios": "^1.15.2",
+    "file-type": "^21.3.1",
+    "form-data": "^4.0.5",
+    "mime-types": "^3.0.2",
+    "mqtt": "^5.10.0",
+    "qrcode-terminal": "^0.12.0",
+    "uuid": "^14.0.2",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^3.0.1",
+    "@types/ws": "^8.18.1",
+    "terser": "^5.46.1",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.9.1"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "installDependencies": true,
+    "channel": {
+      "id": "dlink",
+      "label": "朵联 DLinkClaw",
+      "selectionLabel": "朵联(DLinkClaw)",
+      "docsPath": "/channels/dlinkclaw-openclaw",
+      "docsLabel": "dlinkclaw-openclaw",
+      "blurb": "朵联 DLinkClaw OpenClaw 接入通道, 本地部署连接朵联客户端, 支持企业微信、QQ、钉钉、飞书, 无需公网IP.",
+      "aliases": [
+        "dlink",
+        "DLinkClaw",
+        "朵联"
+      ],
+      "order": 90,
+      "quickstartAllowFrom": true,
+      "isDebug": false,
+      "preferSessionLookupForAnnounceTarget": true
+    },
+    "install": {
+      "npmSpec": "dlinkclaw-openclaw",
+      "localPath": "extensions/dlinkclaw-openclaw",
+      "defaultChoice": "npm"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dlinkclaw/dlinkclaw-openclaw-channel.git"
+  },
+  "homepage": "https://github.com/dlinkclaw/dlinkclaw-openclaw-channel#readme",
+  "bugs": {
+    "url": "https://github.com/dlinkclaw/dlinkclaw-openclaw-channel/issues"
+  }
+}