@next-open-ai/openclawx 0.8.8 → 0.8.16

package/dist/core/agent/proxy/run-for-channel.js

@@ -0,0 +1,31 @@
+/**
+ * 通道用统一执行入口：根据 agent 配置的 runnerType 选择适配器并执行。
+ */
+import { loadDesktopAgentConfig } from "../../config/desktop-config.js";
+import { getAgentProxyAdapter } from "./registry.js";
+export async function runForChannelStream(options, callbacks) {
+    const agentId = options.agentId ?? "default";
+    const config = await loadDesktopAgentConfig(agentId);
+    if (!config) {
+        throw new Error(`Agent config not found for agentId: ${agentId}`);
+    }
+    const runnerType = config.runnerType ?? "local";
+    const adapter = getAgentProxyAdapter(runnerType);
+    if (!adapter) {
+        throw new Error(`No AgentProxy adapter registered for type: "${runnerType}"`);
+    }
+    await adapter.runStream({ ...options, agentId }, config, callbacks);
+}
+export async function runForChannelCollect(options) {
+    const agentId = options.agentId ?? "default";
+    const config = await loadDesktopAgentConfig(agentId);
+    if (!config) {
+        throw new Error(`Agent config not found for agentId: ${agentId}`);
+    }
+    const runnerType = config.runnerType ?? "local";
+    const adapter = getAgentProxyAdapter(runnerType);
+    if (!adapter) {
+        throw new Error(`No AgentProxy adapter registered for type: "${runnerType}"`);
+    }
+    return adapter.runCollect({ ...options, agentId }, config);
+}

package/dist/core/agent/proxy/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AgentProxy 统一类型：适配器接口与执行参数。
+ */
+import type { DesktopAgentConfig } from "../../config/desktop-config.js";
+export interface RunAgentForChannelOptions {
+    sessionId: string;
+    message: string;
+    agentId: string;
+}
+export interface RunAgentStreamCallbacks {
+    onChunk(delta: string): void;
+    onTurnEnd?(): void;
+    onDone(): void;
+}
+/**
+ * 代理适配器接口：按平台实现，对外提供流式/一次性回复。
+ */
+export interface IAgentProxyAdapter {
+    readonly type: string;
+    /**
+     * 流式执行：通过 callbacks 推送 delta，onDone 表示整轮结束。
+     */
+    runStream(options: RunAgentForChannelOptions, config: DesktopAgentConfig, callbacks: RunAgentStreamCallbacks): Promise<void>;
+    /**
+     * 一次性执行：返回完整回复文本。
+     */
+    runCollect(options: RunAgentForChannelOptions, config: DesktopAgentConfig): Promise<string>;
+}

package/dist/core/agent/proxy/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/config/desktop-config.d.ts

@@ -29,6 +29,38 @@ export interface ChannelsConfig {
 }
 /** MCP 服务器配置（与 core/mcp 类型一致，避免 core/config 依赖 core/mcp 实现） */
 export type DesktopMcpServerConfig = import("../mcp/index.js").McpServerConfig;
+/** Agent 执行器类型：local=本机 pi-coding-agent，coze/openclawx=远程代理 */
+export type AgentRunnerType = "local" | "coze" | "openclawx";
+/** Coze 站点：国内站 api.coze.cn / 国际站 api.coze.com，凭证不通用 */
+export type CozeRegion = "cn" | "com";
+/** 某站点的 Bot 凭证（国内/国际各自独立） */
+export interface CozeRegionCredentials {
+    botId: string;
+    apiKey: string;
+}
+/** Coze 代理配置（agents.json）：按站点分别存凭证，请求时用当前 region 对应的一套 */
+export interface AgentCozeConfig {
+    /** 当前使用的站点，未填默认 com */
+    region?: CozeRegion;
+    /** 国内站 (api.coze.cn) 凭证 */
+    cn?: CozeRegionCredentials;
+    /** 国际站 (api.coze.com) 凭证 */
+    com?: CozeRegionCredentials;
+    /** 可选：自定义 API 地址，覆盖当前站点的默认地址 */
+    endpoint?: string;
+}
+/** 解析后的 Coze 配置（供适配器使用）：当前站点的 botId/apiKey + region/endpoint */
+export interface CozeResolvedConfig {
+    botId: string;
+    apiKey: string;
+    region?: CozeRegion;
+    endpoint?: string;
+}
+/** OpenClawX 代理配置（代理到另一台 OpenClawX 实例） */
+export interface AgentOpenClawXConfig {
+    baseUrl: string;
+    apiKey?: string;
+}
 /**
  * 同步读取桌面全局配置中的 maxAgentSessions 等。
  * Gateway 进程内使用，用于会话上限等。
@@ -50,6 +82,12 @@ export interface DesktopAgentConfig {
     mcpServers?: DesktopMcpServerConfig[];
     /** 自定义系统提示词，会与技能等一起组成最终 systemPrompt */
     systemPrompt?: string;
