@youdu/openclaw-youdu 2026.3.25

package/dist/src/channel.d.ts

@@ -0,0 +1,3 @@
+import { type ChannelPlugin } from "openclaw/plugin-sdk/core";
+import { type ResolvedYouDuAccount } from './utils.js';
+export declare const youduPlugin: ChannelPlugin<ResolvedYouDuAccount>;

package/dist/src/const.d.ts

@@ -0,0 +1,29 @@
+import * as https from "node:https";
+/** 渠道 ID */
+export declare const CHANNEL_ID: "youdu";
+export declare const DEFAULT_DM_POLICY = "pairing";
+export declare const WEBSOCKET_SCHEME = "wss://";
+export declare const HTTP_SCHEME = "https://";
+export declare const PORT = 7443;
+export declare const WS_URL = "/cgi/bot/wss";
+export declare const DOWNLOAD_MEDIA_URL = "/cgi/bot/file/download";
+export declare const UPLOAD_MEDIA_URL = "/cgi/bot/file/upload";
+export declare const agent: https.Agent;
+/** 文本分块大小上限 */
+export declare const TEXT_CHUNK_LIMIT = 4000;
+/** WebSocket 心跳间隔（毫秒） */
+export declare const WS_HEARTBEAT_INTERVAL_MS = 30000;
+/** WebSocket 最大重连次数 */
+export declare const WS_MAX_RECONNECT_ATTEMPTS = 10;
+/** 消息处理总超时时间（毫秒） */
+export declare const MESSAGE_PROCESS_TIMEOUT_MS: number;
+/** "思考中"流式消息占位内容 */
+export declare const THINKING_MESSAGE = "<think></think>";
+/** 消息状态清理间隔（毫秒） */
+export declare const MESSAGE_STATE_CLEANUP_INTERVAL_MS = 60000;
+/** 仅包含图片时的消息占位符 */
+export declare const MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
+/** 仅包含文件时的消息占位符 */
+export declare const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
+/** 最大的媒体传输大小 */
+export declare const DEFAULT_MEDIA_MAX_SIZE: number;

package/dist/src/dm-policy.d.ts

@@ -0,0 +1,24 @@
+import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
+import type { ResolvedYouDuAccount } from "./utils.js";
+import { WSClient, WsFrame } from "./sdk/ws-client";
+/**
+ * DM Policy 检查结果
+ */
+export interface DmPolicyCheckResult {
+    /** 是否允许继续处理消息 */
+    allowed: boolean;
+    /** 是否已发送配对消息（仅在 pairing 模式下） */
+    pairingSent?: boolean;
+}
+/**
+ * 检查 DM Policy 访问控制
+ * @returns 检查结果，包含是否允许继续处理
+ */
+export declare function checkDmPolicy(params: {
+    senderId: string;
+    isGroup: boolean;
+    account: ResolvedYouDuAccount;
+    wsClient: WSClient;
+    frame: WsFrame;
+    runtime: RuntimeEnv;
+}): Promise<DmPolicyCheckResult>;

package/dist/src/group-policy.d.ts

@@ -0,0 +1,25 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
+import type { ResolvedYouDuAccount } from "./utils";
+/**
+ * 群组策略检查结果
+ */
+export interface GroupPolicyCheckResult {
+    /** 是否允许继续处理消息 */
+    allowed: boolean;
+}
+/**
+ * 检查群组策略访问控制
+ * @returns 检查结果，包含是否允许继续处理
+ */
+export declare function checkGroupPolicy(params: {
+    chatId: string;
+    senderId: string;
+    account: ResolvedYouDuAccount;
+    config: OpenClawConfig;
+    runtime: RuntimeEnv;
+}): GroupPolicyCheckResult;
+/**
+ * 检查发送者是否在允许列表中（通用）
+ */
+export declare function isSenderAllowed(senderId: string, allowFrom: string[]): boolean;

package/dist/src/media.d.ts

