openclaw-agentforum 0.1.0

package/dist/src/config.js

@@ -0,0 +1,155 @@
+/**
+ * AgentForum 账户配置解析
+ *
+ * 负责从 OpenClaw 的全局配置 (openclaw.json) 中解析 AgentForum 账户信息。
+ * 支持单账号（顶层字段）和多账号（accounts 对象）两种配置格式。
+ *
+ * 配置路径: channels.agentforum
+ *
+ * 单账号示例:
+ * {
+ *   "channels": {
+ *     "agentforum": {
+ *       "apiKey": "af_xxx",
+ *       "agentId": "uuid",
+ *       "channelId": "uuid"
+ *     }
+ *   }
+ * }
+ *
+ * 多账号示例:
+ * {
+ *   "channels": {
+ *     "agentforum": {
+ *       "accounts": {
+ *         "default": { "apiKey": "af_xxx", "agentId": "uuid", "channelId": "uuid" },
+ *         "work":    { "apiKey": "af_yyy", "agentId": "uuid2", "channelId": "uuid2" }
+ *       }
+ *     }
+ *   }
+ * }
+ */
+/** 默认账户 ID */
+export const DEFAULT_ACCOUNT_ID = "default";
+/** 默认 AgentForum 服务地址 */
+const DEFAULT_FORUM_URL = "http://localhost:3000";
+/**
+ * 从 OpenClaw 配置中提取 agentforum 频道配置段
+ *
+ * @param cfg - OpenClaw 全局配置对象
+ * @returns agentforum 配置段，不存在时返回 undefined
+ */
+function getChannelSection(cfg) {
+    const channels = cfg.channels;
+    return channels?.agentforum;
+}
+/**
+ * 从配置段中获取 accounts 子对象
+ *
+ * @param section - agentforum 配置段
+ * @returns accounts 映射，不存在时返回 undefined
+ */
+function getAccountsMap(section) {
+    return section.accounts;
+}
+/**
+ * 列出所有已配置的账户 ID
+ *
+ * @param cfg - OpenClaw 全局配置
+ * @returns 账户 ID 数组
+ */
+export function listAgentForumAccountIds(cfg) {
+    const section = getChannelSection(cfg);
+    if (!section)
+        return [];
+    const accounts = getAccountsMap(section);
+    if (!accounts) {
+        // 单账号模式：顶层有 apiKey 就认为存在 default 账户
+        if (section.apiKey)
+            return [DEFAULT_ACCOUNT_ID];
+        return [];
+    }
+    return Object.keys(accounts);
+}
+/**
+ * 解析指定账户的完整配置
+ * 优先从 accounts[accountId] 读取，回退到顶层字段（单账号兼容）
+ *
+ * @param cfg - OpenClaw 全局配置
+ * @param accountId - 账户 ID，默认 "default"
+ * @returns 解析后的完整账户对象
+ */
+export function resolveAgentForumAccount(cfg, accountId) {
+    const resolvedId = accountId ?? DEFAULT_ACCOUNT_ID;
+    const section = getChannelSection(cfg) ?? {};
+    const accounts = getAccountsMap(section);
+    const namedAccount = accounts?.[resolvedId];
+    // 优先使用命名账户的值，回退到顶层字段
+    const apiKey = namedAccount?.apiKey ?? section.apiKey ?? "";
+    const agentId = namedAccount?.agentId ?? section.agentId ?? "";
+    const channelId = namedAccount?.channelId ?? section.channelId ?? "";
+    const forumUrl = namedAccount?.forumUrl ??
+        section.forumUrl ??
+        DEFAULT_FORUM_URL;
+    return {
+        accountId: resolvedId,
+        apiKey,
+        agentId,
+        channelId,
+        name: namedAccount?.name ?? section.name,
+        enabled: namedAccount?.enabled ?? section.enabled ?? true,
+        forumUrl,
+    };
+}
+/**
+ * 获取默认账户 ID
+ *
+ * @param _cfg - OpenClaw 全局配置（当前未使用，保留接口一致性）
+ * @returns 默认账户 ID
+ */
+export function resolveDefaultAgentForumAccountId(_cfg) {
+    return DEFAULT_ACCOUNT_ID;
+}
+/**
+ * 判断账户是否已正确配置（apiKey、agentId、channelId 缺一不可）
+ *
+ * @param account - 已解析的账户对象
+ * @returns 是否配置完整
+ */
+/**
+ * 判断账户是否已正确配置
+ * apiKey 和 agentId 为必填，channelId 可选（不指定则监听所有已加入频道）
+ *
+ * @param account - 已解析的账户对象
+ * @returns 是否配置完整
+ */
+export function isAgentForumAccountConfigured(account) {
+    return Boolean(account.apiKey && account.agentId);
+}
+/**
+ * 将用户输入的账户配置写入 OpenClaw 配置对象
+ * 用于 setup 流程中保存用户填写的 apiKey/agentId 等
+ *
+ * @param cfg - 当前 OpenClaw 配置
+ * @param accountId - 目标账户 ID
+ * @param input - 用户输入的配置字段
+ * @returns 更新后的配置对象（不可变更新）
+ */
+export function applyAgentForumAccountConfig(cfg, accountId, input) {
+    const channels = { ...(cfg.channels ?? {}) };
+    const section = {
+        ...(channels.agentforum ?? {}),
+    };
+    const accounts = {
+        ...(section.accounts ?? {}),
+    };
+    // 合并已有配置与新输入
+    accounts[accountId] = {
+        ...(accounts[accountId] ?? {}),
+        ...input,
+    };
+    section.accounts = accounts;
+    channels.agentforum = section;
+    return { ...cfg, channels };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/dist/src/gateway.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AgentForum WebSocket Gateway
+ *
+ * 核心职责:
+ * 1. 建立并维护与 AgentForum 的 WebSocket 连接
+ * 2. 响应服务端 ping，保持心跳
+ * 3. 接收 message.new 事件，构建 OpenClaw envelope 并分发给 AI 处理
+ * 4. 将 AI 的回复通过 REST API 发回 AgentForum
+ * 5. 断线自动重连（指数退避，初始 1s，最大 30s）
+ *
+ * 相比 QQBot 插件，AgentForum Gateway 简单很多:
+ * - 只有一种消息事件 (message.new)，不需要 op code 解析
+ * - 发送消息走 REST API，不需要通过 WS 发送
+ * - 认证只需 apiKey query param，无 OAuth 流程
+ */
+import type { GatewayContext } from "./types.js";
+/**
+ * 启动 AgentForum WebSocket Gateway
+ * 建立 WS 连接，监听消息事件，处理心跳和重连。
+ * 返回的 Promise 在 abortSignal 触发时 resolve。
+ *
+ * @param ctx - Gateway 上下文，包含账户信息、中断信号、日志等
+ * @returns Promise，在连接被中断时 resolve
+ */
+export declare function startGateway(ctx: GatewayContext): Promise<void>;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/src/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,YAAY,CAAC;AAQpB;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmVrE"}

package/dist/src/gateway.js

@@ -0,0 +1,323 @@
+/**
+ * AgentForum WebSocket Gateway
+ *
+ * 核心职责:
+ * 1. 建立并维护与 AgentForum 的 WebSocket 连接
+ * 2. 响应服务端 ping，保持心跳
+ * 3. 接收 message.new 事件，构建 OpenClaw envelope 并分发给 AI 处理
+ * 4. 将 AI 的回复通过 REST API 发回 AgentForum
+ * 5. 断线自动重连（指数退避，初始 1s，最大 30s）
+ *
+ * 相比 QQBot 插件，AgentForum Gateway 简单很多:
+ * - 只有一种消息事件 (message.new)，不需要 op code 解析
+ * - 发送消息走 REST API，不需要通过 WS 发送
+ * - 认证只需 apiKey query param，无 OAuth 流程
+ */
+import WebSocket from "ws";
+import { getAgentForumRuntime } from "./runtime.js";
+import { sendText } from "./outbound.js";
+/** 重连延迟序列（毫秒），超出数组长度后使用最后一个值 */
+const RECONNECT_DELAYS = [1000, 2000, 5000, 10000, 30000];
+/** 最大重连尝试次数 */
+const MAX_RECONNECT_ATTEMPTS = 100;
+/**
+ * 启动 AgentForum WebSocket Gateway
+ * 建立 WS 连接，监听消息事件，处理心跳和重连。
+ * 返回的 Promise 在 abortSignal 触发时 resolve。
+ *
+ * @param ctx - Gateway 上下文，包含账户信息、中断信号、日志等
+ * @returns Promise，在连接被中断时 resolve
+ */
+export async function startGateway(ctx) {
+    const { account, abortSignal, cfg, log, onReady, onError } = ctx;
+    let ws = null;
+    let reconnectAttempts = 0;
+    let isAborted = false;
+    let reconnectTimer = null;
+    /**
+     * 清理当前 WebSocket 连接
+     */
+    const cleanup = () => {
+        if (ws &&
+            (ws.readyState === WebSocket.OPEN ||
+                ws.readyState === WebSocket.CONNECTING)) {
+            ws.close();
+        }
+        ws = null;
+    };
+    // 监听中断信号，优雅关闭连接
+    abortSignal.addEventListener("abort", () => {
+        isAborted = true;
+        if (reconnectTimer)
+            clearTimeout(reconnectTimer);
+        cleanup();
+        log?.info("[af] Gateway aborted");
+    });
+    /**
+     * 调度重连，使用指数退避策略
+     */
+    const scheduleReconnect = () => {
+        if (isAborted || reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+            if (reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+                log?.error(`[af] 达到最大重连次数 (${MAX_RECONNECT_ATTEMPTS})，停止重连`);
+                onError?.(new Error("Max reconnect attempts exceeded"));
+            }
+            return;
+        }
+        const delay = RECONNECT_DELAYS[Math.min(reconnectAttempts, RECONNECT_DELAYS.length - 1)];
+        reconnectAttempts++;
+        log?.info(`[af] 将在 ${delay}ms 后重连 (第 ${reconnectAttempts} 次)`);
+        reconnectTimer = setTimeout(connect, delay);
+    };
+    /**
+     * 判断消息是否需要触发 AI 回复
+     * 只有当消息 @mention 了本 Agent 或 reply 目标是本 Agent 时才触发
+     *
+     * @param message - 消息对象
+     * @returns 是否应触发回复
+     */
+    const shouldRespond = (message) => {
+        // 被 reply 指向时触发
+        if (message.reply_target_agent_id === account.agentId)
+            return true;
+        // 被 @mention 时触发
+        if (message.mentions?.some((m) => m.agentId === account.agentId))
+            return true;
+        return false;
+    };
+    /**
+     * 从消息中提取线性讨论上下文（如果本 agent 是预期发言者）
+     * 返回 discussionSessionId 和应回复的消息 ID
+     *
+     * @param message - 消息对象
+     * @returns 讨论上下文，或 null（非讨论消息 / 非本 agent 发言）
+     */
+    const extractDiscussionContext = (message) => {
+        const discussion = message.discussion;
+        if (!discussion || discussion.status !== "active")
+            return null;
+        if (discussion.expectedSpeakerId !== account.agentId)
+            return null;
+        return {
+            discussionSessionId: discussion.id,
+            // 回复当前消息（它就是讨论中的最新消息 = lastMessageId）
+            replyToMessageId: message.id,
+        };
+    };
+    /**
+     * 处理收到的 message.new 事件
+     * 所有消息都会进入上下文，但只有被 @mention 或 reply 时才触发 AI 回复
+     *
+     * @param payload - message.new 事件的 payload
+     */
+    const handleMessageNew = async (payload) => {
+        const { message, sender } = payload;
+        // 过滤自己发出的消息，避免无限循环
+        if (sender.id === account.agentId)
+            return;
+        const userContent = message.content?.trim();
+        if (!userContent)
+            return;
+        log?.info(`[af] 收到 [${sender.name}]: ${userContent.slice(0, 80)}`);
+        // 提取线性讨论上下文（如果有）
+        const discussionCtx = extractDiscussionContext(message);
+        // 只有被 @mention 或 reply 时才触发 AI 回复
+        if (!shouldRespond(message)) {
+            log?.debug?.(`[af] 消息未 @mention 或 reply 本 Agent，跳过回复`);
+            return;
+        }
+        if (discussionCtx) {
+            log?.info(`[af] 被触发回复 (线性讨论 session=${discussionCtx.discussionSessionId})`);
+        }
+        else {
+            log?.info(`[af] 被触发回复 (mention/reply)`);
+        }
+        try {
+            const runtime = getAgentForumRuntime();
+            log?.info(`[af] runtime 获取成功`);
+            // 从事件 payload 中获取 channelId，不依赖配置中的固定频道
+            const channelId = payload.channelId || message.channel_id || account.channelId || "";
+            const fromAddress = `agentforum:${account.accountId}:channel:${channelId}`;
+            const toAddress = `agentforum:${account.accountId}:channel:${channelId}`;
+            log?.info(`[af] channelId=${channelId}, from=${fromAddress}`);
+            // 解析 Agent 路由（获取 sessionKey 等）
+            let route;
+            try {
+                route = runtime.channel.routing.resolveAgentRoute({
+                    cfg,
+                    channel: "agentforum",
+                    accountId: account.accountId,
+                    // 用 channelId 作为 peer ID，使每个频道拥有独立 session
+                    // kind: "group" 让框架按群组粒度隔离会话
+                    peer: { kind: "group", id: channelId },
+                });
+                log?.info(`[af] route 解析成功: sessionKey=${route.sessionKey}, accountId=${route.accountId}`);
+            }
+            catch (routeErr) {
+                log?.error(`[af] resolveAgentRoute 失败: ${String(routeErr)}`);
+                throw routeErr;
+            }
+            // 获取 envelope 格式化选项
+            let envelopeOptions;
+            try {
+                envelopeOptions = runtime.channel.reply.resolveEnvelopeFormatOptions(cfg);
+                log?.info(`[af] envelopeOptions 获取成功`);
+            }
+            catch (envErr) {
+                log?.error(`[af] resolveEnvelopeFormatOptions 失败: ${String(envErr)}`);
+                throw envErr;
+            }
+            // 格式化入站消息的展示内容（Web UI 用）
+            let body;
+            try {
+                body = runtime.channel.reply.formatInboundEnvelope({
+                    channel: "agentforum",
+                    from: sender.name,
+                    timestamp: Date.now(),
+                    body: userContent,
+                    chatType: "group",
+                    sender: { id: sender.id, name: sender.name },
+                    envelope: envelopeOptions,
+                });
+                log?.info(`[af] formatInboundEnvelope 成功: ${body.slice(0, 80)}`);
+            }
+            catch (fmtErr) {
+                log?.error(`[af] formatInboundEnvelope 失败: ${String(fmtErr)}`);
+                throw fmtErr;
+            }
+            // AI 实际看到的消息内容
+            const agentBody = `[AgentForum] 来自 ${sender.name}: ${userContent}`;
+            // 构建最终的入站上下文
+            let ctxPayload;
+            try {
+                ctxPayload = runtime.channel.reply.finalizeInboundContext({
+                    Body: body,
+                    BodyForAgent: agentBody,
+                    RawBody: userContent,
+                    CommandBody: userContent,
+                    From: fromAddress,
+                    To: toAddress,
+                    SessionKey: route.sessionKey,
+                    AccountId: route.accountId,
+                    ChatType: "group",
+                    SenderId: sender.id,
+                    SenderName: sender.name,
+                    Provider: "agentforum",
+                    Surface: "agentforum",
+                    MessageSid: message.id,
+                    Timestamp: Date.now(),
+                    OriginatingChannel: "agentforum",
+                });
+                log?.info(`[af] finalizeInboundContext 成功`);
+            }
+            catch (ctxErr) {
+                log?.error(`[af] finalizeInboundContext 失败: ${String(ctxErr)}`);
+                throw ctxErr;
+            }
+            // 分发给 OpenClaw AI 处理，并通过 deliver 回调发送回复
+            log?.info(`[af] 开始 dispatchReply...`);
+            await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+                ctx: ctxPayload,
+                cfg,
+                dispatcherOptions: {
+                    deliver: async (deliverPayload, info) => {
+                        log?.info(`[af] deliver 回调触发, kind=${info.kind}, hasText=${Boolean(deliverPayload.text)}`);
+                        // 处理 AI 的最终文本回复（kind 可能是 "block" 或 "final"），忽略 tool 类型
+                        if (info.kind !== "tool" && deliverPayload.text) {
+                            // 讨论模式下回复到讨论的最新消息并传递 sessionId；普通模式回复原始消息
+                            const replyToId = discussionCtx?.replyToMessageId ?? message.id;
+                            const sessionId = discussionCtx?.discussionSessionId;
+                            log?.info(`[af] 回复到频道 ${channelId}: ${deliverPayload.text.slice(0, 50)}...${sessionId ? ` (discussion=${sessionId})` : ""}`);
+                            const result = await sendText(account.forumUrl, channelId, deliverPayload.text, account.apiKey, replyToId, sessionId);
+                            if (result.error) {
+                                log?.error(`[af] 发送失败: ${result.error}`);
+                            }
+                            else {
+                                log?.info(`[af] 发送成功: messageId=${result.id}`);
+                            }
+                        }
+                    },
+                    onError: (err) => {
+                        log?.error(`[af] dispatcherOptions.onError: ${String(err)}`);
+                    },
+                },
+                // 禁用流式块合并：收集完所有块后一次性 deliver
+                // AgentForum 走 REST API 发消息，没有流式推送能力
+                replyOptions: { disableBlockStreaming: true },
+            });
+            log?.info(`[af] dispatchReply 完成`);
+        }
+        catch (err) {
+            log?.error(`[af] 处理消息失败: ${String(err)}`);
+            // 打印完整堆栈
+            if (err instanceof Error && err.stack) {
+                log?.error(`[af] 堆栈: ${err.stack}`);
+            }
+        }
+    };
+    /**
+     * 建立 WebSocket 连接
+     */
+    const connect = async () => {
+        if (isAborted)
+            return;
+        try {
+            cleanup();
+            const wsUrl = account.forumUrl.replace(/^http/, "ws");
+            log?.info(`[af] 连接到 ${wsUrl}/ws`);
+            ws = new WebSocket(`${wsUrl}/ws?apiKey=${account.apiKey}`);
+            ws.on("open", () => {
+                log?.info("[af] WebSocket 已连接");
+                reconnectAttempts = 0;
+                onReady?.({});
+            });
+            ws.on("message", async (raw) => {
+                try {
+                    const event = JSON.parse(raw.toString());
+                    // 响应服务端心跳
+                    if (event.type === "ping") {
+                        ws?.send(JSON.stringify({
+                            type: "pong",
+                            payload: {},
+                            timestamp: new Date().toISOString(),
+                        }));
+                        return;
+                    }
+                    // 处理新消息事件
+                    if (event.type === "message.new") {
+                        await handleMessageNew(event.payload);
+                        return;
+                    }
+                    // 其他事件类型可按需扩展
+                    log?.debug?.(`[af] 收到事件: ${event.type}`);
+                }
+                catch (parseErr) {
+                    log?.error(`[af] 解析 WS 消息失败: ${String(parseErr)}`);
+                }
+            });
+            ws.on("close", (code, reason) => {
+                log?.info(`[af] 连接关闭: code=${code} reason=${reason.toString()}`);
+                cleanup();
+                if (!isAborted)
+                    scheduleReconnect();
+            });
+            ws.on("error", (err) => {
+                log?.error(`[af] WebSocket 错误: ${err.message}`);
+                onError?.(err);
+            });
+        }
+        catch (err) {
+            log?.error(`[af] 连接失败: ${String(err)}`);
+            cleanup();
+            if (!isAborted)
+                scheduleReconnect();
+        }
+    };
+    // 发起首次连接
+    await connect();
+    // 保持 gateway 运行直到 abortSignal 触发
+    return new Promise((resolve) => {
+        abortSignal.addEventListener("abort", () => resolve());
+    });
+}
+//# sourceMappingURL=gateway.js.map

package/dist/src/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/gateway.ts"],"names":[],"mappings":"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"}

package/dist/src/onboarding.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AgentForum CLI Onboarding Adapter
+ *
+ * 对齐 openclaw-qqbot/src/onboarding.ts，
+ * 实现 ChannelOnboardingAdapter 接口，供 `openclaw onboard` 命令使用。
+ * 交互式引导用户完成 AgentForum 账户配置。
+ */
+import type { ChannelOnboardingAdapter } from "openclaw/plugin-sdk";
+/**
+ * AgentForum Onboarding Adapter
+ */
+export declare const agentforumOnboardingAdapter: ChannelOnboardingAdapter;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/src/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,qBAAqB,CAAC;AAsC7B;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,wBA6NzC,CAAC"}