+    /** 执行器类型，缺省 local */
+    runnerType?: AgentRunnerType;
+    /** Coze 代理配置（解析后：当前站点的凭证） */
+    coze?: CozeResolvedConfig;
+    /** OpenClawX 代理配置 */
+    openclawx?: AgentOpenClawXConfig;
 }
 /**
  * 从 config.json 读取缺省智能体 id（defaultAgentId）。

package/dist/core/config/desktop-config.js

@@ -207,7 +207,70 @@ export async function loadDesktopAgentConfig(agentId) {
     const apiKey = provConfig?.apiKey && typeof provConfig.apiKey === "string" && provConfig.apiKey.trim()
         ? provConfig.apiKey.trim()
         : undefined;
-    return { provider, model, apiKey: apiKey ?? undefined, workspace: workspaceName, mcpServers, systemPrompt };
+    let runnerType = "local";
+    let coze;
+    let openclawx;
+    if (existsSync(agentsPath)) {
+        try {
+            const rawAgents = await readFile(agentsPath, "utf-8");
+            const dataAgents = JSON.parse(rawAgents);
+            const agentsList = Array.isArray(dataAgents.agents) ? dataAgents.agents : [];
+            const agentRow = agentsList.find((a) => a.id === resolvedAgentId);
+            if (agentRow) {
+                if (agentRow.runnerType === "coze" || agentRow.runnerType === "openclawx") {
+                    runnerType = agentRow.runnerType;
+                }
+                if (agentRow.coze) {
+                    const row = agentRow.coze;
+                    const region = row.region === "cn" || row.region === "com" ? row.region : "com";
+                    const credsCn = row.cn;
+                    const credsCom = row.com;
+                    const legacyBotId = row.botId != null ? String(row.botId).trim() : "";
+                    const legacyKey = row.apiKey != null ? String(row.apiKey).trim() : "";
+                    const fromRegion = region === "cn"
+                        ? credsCn && String(credsCn.botId || "").trim() && String(credsCn.apiKey || "").trim()
+                            ? { botId: String(credsCn.botId).trim(), apiKey: String(credsCn.apiKey).trim() }
+                            : null
+                        : credsCom && String(credsCom.botId || "").trim() && String(credsCom.apiKey || "").trim()
+                            ? { botId: String(credsCom.botId).trim(), apiKey: String(credsCom.apiKey).trim() }
+                            : null;
+                    const fromLegacy = legacyBotId && legacyKey ? { botId: legacyBotId, apiKey: legacyKey } : null;
+                    const creds = fromRegion ?? fromLegacy;
+                    if (creds) {
+                        coze = {
+                            botId: creds.botId,
+                            apiKey: creds.apiKey,
+                            region,
+                            endpoint: row.endpoint?.trim(),
+                        };
+                    }
+                    else if (runnerType === "coze") {
+                        console.warn(`[loadDesktopAgentConfig] agentId=${resolvedAgentId} runnerType=coze but no credentials for region=${region} (configure 国内/国际 in proxy settings)`);
+                    }
+                }
+                if (agentRow.openclawx?.baseUrl) {
+                    openclawx = {
+                        baseUrl: String(agentRow.openclawx.baseUrl).replace(/\/$/, ""),
+                        apiKey: agentRow.openclawx.apiKey?.trim(),
+                    };
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return {
+        provider,
+        model,
+        apiKey: apiKey ?? undefined,
+        workspace: workspaceName,
+        mcpServers,
+        systemPrompt,
+        runnerType,
+        coze,
+        openclawx,
+    };
 }
 function ensureDesktopDir() {
     const desktopDir = getDesktopDir();

package/dist/gateway/channel/adapters/telegram.js

@@ -31,11 +31,14 @@ function truncateForTelegram(text) {
 /**
  * 入站：长轮询 getUpdates，收到 message/edited_message 后转 UnifiedMessage 并分发。
  */