@@ -0,0 +1,64 @@
+import type { ResolvedYouDuAccount, YouDuConfig } from './utils.js';
+import { WSClient, WsFrame } from "./sdk/ws-client";
+import { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
+export interface YouDuMediaBody {
+    mediaId?: string;
+    name?: string;
+    size?: number;
+    width?: number;
+    height?: number;
+    duration?: number;
+    contentType?: string;
+}
+export interface InboundMediaAttachment extends YouDuMediaBody {
+    kind: 'image' | 'file' | 'audio' | 'video';
+}
+export interface DownloadedInboundMedia {
+    path: string;
+    contentType?: string;
+}
+export interface UploadAndSendMediaOptions {
+    wsClient: WSClient;
+    account: ResolvedYouDuAccount;
+    mediaUrl: string;
+    frame: WsFrame;
+    mediaLocalRoots?: readonly string[];
+    runtime: RuntimeEnv;
+}
+export declare function inferInboundMessageText(body: {
+    text?: {
+        content?: string;
+    };
+    media?: Array<YouDuMediaBody & {
+        kind?: string;
+    }>;
+    image?: YouDuMediaBody;
+    file?: YouDuMediaBody;
+    audio?: YouDuMediaBody;
+    video?: YouDuMediaBody;
+}): string;
+export declare function extractInboundMedia(body: {
+    media?: Array<YouDuMediaBody & {
+        kind?: string;
+    }>;
+    image?: YouDuMediaBody;
+    file?: YouDuMediaBody;
+    audio?: YouDuMediaBody;
+    video?: YouDuMediaBody;
+}): InboundMediaAttachment[];
+export declare function uploadAndSendMedia(options: UploadAndSendMediaOptions): Promise<void>;
+export declare function uploadOutboundMedia(params: {
+    account: ResolvedYouDuAccount;
+    mediaUrl: string;
+    mediaLocalRoots?: readonly string[];
+    preferredKind?: InboundMediaAttachment['kind'];
+    token?: string;
+}): Promise<InboundMediaAttachment>;
+export declare function buildYouDuMediaMessageBody(media: InboundMediaAttachment): Record<string, unknown>;
+export declare function downloadInboundMedia(params: {
+    account: ResolvedYouDuAccount;
+    attachments: InboundMediaAttachment[];
+    messageId: string;
+    config: YouDuConfig;
+    token?: string;
+}): Promise<Array<DownloadedInboundMedia>>;

package/dist/src/message-sender.d.ts

@@ -0,0 +1,18 @@
+import { RuntimeEnv } from 'openclaw/plugin-sdk/runtime-env';
+import { WSClient, WsFrame } from './sdk/ws-client';
+import { InboundMediaAttachment } from "./media";
+/**
+ * 发送 YouDu 回复
+ */
+export declare function sendYouDuReply(params: {
+    wsClient: WSClient;
+    frame: WsFrame;
+    text: string;
+    runtime: RuntimeEnv;
+}): Promise<void>;
+export declare function sendYouDuMediaReply(params: {
+    wsClient: WSClient;
+    frame: WsFrame;
+    mediaAttachment: InboundMediaAttachment;
+    runtime: RuntimeEnv;
+}): Promise<void>;

package/dist/src/monitor.d.ts

@@ -0,0 +1,44 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";
+import { ResolvedYouDuAccount } from './utils.js';
+import { type YouDuMediaBody } from './media.js';
+/**
+ * 消息体类型（待用户完善）
+ */
+export interface YouDuMessageBody {
+    msgid: string;
+    chattype: 'single' | 'group';
+    chatid: string;
+    from: {
+        userid: string;
+        account: string;
+        name: string;
+    };
+    create_time?: number;
+    response_url?: string;
+    msgtype: string;
+    text?: {
+        content: string;
+    };
+    image?: YouDuMediaBody;
+    file?: YouDuMediaBody;
+    audio?: YouDuMediaBody;
+    video?: YouDuMediaBody;
+    media?: Array<YouDuMediaBody & {
+        kind?: string;
+    }>;
+    [key: string]: any;
+}
+/**
+ * 监控器选项
+ */
+export interface YouDuMonitorOptions {
+    account: ResolvedYouDuAccount;
+    config: OpenClawConfig;
+    runtime: RuntimeEnv;
+    abortSignal?: AbortSignal;
+}
+/**
+ * 监听 YouDu WebSocket 连接（主函数）
+ */
+export declare function monitorYouDuProvider(options: YouDuMonitorOptions): Promise<void>;

package/dist/src/onboarding.d.ts

@@ -0,0 +1,4 @@
+import type { ChannelSetupWizard } from "openclaw/plugin-sdk/setup";
+import type { ChannelSetupAdapter } from "openclaw/plugin-sdk/setup";
+export declare const youduSetupAdapter: ChannelSetupAdapter;
+export declare const youduSetupWizard: ChannelSetupWizard;

package/dist/src/openclaw-compat.d.ts

@@ -0,0 +1,44 @@
+export declare const DEFAULT_ACCOUNT_ID = "default";
+/** 与 openclaw plugin-sdk 中 WebMediaResult 兼容的类型 */
+export type WebMediaResult = {
+    buffer: Buffer;
+    contentType?: string;
+    kind?: string;
+    fileName?: string;
+};
+export type OutboundMediaLoadOptions = {
+    maxBytes?: number;
+    mediaLocalRoots?: readonly string[];
+};
+export type DetectMimeOptions = {
+    buffer?: Buffer;
+    headerMime?: string | null;
+    filePath?: string;
+};
+/**
+ * 从 URL 或本地路径加载媒体文件（兼容入口）
+ *
+ * 优先使用 SDK 版本，不可用时使用 fallback。
+ * SDK 版本抛出的业务异常（如 LocalMediaAccessError）会直接透传。
+ */
+export declare function loadOutboundMediaFromUrl(mediaUrl: string, options?: OutboundMediaLoadOptions): Promise<WebMediaResult>;
+/**
+ * 向 allowFrom 列表添加通配符 "*"（兼容入口）
+ *
+ * 当 dmPolicy 为 "open" 时，需要确保 allowFrom 中包含 "*" 以允许所有来源。
+ * 优先使用 SDK 版本（plugin-sdk/setup 或 plugin-sdk/core），不可用时使用 fallback。
+ *
+ * 注意：此函数为同步函数，与 SDK 原始签名一致。
+ * SDK 引用在模块加载时异步探测并缓存，调用时同步读取缓存。
+ */
+export declare function addWildcardAllowFrom(allowFrom: string[]): string[];
+export declare function emptyPluginConfigSchema(): Record<string, unknown>;
+/**
+ * 格式化配对审批提示信息（参考 moltbot 实现）
+ * @param channelId 频道ID
+ * @returns 配对审批提示字符串
+ */
+export declare function formatPairingApproveHint(channelId: string): string;
+/** 解析 openclaw 状态目录 */
+export declare function resolveStateDir(): string;
+export declare function getDefaultMediaLocalRoots(): Promise<readonly string[]>;

package/dist/src/runtime.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 运行时管理
+ */
+import type { PluginRuntime } from "openclaw/plugin-sdk/core";
+export declare function setYouDuRuntime(r: PluginRuntime): void;
+export declare function getYouDuRuntime(): PluginRuntime;

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

@@ -0,0 +1,46 @@
+/**
+ * 日志接口
+ */
+export interface Logger {
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+/**
+ * WebSocket 帧结构
+ */
+export interface WsFrame<T = any> {
+    cmd?: string;
+    headers: {
+        reqId: string;
+        [key: string]: any;
+    };
+    body?: T;
+    errCode?: number;
+    errMsg?: string;
+}
+/**
+ * 客户端配置选项
+ */
+export interface WSClientOptions {
+    botId: string;
+    secret: string;
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    heartbeatInterval?: number;
+    requestTimeout?: number;
+    wsUrl?: string;
+    logger?: Logger;
+}
+/**
+ * 客户端事件映射
+ */
+export interface WSClientEventMap {
+    connected: () => void;
+    authenticated: () => void;
+    disconnected: (reason: string) => void;
+    reconnecting: (attempt: number) => void;
+    error: (error: Error) => void;
+    message: (frame: WsFrame) => void;
+}

package/dist/src/sdk/ws-client.d.ts

@@ -0,0 +1,20 @@
+import { EventEmitter } from "events";
+import { WsCmd, DefaultLogger } from "./ws-utils";
+import type { WsFrame, WSClientOptions } from "./types";
+/**
+ * YouDu WebSocket 客户端
+ */
+export declare class WSClient extends EventEmitter {
+    private options;
+    private wsManager;
+    private logger;
+    private started;
+    constructor(options: WSClientOptions);
+    private setupWsEvents;
+    connect(): this;
+    disconnect(): void;
+    reply(frame: WsFrame, body: any, cmd?: string): Promise<WsFrame>;
+    getToken(): string;
+}
+export type { Logger, WsFrame, WSClientOptions, WSClientEventMap, } from "./types";
+export { DefaultLogger, WsCmd };

package/dist/src/sdk/ws-manager.d.ts

@@ -0,0 +1,63 @@
+import { EventEmitter } from "events";
+import type { Logger, WsFrame } from "./types";
+/**
+ * WebSocket 长连接管理器
+ */
+export declare class WsConnectionManager extends EventEmitter {
+    private ws;
+    private logger;
+    private wsUrl;
+    private heartbeatInterval;
+    private heartbeatTimer;
+    private maxReconnectAttempts;
+    private reconnectAttempts;
+    private isManualClose;
+    /** 认证凭证 */
+    private botId;
+    private botSecret;
+    private token;
+    private hasAuthenticated;
+    /** 连续未收到心跳响应的次数 */
+    private missedPongCount;
+    private readonly maxMissedPong;
+    private reconnectBaseDelay;
+    private readonly reconnectMaxDelay;
+    /** 回复队列 */
+    private replyQueues;
+    private pendingAcks;
+    private readonly replyAckTimeout;
+    private readonly maxReplyQueueSize;
+    constructor(logger: Logger, heartbeatInterval?: number, reconnectBaseDelay?: number, maxReconnectAttempts?: number, wsUrl?: string);
+    setCredentials(botId: string, botSecret: string): void;
+    getToken(): string;
+    connect(): void;
+    private setupEventHandlers;
+    private sendAuth;
+    private handleFrame;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private sendHeartbeat;
+    private scheduleReconnect;
+    send(frame: WsFrame): void;
+    sendReply(reqId: string, body: any, cmd?: string): Promise<WsFrame>;
+    private processReplyQueue;
+    private handleReplyAck;
+    private clearPendingMessages;
+    /**
+     * 断开 WebSocket 连接（主动断开）
+     *
+     * 此方法会清除 token 和认证状态，下次连接时将使用 bot_id + secret 重新认证。
+     *
+     * 注意：被动断线（网络问题、服务端断开）不会调用此方法，会保留 token 并使用 reconnect 快速恢复。
+     *
+     * @example
+     * // 主动断开，下次使用 bot_id + secret 重新认证
+     * wsClient.disconnect();
+     *
+     * // 如果想保留 token（不推荐，因为 disconnect 已自动清除）
+     * // 被动断线会自动保留 token，无需额外操作
+     */
+    disconnect(): void;
+    /** 清除认证状态，强制下次连接使用 bot_id + secret 重新认证 */
+    clearAuth(): void;
+}

package/dist/src/sdk/ws-utils.d.ts

@@ -0,0 +1,38 @@
+import type { Logger } from "./types";
+/** WebSocket 命令常量 */
+export declare enum WsCmd {
+    /** 认证订阅（首次认证） */
+    SUBSCRIBE = "subscribe",
+    /** 断线重连认证 */
+    RECONNECT = "reconnect",
+    /** 心跳 */
+    HEARTBEAT = "ping",
+    /** 消息回调 */
+    CALLBACK = "msg_callback",
+    /** 事件回调 */
+    EVENT_CALLBACK = "event_callback",
+    /** 回复消息 */
+    RESPONSE = "respond_msg",
+    /** 主动发送消息 */
+    SEND_MSG = "send_msg"
+}
+/**
+ * 生成随机字符串
+ */
+export declare function generateRandomString(length?: number): string;
+/**
+ * 生成唯一请求 ID
+ */
+export declare function generateReqId(prefix: string): string;
+/**
+ * 默认日志实现
+ */
+export declare class DefaultLogger implements Logger {
+    private prefix;
+    constructor(prefix?: string);
+    private formatTime;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}

package/dist/src/state-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 状态管理器
+ * 管理 WebSocket 连接和消息状态
+ */
+import type { WSClient } from './sdk/ws-client.js';
+/** 消息状态 */
+export interface MessageState {
+    accumulatedText: string;
+    streamId: string;
+    mediaUrls?: string[];
+    hasText?: boolean;
+    hasMedia?: boolean;
+    hasMediaFailed?: boolean;
+    deliverCalled?: boolean;
+    mediaErrorSummary?: string;
+}
+/**
+ * 设置账户的 WebSocket 客户端
+ */
+export declare function setYouDuWebSocket(accountId: string, wsClient: WSClient): void;
+/**
+ * 获取账户的 WebSocket 客户端
+ */
+export declare function getYouDuWebSocket(accountId: string): WSClient | null;
+/**
+ * 设置消息状态
+ */
+export declare function setMessageState(messageId: string, state: MessageState): void;
+/**
+ * 获取消息状态
+ */
+export declare function getMessageState(messageId: string): MessageState | undefined;
+/**
+ * 删除消息状态
+ */
+export declare function deleteMessageState(messageId: string): void;
+/**
+ * 启动消息状态定期清理
+ */
+export declare function startMessageStateCleanup(): void;
+/**
+ * 停止消息状态清理
+ */
+export declare function stopMessageStateCleanup(): void;
+/**
+ * 清理账户相关状态
+ */
+export declare function cleanupAccount(accountId: string): Promise<void>;

package/dist/src/utils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 配置和工具函数
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+/**
+ * 有度渠道配置
+ */
+export interface YouDuConfig {
+    botId?: string;
+    secret?: string;
+    name?: string;
+    enabled?: boolean;
+    url?: string;
+    /**
+     * 控制谁可以向 bot 发消息
+     * "pairing"（默认）：未知发送者会收到一次性配对码以供批准
+     * "allowlist"：仅允许 allowFrom（或已配对允许存储）中的发送者
+     * "open"：允许所有入站私信（需要 allowFrom: ["*"]）
+     * "disabled"：忽略所有私信
+     */
+    dmPolicy?: 'pairing' | 'open' | 'allowlist' | 'disabled';
+    allowFrom?: string[];
+    /** 群组访问策略："open" = 允许所有群组（默认），"allowlist" = 仅允许 groupAllowFrom 中的群组，"disabled" = 禁用群组消息 */
+    groupPolicy?: 'open' | 'allowlist' | 'disabled';
+    /** 群组白名单（仅 groupPolicy="allowlist" 时生效） */
+    groupAllowFrom?: string[];
+    /** 是否发送"思考中"消息，默认为 true */
+    sendThinkingMessage?: boolean;
+    /** 每个群组的详细配置（如群组内发送者白名单） */
+    groups?: Record<string, YouDuGroupConfig>;
+    /** Maximum inbound media file size in MB */
+    mediaMaxMb?: number;
+    /** 额外允许访问的本地媒体路径白名单（支持 ~ 表示 home 目录），如 ["~/Downloads", "~/Documents"] */
+    mediaLocalRoots?: string[];
+}
+/**
+ * 解析后的有度账户配置
+ */
+export interface ResolvedYouDuAccount {
+    accountId: string;
+    name: string;
+    enabled: boolean;
+    botId: string;
+    secret: string;
+    url: string;
+    sendThinkingMessage: boolean;
+    config: YouDuConfig;
+}
+export interface YouDuGroupConfig {
+    /** 群组内发送者白名单（仅列表中的成员消息会被处理） */
+    allowFrom?: Array<string | number>;
+}
+/**
+ * 解析有度账户配置
+ */
+export declare function resolveYouDuAccount(cfg: OpenClawConfig): ResolvedYouDuAccount;
+/**
+ * 设置有度账户配置
+ */
+export declare function setYouDuAccount(cfg: OpenClawConfig, account: Partial<YouDuConfig>): OpenClawConfig;

package/openclaw.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "openclaw-youdu",
+  "channels": ["youdu"],
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@youdu/openclaw-youdu",
+  "version": "2026.3.25",
+  "type": "module",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rmdir /s /q dist",
+    "prebuild": "npm run clean"
+  },
+  "keywords": [
+    "youdu",
+    "openclaw",
+    "openclaw-youdu"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/youdu/openclaw-youdu.git"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.esm.js"
+    ],
+    "channel": {
+      "id": "youdu",
+      "label": "有度",
+      "selectionLabel": "有度 (YouDu)",
+      "docsPath": "/channels/youdu",
+      "docsLabel": "openclaw-youdu",
+      "blurb": "有度机器人接入插件",
+      "order": 80,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@youdu/openclaw-youdu",
+      "localPath": "extensions/openclaw-youdu",
+      "defaultChoice": "npm"
+    }
+  },
+  "dependencies": {
+    "axios": "1.14.0",
+    "form-data": "^4.0.5",
+    "ws": "^8.14.2"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "openclaw": "2026.3.22",
+    "rollup": "^4.9.6",
+    "rollup-plugin-copy": "^3.5.0",
+    "rollup-plugin-dts": "^6.1.0",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3"
+  }
+}