+/** 轮询错误日志节流：同一类错误至少间隔此毫秒数再打印，避免刷屏 */
+const TELEGRAM_POLL_ERROR_LOG_INTERVAL_MS = 60_000;
 class TelegramLongPollInbound {
     config;
     messageHandler = null;
     stopped = false;
     lastOffset = 0;
+    lastPollErrorLogTime = 0;
     constructor(config) {
         this.config = config;
     }
@@ -91,8 +94,16 @@ class TelegramLongPollInbound {
                     }
                 }
                 catch (e) {
-                    if (!this.stopped)
-                        console.error("[Telegram] long poll error:", e);
+                    if (!this.stopped) {
+                        const now = Date.now();
+                        if (now - this.lastPollErrorLogTime >= TELEGRAM_POLL_ERROR_LOG_INTERVAL_MS) {
+                            this.lastPollErrorLogTime = now;
+                            const cause = e?.cause?.code === "UND_ERR_CONNECT_TIMEOUT"
+                                ? " (api.telegram.org 连接超时，可能需代理或网络不可达，将继续重试)"
+                                : "";
+                            console.warn("[Telegram] long poll error:", e?.message ?? e, cause);
+                        }
+                    }
                     await new Promise((r) => setTimeout(r, 2000));
                 }
             }

package/dist/gateway/channel/run-agent.d.ts

@@ -15,12 +15,10 @@ export interface RunAgentStreamCallbacks {
     onDone(): void;
 }
 /**
- * 使用现有 agentManager 跑一轮对话，以流式回调方式推送助手回复（onChunk/onDone）。
- * onDone 在 agent_end 时调用，保证「对话真正结束」语义（多轮 tool+文本合并为一条回复）。
+ * 使用 AgentProxy 统一入口跑一轮对话，以流式回调方式推送助手回复（onChunk/onDone）。
  */
 export declare function runAgentAndStreamReply(options: RunAgentForChannelOptions, callbacks: RunAgentStreamCallbacks): Promise<void>;
 /**
- * 使用现有 agentManager 跑一轮对话，收集助手完整回复文本后返回。
- * 不依赖 WebSocket 客户端，供通道核心调用。
+ * 使用 AgentProxy 统一入口跑一轮对话，收集助手完整回复文本后返回。
  */
 export declare function runAgentAndCollectReply(options: RunAgentForChannelOptions): Promise<string>;

package/dist/gateway/channel/run-agent.js

@@ -1,137 +1,25 @@
 /**
  * 通道用：跑 Agent 并收集完整回复文本（无 WebSocket 客户端）。
+ * 委托给 core/agent/proxy 统一入口，按 runnerType 分发到 local/coze/openclawx 等适配器。
  */
-import { agentManager } from "../../core/agent/agent-manager.js";
-import { getDesktopConfig, loadDesktopAgentConfig } from "../../core/config/desktop-config.js";
-import { getExperienceContextForUserMessage } from "../../core/memory/index.js";
+import { runForChannelStream, runForChannelCollect } from "../../core/agent/proxy/index.js";
 /**
- * 使用现有 agentManager 跑一轮对话，以流式回调方式推送助手回复（onChunk/onDone）。
- * onDone 在 agent_end 时调用，保证「对话真正结束」语义（多轮 tool+文本合并为一条回复）。
+ * 使用 AgentProxy 统一入口跑一轮对话，以流式回调方式推送助手回复（onChunk/onDone）。
  */
 export async function runAgentAndStreamReply(options, callbacks) {
-    const { sessionId, message, agentId: optionAgentId } = options;
-    const sessionAgentId = optionAgentId ?? "default";
-    let workspace = "default";
-    let provider;
-    let modelId;
-    let apiKey;
-    const agentConfig = await loadDesktopAgentConfig(sessionAgentId);
-    if (agentConfig) {
-        if (agentConfig.workspace)
-            workspace = agentConfig.workspace;
-        provider = agentConfig.provider;
-        modelId = agentConfig.model;
-        if (agentConfig.apiKey)
-            apiKey = agentConfig.apiKey;
-    }
-    const { maxAgentSessions } = getDesktopConfig();
-    const session = await agentManager.getOrCreateSession(sessionId, {
-        agentId: sessionAgentId,
-        workspace,
-        provider,
-        modelId,
-        apiKey,
-        maxSessions: maxAgentSessions,
-        targetAgentId: sessionAgentId,
-        mcpServers: agentConfig?.mcpServers,
-        systemPrompt: agentConfig?.systemPrompt,
-    });
-    let resolveDone;
-    const donePromise = new Promise((r) => {
-        resolveDone = r;
-    });
-    const unsubscribe = session.subscribe((event) => {
-        if (event.type === "message_update") {
-            const update = event;
-            if (update.assistantMessageEvent?.type === "text_delta" && update.assistantMessageEvent?.delta) {
-                callbacks.onChunk(update.assistantMessageEvent.delta);
-            }
-        }
-        else if (event.type === "turn_end") {
-            callbacks.onTurnEnd?.();
-        }
-        else if (event.type === "agent_end") {
-            callbacks.onDone();
-            resolveDone();
-        }
-    });
-    try {
-        const experienceBlock = await getExperienceContextForUserMessage();
-        const userMessageToSend = experienceBlock.trim().length > 0
-            ? `${experienceBlock}\n\n用户问题：\n${message}`
-            : message;
-        await session.sendUserMessage(userMessageToSend, { deliverAs: "followUp" });
-        await Promise.race([
-            donePromise,
-            new Promise((_, rej) => setTimeout(() => rej(new Error("Channel agent reply timeout")), 120_000)),
-        ]);
-    }
-    finally {
-        unsubscribe();
-    }
+    await runForChannelStream({
+        sessionId: options.sessionId,
+        message: options.message,
+        agentId: options.agentId ?? "default",
+    }, callbacks);
 }
 /**
- * 使用现有 agentManager 跑一轮对话，收集助手完整回复文本后返回。
- * 不依赖 WebSocket 客户端，供通道核心调用。
+ * 使用 AgentProxy 统一入口跑一轮对话，收集助手完整回复文本后返回。
  */
 export async function runAgentAndCollectReply(options) {
-    const { sessionId, message, agentId: optionAgentId } = options;
-    const sessionAgentId = optionAgentId ?? "default";
-    let workspace = "default";
-    let provider;
-    let modelId;
-    let apiKey;
-    const agentConfig = await loadDesktopAgentConfig(sessionAgentId);
-    if (agentConfig) {
-        if (agentConfig.workspace)
-            workspace = agentConfig.workspace;
-        provider = agentConfig.provider;
-        modelId = agentConfig.model;
-        if (agentConfig.apiKey)
-            apiKey = agentConfig.apiKey;
-    }
-    const { maxAgentSessions } = getDesktopConfig();
-    const session = await agentManager.getOrCreateSession(sessionId, {
-        agentId: sessionAgentId,
-        workspace,
-        provider,
-        modelId,
-        apiKey,
-        maxSessions: maxAgentSessions,
-        targetAgentId: sessionAgentId,
-        mcpServers: agentConfig?.mcpServers,
-        systemPrompt: agentConfig?.systemPrompt,
-    });
-    const chunks = [];
-    let resolveDone;
-    const donePromise = new Promise((r) => {
-        resolveDone = r;
-    });
-    const unsubscribe = session.subscribe((event) => {
-        if (event.type === "message_update") {
-            const update = event;
-            if (update.assistantMessageEvent?.type === "text_delta" && update.assistantMessageEvent?.delta) {
-                chunks.push(update.assistantMessageEvent.delta);
-            }
-        }
-        else if (event.type === "agent_end") {
-            resolveDone();
-        }
+    return runForChannelCollect({
+        sessionId: options.sessionId,
+        message: options.message,
+        agentId: options.agentId ?? "default",
     });
-    try {
-        const experienceBlock = await getExperienceContextForUserMessage();
-        const userMessageToSend = experienceBlock.trim().length > 0
-            ? `${experienceBlock}\n\n用户问题：\n${message}`
-            : message;
-        await session.sendUserMessage(userMessageToSend, { deliverAs: "followUp" });
-        // 等待 agent_end（整轮对话真正结束）或超时
-        await Promise.race([
-            donePromise,
-            new Promise((_, rej) => setTimeout(() => rej(new Error("Channel agent reply timeout")), 120_000)),
-        ]);
-    }
-    finally {
-        unsubscribe();
-    }
-    return chunks.join("").trim() || "(无文本回复)";
 }

package/dist/gateway/methods/agent-chat.js

@@ -1,4 +1,5 @@
 import { agentManager } from "../../core/agent/agent-manager.js";
+import { runForChannelStream } from "../../core/agent/proxy/index.js";
 import { getSessionCurrentAgentResolver, getSessionCurrentAgentUpdater } from "../../core/session-current-agent.js";
 import { getExperienceContextForUserMessage } from "../../core/memory/index.js";
 import { send, createEvent } from "../utils.js";
@@ -43,6 +44,7 @@ async function handleAgentChatInner(client, targetSessionId, message, params) {
         getSessionCurrentAgentUpdater()?.(targetSessionId, params.agentId);
         currentAgentId = params.agentId;
     }
+    console.log(`[agent.chat] session=${targetSessionId} resolved agentId=${currentAgentId} (params=${params.agentId ?? "—"}, stored=${storedAgentId ?? "—"}, client=${client.agentId ?? "—"})`);
     let workspace = "default";
     let provider;
     let modelId;
@@ -56,6 +58,38 @@ async function handleAgentChatInner(client, targetSessionId, message, params) {
         if (agentConfig.apiKey)
             apiKey = agentConfig.apiKey;
     }
+    const runnerType = agentConfig?.runnerType ?? "local";
+    const isProxyAgent = runnerType === "coze" || runnerType === "openclawx";
+    if (isProxyAgent) {
+        console.log(`[agent.chat] Using proxy agent (${runnerType}) for session=${targetSessionId}, agentId=${currentAgentId}`);
+    }
+    // 代理智能体（Coze / OpenClawX）：走 AgentProxy 统一入口，流式结果通过 WebSocket 推给客户端
+    if (isProxyAgent) {
+        try {
+            await runForChannelStream({
+                sessionId: targetSessionId,
+                message,
+                agentId: currentAgentId,
+            }, {
+                onChunk(delta) {
+                    broadcastToSession(targetSessionId, createEvent("agent.chunk", { text: delta }));
+                },
+                onTurnEnd() {
+                    broadcastToSession(targetSessionId, createEvent("turn_end", { sessionId: targetSessionId, content: "" }));
+                    broadcastToSession(targetSessionId, createEvent("message_complete", { sessionId: targetSessionId, content: "" }));
+                },
+                onDone() {
+                    broadcastToSession(targetSessionId, createEvent("agent_end", { sessionId: targetSessionId }));
+                    broadcastToSession(targetSessionId, createEvent("conversation_end", { sessionId: targetSessionId }));
+                },
+            });
+            return { status: "completed", sessionId: targetSessionId };
+        }
+        catch (error) {
+            console.error(`Error in agent chat (proxy ${runnerType}):`, error);
+            throw error;
+        }
+    }
     const isEphemeralSession = sessionType === "system" || sessionType === "scheduled";
     if (isEphemeralSession) {
         agentManager.deleteSession(targetSessionId + COMPOSITE_KEY_SEP + currentAgentId);

package/dist/server/agent-config/agent-config.controller.d.ts

@@ -25,7 +25,7 @@ export declare class AgentConfigController {
         success: boolean;
         data: AgentConfigItem;
     }>;
-    updateAgent(id: string, body: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'systemPrompt' | 'icon'>>): Promise<{
+    updateAgent(id: string, body: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'systemPrompt' | 'icon' | 'runnerType' | 'coze' | 'openclawx'>>): Promise<{
         success: boolean;
         data: AgentConfigItem;
     }>;

package/dist/server/agent-config/agent-config.service.d.ts

@@ -1,6 +1,26 @@
 import type { McpServerConfig } from '../../core/mcp/index.js';
 /** 缺省智能体 ID / 工作空间名，不可删除；对应目录 ~/.openbot/workspace/default */
 export declare const DEFAULT_AGENT_ID = "default";
+/** 执行器类型：local=本机，coze/openclawx=远程代理 */
+export type AgentRunnerType = 'local' | 'coze' | 'openclawx';
+/** Coze 站点：cn=国内 api.coze.cn，com=国际 api.coze.com，凭证不通用 */
+export type CozeRegion = 'cn' | 'com';
+/** 某站点的 Bot 凭证 */
+export interface CozeRegionCredentials {
+    botId: string;
+    apiKey: string;
+}
+/** Coze 代理配置（存储）：按站点分别存凭证，请求时用 region 对应的一套 */
+export interface AgentCozeConfig {
+    region?: CozeRegion;
+    cn?: CozeRegionCredentials;
+    com?: CozeRegionCredentials;
+    endpoint?: string;
+}
+export interface AgentOpenClawXConfig {
+    baseUrl: string;
+    apiKey?: string;
+}
 /**
  * 智能体列表与配置使用文件存储（~/.openbot/desktop/agents.json），不使用 SQLite。
  * 会话与消息历史使用 SQLite；Skills、工作空间文档为目录文件管理。
@@ -21,6 +41,12 @@ export interface AgentConfigItem {
     systemPrompt?: string;
     /** 智能体图标标识（前端预设图标 id，如 default、star、code 等） */
     icon?: string;
+    /** 执行器类型：local=本机，coze/openclawx=远程代理 */
+    runnerType?: AgentRunnerType;
+    /** Coze 代理配置（runnerType 为 coze 时使用） */
+    coze?: AgentCozeConfig;
+    /** OpenClawX 代理配置（runnerType 为 openclawx 时使用） */
+    openclawx?: AgentOpenClawXConfig;
 }
 export declare class AgentConfigService {
     private configDir;
@@ -45,7 +71,7 @@ export declare class AgentConfigService {
         /** 智能体图标标识 */
         icon?: string;
     }): Promise<AgentConfigItem>;
-    updateAgent(id: string, updates: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'systemPrompt' | 'icon'>>): Promise<AgentConfigItem>;
+    updateAgent(id: string, updates: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'systemPrompt' | 'icon' | 'runnerType' | 'coze' | 'openclawx'>>): Promise<AgentConfigItem>;
     deleteAgent(id: string): Promise<void>;
     /**
      * 根据 config 的 defaultProvider / defaultModel / defaultModelItemCode 及 configuredModels 同步 agents.json 中缺省智能体的 provider、model、modelItemCode。

package/dist/server/agent-config/agent-config.service.js

@@ -159,6 +159,49 @@ let AgentConfigService = class AgentConfigService {
             agent.systemPrompt = updates.systemPrompt?.trim() || undefined;
         if (updates.icon !== undefined)
             agent.icon = updates.icon?.trim() || undefined;
+        if (updates.runnerType !== undefined)
+            agent.runnerType = updates.runnerType;
+        if (updates.coze !== undefined) {
+            const incoming = updates.coze;
+            const endpointVal = incoming.endpoint != null ? String(incoming.endpoint).trim() : '';
+            const region = incoming.region === 'cn' || incoming.region === 'com' ? incoming.region : agent.coze?.region || 'com';
+            const mergeOne = (inCreds, existing) => {
+                const botId = String((inCreds?.botId ?? existing?.botId) ?? '').trim();
+                if (!botId)
+                    return existing;
+                const apiKey = (inCreds?.apiKey != null && String(inCreds.apiKey).trim()) ||
+                    (existing?.apiKey != null ? String(existing.apiKey).trim() : '') ||
+                    '';
+                return { botId, apiKey };
+            };
+            const cn = incoming.cn !== undefined ? mergeOne(incoming.cn, agent.coze?.cn) : agent.coze?.cn;
+            const com = incoming.com !== undefined ? mergeOne(incoming.com, agent.coze?.com) : agent.coze?.com;
+            if ((incoming.botId != null || incoming.apiKey != null) &&
+                (agent.coze?.cn == null || agent.coze?.com == null)) {
+                const flatBotId = String(incoming.botId ?? agent.coze?.cn?.botId ?? agent.coze?.com?.botId ?? '').trim();
+                const flatKey = (incoming.apiKey != null && String(incoming.apiKey).trim()) ||
+                    (agent.coze?.cn?.apiKey && String(agent.coze.cn.apiKey).trim()) ||
+                    (agent.coze?.com?.apiKey && String(agent.coze.com.apiKey).trim()) ||
+                    '';
+                const flat = flatBotId ? { botId: flatBotId, apiKey: flatKey } : undefined;
+                agent.coze = {
+                    region,
+                    cn: cn ?? flat ?? undefined,
+                    com: com ?? flat ?? undefined,
+                    endpoint: endpointVal || undefined,
+                };
+            }
+            else {
+                agent.coze = {
+                    region,
+                    cn: cn ?? undefined,
+                    com: com ?? undefined,
+                    endpoint: endpointVal || undefined,
+                };
+            }
+        }
+        if (updates.openclawx !== undefined)
+            agent.openclawx = updates.openclawx;
         await this.writeAgentsFile(file);
         return { ...agent, isDefault: agent.id === DEFAULT_AGENT_ID };
     }

package/dist/server/agents/agents.controller.d.ts

@@ -1,3 +1,4 @@
+import { Response } from 'express';
 import { AgentsService } from './agents.service.js';
 export declare class AgentsController {
     private readonly agentsService;
@@ -48,4 +49,19 @@ export declare class AgentsController {
     }): {
         success: boolean;
     };
+    /** 供远程 OpenClawX 代理调用：一次性返回助手回复 */
+    proxyChat(body: {
+        sessionId: string;
+        message: string;
+        agentId?: string;
+    }): Promise<{
+        success: boolean;
+        text: string;
+    }>;
+    /** 供远程 OpenClawX 代理调用：SSE 流式返回助手回复 */
+    proxyChatStream(body: {
+        sessionId: string;
+        message: string;
+        agentId?: string;
+    }, res: Response): Promise<void>;
 }

package/dist/server/agents/agents.controller.js

@@ -10,8 +10,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { Controller, Delete, Get, Patch, Post, Body, Param, Header, HttpException, HttpStatus, } from '@nestjs/common';
+import { Controller, Delete, Get, Patch, Post, Body, Param, Res, Header, HttpException, HttpStatus, } from '@nestjs/common';
 import { AgentsService } from './agents.service.js';
+import { runForChannelStream, runForChannelCollect } from '../../core/agent/proxy/index.js';
 let AgentsController = class AgentsController {
     agentsService;
     constructor(agentsService) {
@@ -86,6 +87,48 @@ let AgentsController = class AgentsController {
         });
         return { success: true };
     }
+    /** 供远程 OpenClawX 代理调用：一次性返回助手回复 */
+    async proxyChat(body) {
+        const sessionId = body?.sessionId ?? '';
+        const message = body?.message ?? '';
+        const agentId = body?.agentId ?? 'default';
+        if (!sessionId || !message) {
+            throw new HttpException('sessionId and message are required', HttpStatus.BAD_REQUEST);
+        }
+        try {
+            const text = await runForChannelCollect({ sessionId, message, agentId });
+            return { success: true, text };
+        }
+        catch (error) {
+            throw new HttpException(error?.message ?? 'Proxy chat failed', HttpStatus.INTERNAL_SERVER_ERROR);
+        }
+    }
+    /** 供远程 OpenClawX 代理调用：SSE 流式返回助手回复 */
+    async proxyChatStream(body, res) {
+        const sessionId = body?.sessionId ?? '';
+        const message = body?.message ?? '';
+        const agentId = body?.agentId ?? 'default';
+        if (!sessionId || !message) {
+            res.status(400).json({ error: 'sessionId and message are required' });
+            return;
+        }
+        res.flushHeaders();
+        try {
+            await runForChannelStream({ sessionId, message, agentId }, {
+                onChunk(delta) {
+                    res.write(`data: ${JSON.stringify({ delta })}\n\n`);
+                },
+                onDone() {
+                    res.write(`data: ${JSON.stringify({ done: true })}\n\n`);
+                    res.end();
+                },
+            });
+        }
+        catch (error) {
+            res.write(`data: ${JSON.stringify({ error: error?.message ?? 'Stream failed' })}\n\n`);
+            res.end();
+        }
+    }
 };
 __decorate([
     Post('sessions'),
@@ -145,6 +188,24 @@ __decorate([
     __metadata("design:paramtypes", [String, Object]),
     __metadata("design:returntype", void 0)
 ], AgentsController.prototype, "appendMessage", null);
+__decorate([
+    Post('proxy-chat'),
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "proxyChat", null);
+__decorate([
+    Post('proxy-chat/stream'),
+    Header('Content-Type', 'text/event-stream'),
+    Header('Cache-Control', 'no-cache'),
+    Header('Connection', 'keep-alive'),
+    __param(0, Body()),
+    __param(1, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "proxyChatStream", null);
 AgentsController = __decorate([
     Controller('agents'),
     __metadata("design:paramtypes", [AgentsService])