@next-open-ai/openclawx 0.8.36 → 0.8.40

package/dist/core/mcp/operator.js

@@ -113,7 +113,7 @@ export async function getMcpToolDefinitions(serverConfigs, options = {}) {
             try {
                 const tools = await client.listTools();
                 const serverId = `mcp${i}`;
-                const definitions = mcpToolsToToolDefinitions(tools, client, serverId);
+                const definitions = mcpToolsToToolDefinitions(tools, client, serverId, options.maxResultTokens);
                 allTools.push(...definitions);
                 toolsListed = true;
                 break;

package/dist/core/tools/index.d.ts

@@ -6,3 +6,4 @@ export { createSwitchAgentTool } from "./switch-agent-tool.js";
 export { createListAgentsTool } from "./list-agents-tool.js";
 export { createCreateAgentTool } from "./create-agent-tool.js";
 export { createGetBookmarkTagsTool, createSaveBookmarkTool, createAddBookmarkTagTool, } from "./bookmark-tool.js";
+export { createWebSearchTool } from "./web-search/index.js";

package/dist/core/tools/index.js

@@ -6,3 +6,4 @@ export { createSwitchAgentTool } from "./switch-agent-tool.js";
 export { createListAgentsTool } from "./list-agents-tool.js";
 export { createCreateAgentTool } from "./create-agent-tool.js";
 export { createGetBookmarkTagsTool, createSaveBookmarkTool, createAddBookmarkTagTool, } from "./bookmark-tool.js";
+export { createWebSearchTool } from "./web-search/index.js";

package/dist/core/tools/truncate-result.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 工具返回结果按 token 估算截断：超过 maxTokens 时从尾部裁剪并打日志。
+ * 用于 MCP、web_search 等单次返回可能过大的场景。
+ */
+/** 粗略按字符估算 token（中英混合约 1/3） */
+export declare function estTokensFromChars(chars: number): number;
+/**
+ * 若 text 估算 token 超过 maxTokens，则保留前 maxTokens 对应字符并打日志，否则返回原 text。
+ * @param text 原始文本
+ * @param maxTokens 最大保留 token 数（仅当 > 0 时生效）
+ * @param toolLabel 工具标识，用于日志
+ * @returns 截断后的文本（可能为原 text）
+ */
+export declare function truncateTextToMaxTokens(text: string, maxTokens: number, toolLabel: string): string;

package/dist/core/tools/truncate-result.js

@@ -0,0 +1,27 @@
+/**
+ * 工具返回结果按 token 估算截断：超过 maxTokens 时从尾部裁剪并打日志。
+ * 用于 MCP、web_search 等单次返回可能过大的场景。
+ */
+const LOG_PREFIX = "[tool-result]";
+/** 粗略按字符估算 token（中英混合约 1/3） */
+export function estTokensFromChars(chars) {
+    return Math.ceil(chars / 3);
+}
+/**
+ * 若 text 估算 token 超过 maxTokens，则保留前 maxTokens 对应字符并打日志，否则返回原 text。
+ * @param text 原始文本
+ * @param maxTokens 最大保留 token 数（仅当 > 0 时生效）
+ * @param toolLabel 工具标识，用于日志
+ * @returns 截断后的文本（可能为原 text）
+ */
+export function truncateTextToMaxTokens(text, maxTokens, toolLabel) {
+    if (!text || maxTokens <= 0)
+        return text;
+    const est = estTokensFromChars(text.length);
+    if (est <= maxTokens)
+        return text;
+    const keepChars = Math.max(1, maxTokens * 3);
+    const truncated = text.slice(0, keepChars);
+    console.log(`${LOG_PREFIX} ${toolLabel} 返回超限 estTokens=${est} maxTokens=${maxTokens} 已从尾部裁剪，保留约 ${maxTokens} token`);
+    return truncated;
+}

package/dist/core/tools/web-search/create-web-search-tool.d.ts

@@ -0,0 +1,17 @@
+import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
+export interface WebSearchToolOptions {
+    enabled: boolean;
+    provider: "brave" | "duck-duck-scrape";
+    apiKey?: string;
+    timeoutSeconds?: number;
+    cacheTtlMinutes?: number;
+    maxResults?: number;
+    /** 单次搜索返回内容最大 token；超过则从尾部裁剪并打日志；不配置则不限制 */
+    maxResultTokens?: number;
+}
+/**
+ * 创建 web_search 工具。
+ * - enabled 为 false 时返回 null，调用方不应将工具加入 customTools。
+ * - enabled 为 true 但当前 provider 不可用（如 Brave 无 Key）时仍返回工具，执行时空转，返回固定提示。
+ */
+export declare function createWebSearchTool(options: WebSearchToolOptions): ToolDefinition | null;

package/dist/core/tools/web-search/create-web-search-tool.js

@@ -0,0 +1,87 @@
+import { Type } from "@sinclair/typebox";
+import { getWebSearchProvider } from "./providers/index.js";
+import { truncateTextToMaxTokens } from "../truncate-result.js";
+const WebSearchSchema = Type.Object({
+    query: Type.String({
+        description: "搜索关键词或问题，例如：当前天气、最新新闻、某概念解释等",
+    }),
+    count: Type.Optional(Type.Number({
+        description: "返回结果条数，1-10，默认 5",
+        minimum: 1,
+        maximum: 10,
+    })),
+    country: Type.Optional(Type.String({
+        description: "可选，地区代码（如 us、cn），部分 Provider 支持",
+    })),
+    freshness: Type.Optional(Type.String({
+        description: "可选，时间范围（如 pd、pw、pm），部分 Provider 支持",
+    })),
+});
+const WEB_SEARCH_NOOP_MESSAGE = "当前在线搜索不可用：所选 Provider 未配置或不可用（如选择了 Brave 但未配置 API Key）。请在设置中配置 Brave API Key，或将智能体在线搜索 Provider 改为 DuckDuckGo。";
+/**
+ * 创建 web_search 工具。
+ * - enabled 为 false 时返回 null，调用方不应将工具加入 customTools。
+ * - enabled 为 true 但当前 provider 不可用（如 Brave 无 Key）时仍返回工具，执行时空转，返回固定提示。
+ */
+export function createWebSearchTool(options) {
+    if (!options || options.enabled !== true)
+        return null;
+    const provider = getWebSearchProvider(options.provider);
+    const apiKey = options.provider === "brave" ? options.apiKey : undefined;
+    const available = provider.isAvailable({ apiKey });
+    const timeoutSeconds = options.timeoutSeconds ?? 15;
+    const cacheTtlMinutes = options.cacheTtlMinutes ?? 5;
+    const maxResults = options.maxResults ?? 5;
+    return {
+        name: "web_search",
+        label: "Web Search",
+        description: "联网搜索：根据查询词从互联网获取最新结果（标题、链接、摘要）。无 API Key 时使用 DuckDuckGo；配置 Brave API Key 后可选用 Brave。在回答需要实时信息、新闻、天气、概念解释等问题前可调用本工具。",
+        parameters: WebSearchSchema,
+        execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
+            if (!available) {
+                return {
+                    content: [{ type: "text", text: WEB_SEARCH_NOOP_MESSAGE }],
+                    details: undefined,
+                };
+            }
+            const query = (params.query ?? "").trim();
+            if (!query) {
+                return {
+                    content: [{ type: "text", text: "请提供搜索关键词（query）。" }],
+                    details: undefined,
+                };
+            }
+            const count = Math.min(10, Math.max(1, params.count ?? maxResults));
+            try {
+                const result = await provider.search({
+                    query,
+                    count,
+                    apiKey,
+                    timeoutSeconds,
+                    cacheTtlMinutes,
+                    country: params.country,
+                    freshness: params.freshness,
+                });
+                const lines = result.results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}${r.description ? `\n   ${r.description}` : ""}`);
+                let text = (result.cached ? "[缓存] " : "") +
+                    `搜索「${result.query}」共 ${result.count} 条（${result.provider}${result.tookMs != null ? `, ${result.tookMs}ms` : ""}）：\n\n` +
+                    (lines.length ? lines.join("\n\n") : "未找到结果。");
+                const maxResultTokens = options.maxResultTokens;
+                if (typeof maxResultTokens === "number" && maxResultTokens > 0) {
+                    text = truncateTextToMaxTokens(text, maxResultTokens, "web_search");
+                }
+                return {
+                    content: [{ type: "text", text }],
+                    details: { query: result.query, count: result.count, provider: result.provider },
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: "text", text: `在线搜索失败: ${msg}` }],
+                    details: undefined,
+                };
+            }
+        },
+    };
+}

package/dist/core/tools/web-search/index.d.ts

@@ -0,0 +1,4 @@
+export { createWebSearchTool } from "./create-web-search-tool.js";
+export type { WebSearchToolOptions } from "./create-web-search-tool.js";
+export type { WebSearchProviderId, WebSearchResultItem, WebSearchProviderResult, IWebSearchProvider, WebSearchSearchParams, } from "./types.js";
+export { getWebSearchProvider } from "./providers/index.js";

package/dist/core/tools/web-search/index.js

@@ -0,0 +1,2 @@
+export { createWebSearchTool } from "./create-web-search-tool.js";
+export { getWebSearchProvider } from "./providers/index.js";

package/dist/core/tools/web-search/providers/brave.d.ts

@@ -0,0 +1,2 @@
+import type { IWebSearchProvider } from "../types.js";
+export declare const braveProvider: IWebSearchProvider;

package/dist/core/tools/web-search/providers/brave.js

@@ -0,0 +1,87 @@
+const PROVIDER_ID = "brave";
+const BRAVE_WEB_SEARCH_URL = "https://api.search.brave.com/res/v1/web/search";
+const cache = new Map();
+function cacheKey(query, count) {
+    return `${PROVIDER_ID}:${query}:${count}`;
+}
+export const braveProvider = {
+    id: PROVIDER_ID,
+    isAvailable(options) {
+        return !!(options.apiKey && String(options.apiKey).trim());
+    },
+    async search(params) {
+        const query = (params.query ?? "").trim();
+        const count = Math.min(10, Math.max(1, params.count ?? 5));
+        const apiKey = params.apiKey?.trim();
+        if (!apiKey) {
+            return {
+                query,
+                provider: PROVIDER_ID,
+                results: [],
+                count: 0,
+                tookMs: 0,
+                cached: false,
+            };
+        }
+        const cacheTtlMinutes = typeof params.cacheTtlMinutes === "number" && params.cacheTtlMinutes >= 0 ? params.cacheTtlMinutes : 0;
+        const key = cacheKey(query, count);
+        if (cacheTtlMinutes > 0) {
+            const hit = cache.get(key);
+            if (hit && hit.expiresAt > Date.now()) {
+                return { ...hit.result, cached: true };
+            }
+        }
+        const timeoutMs = (params.timeoutSeconds ?? 15) * 1000;
+        const controller = new AbortController();
+        const t = setTimeout(() => controller.abort(), timeoutMs);
+        const start = Date.now();
+        try {
+            const url = new URL(BRAVE_WEB_SEARCH_URL);
+            url.searchParams.set("q", query);
+            url.searchParams.set("count", String(count));
+            if (params.country?.trim())
+                url.searchParams.set("country", params.country.trim());
+            if (params.freshness?.trim())
+                url.searchParams.set("freshness", params.freshness.trim());
+            const res = await fetch(url.toString(), {
+                method: "GET",
+                headers: {
+                    Accept: "application/json",
+                    "X-Subscription-Token": apiKey,
+                },
+                signal: controller.signal,
+            });
+            const tookMs = Date.now() - start;
+            if (!res.ok) {
+                const text = await res.text();
+                throw new Error(`Brave Search API error ${res.status}: ${text || res.statusText}`);
+            }
+            const data = (await res.json());
+            const rawResults = data.web?.results ?? [];
+            const results = rawResults.slice(0, count).map((r) => ({
+                title: r.title ?? "",
+                url: r.url ?? "",
+                description: r.description,
+                published: r.age,
+            }));
+            const result = {
+                query,
+                provider: PROVIDER_ID,
+                results,
+                count: results.length,
+                tookMs,
+                cached: false,
+            };
+            if (cacheTtlMinutes > 0) {
+                cache.set(key, {
+                    result,
+                    expiresAt: Date.now() + cacheTtlMinutes * 60 * 1000,
+                });
+            }
+            return result;
+        }
+        finally {
+            clearTimeout(t);
+        }
+    },
+};

package/dist/core/tools/web-search/providers/duck-duck-scrape.d.ts

@@ -0,0 +1,2 @@
+import type { IWebSearchProvider } from "../types.js";
+export declare const duckDuckScrapeProvider: IWebSearchProvider;

package/dist/core/tools/web-search/providers/duck-duck-scrape.js

@@ -0,0 +1,47 @@
+import { search as ddgSearch } from "duck-duck-scrape";
+const PROVIDER_ID = "duck-duck-scrape";
+const cache = new Map();
+function cacheKey(query, count) {
+    return `${PROVIDER_ID}:${query}:${count}`;
+}
+export const duckDuckScrapeProvider = {
+    id: PROVIDER_ID,
+    isAvailable() {
+        return true;
+    },
+    async search(params) {
+        const query = (params.query ?? "").trim();
+        const count = Math.min(10, Math.max(1, params.count ?? 5));
+        const cacheTtlMinutes = typeof params.cacheTtlMinutes === "number" && params.cacheTtlMinutes >= 0 ? params.cacheTtlMinutes : 0;
+        const key = cacheKey(query, count);
+        if (cacheTtlMinutes > 0) {
+            const hit = cache.get(key);
+            if (hit && hit.expiresAt > Date.now()) {
+                return { ...hit.result, cached: true };
+            }
+        }
+        const start = Date.now();
+        const res = await ddgSearch(query, {});
+        const tookMs = Date.now() - start;
+        const results = (res.results ?? []).slice(0, count).map((r) => ({
+            title: r.title ?? "",
+            url: r.url ?? "",
+            description: r.description,
+        }));
+        const result = {
+            query,
+            provider: PROVIDER_ID,
+            results,
+            count: results.length,
+            tookMs,
+            cached: false,
+        };
+        if (cacheTtlMinutes > 0) {
+            cache.set(key, {
+                result,
+                expiresAt: Date.now() + cacheTtlMinutes * 60 * 1000,
+            });
+        }
+        return result;
+    },
+};

package/dist/core/tools/web-search/providers/index.d.ts

@@ -0,0 +1,5 @@
+import type { WebSearchProviderId, IWebSearchProvider } from "../types.js";
+import { duckDuckScrapeProvider } from "./duck-duck-scrape.js";
+import { braveProvider } from "./brave.js";
+export declare function getWebSearchProvider(id: WebSearchProviderId): IWebSearchProvider;
+export { duckDuckScrapeProvider, braveProvider };

package/dist/core/tools/web-search/providers/index.js

@@ -0,0 +1,13 @@
+import { duckDuckScrapeProvider } from "./duck-duck-scrape.js";
+import { braveProvider } from "./brave.js";
+const providers = {
+    "duck-duck-scrape": duckDuckScrapeProvider,
+    brave: braveProvider,
+};
+export function getWebSearchProvider(id) {
+    const p = providers[id];
+    if (!p)
+        throw new Error(`Unknown web search provider: ${id}`);
+    return p;
+}
+export { duckDuckScrapeProvider, braveProvider };

package/dist/core/tools/web-search/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 在线搜索 Provider 统一类型，供 web_search 工具与多 Provider 实现使用。
+ */
+export type WebSearchProviderId = "duck-duck-scrape" | "brave";
+export interface WebSearchResultItem {
+    title: string;
+    url: string;
+    description?: string;
+    published?: string;
+    siteName?: string;
+}
+export interface WebSearchProviderResult {
+    query: string;
+    provider: WebSearchProviderId;
+    results: WebSearchResultItem[];
+    count: number;
+    tookMs?: number;
+    cached?: boolean;
+}
+export interface WebSearchSearchParams {
+    query: string;
+    count?: number;
+    apiKey?: string;
+    timeoutSeconds?: number;
+    cacheTtlMinutes?: number;
+    country?: string;
+    freshness?: string;
+}
+export interface IWebSearchProvider {
+    id: WebSearchProviderId;
+    isAvailable(options: {
+        apiKey?: string;
+    }): boolean;
+    search(params: WebSearchSearchParams): Promise<WebSearchProviderResult>;
+}

package/dist/core/tools/web-search/types.js

@@ -0,0 +1,4 @@
+/**
+ * 在线搜索 Provider 统一类型，供 web_search 工具与多 Provider 实现使用。
+ */
+export {};

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

@@ -145,7 +145,7 @@ async function handleAgentChatInner(client, targetSessionId, message, params) {
                 apiKey = agentConfig.apiKey;
         }
         const runnerType = agentConfig?.runnerType ?? "local";
-        const isProxyAgent = runnerType === "coze" || runnerType === "openclawx" || runnerType === "opencode";
+        const isProxyAgent = runnerType === "coze" || runnerType === "openclawx" || runnerType === "opencode" || runnerType === "claude_code";
         if (isProxyAgent) {
             console.log(`[agent.chat] Using proxy agent (${runnerType}) for session=${targetSessionId}, agentId=${currentAgentId}`);
         }
@@ -211,8 +211,10 @@ async function handleAgentChatInner(client, targetSessionId, message, params) {
                 maxSessions: maxAgentSessions,
                 targetAgentId: effectiveTargetAgentId,
                 mcpServers: agentConfig?.mcpServers,
+                mcpMaxResultTokens: agentConfig?.mcpMaxResultTokens,
                 systemPrompt: agentConfig?.systemPrompt,
                 useLongMemory: agentConfig?.useLongMemory,
+                webSearch: agentConfig?.webSearch,
             });
         }
         catch (err) {

package/dist/gateway/methods/run-scheduled-task.js

@@ -61,8 +61,10 @@ export async function handleRunScheduledTask(req, res) {
             modelId,
             apiKey,
             mcpServers: agentConfig?.mcpServers,
+            mcpMaxResultTokens: agentConfig?.mcpMaxResultTokens,
             systemPrompt: agentConfig?.systemPrompt,
             useLongMemory: agentConfig?.useLongMemory,
+            webSearch: agentConfig?.webSearch,
         });
         let assistantContent = "";
         let turnPromptTokens = 0;

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' | 'runnerType' | 'coze' | 'openclawx' | 'opencode'>>): Promise<{
+    updateAgent(id: string, body: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'mcpMaxResultTokens' | 'systemPrompt' | 'icon' | 'runnerType' | 'coze' | 'openclawx' | 'opencode' | 'claudeCode' | 'useLongMemory' | 'webSearch'>>): Promise<{
         success: boolean;
         data: AgentConfigItem;
     }>;

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

@@ -3,8 +3,8 @@ import { DatabaseService } from '../database/database.service.js';
 import { WorkspaceService } from '../workspace/workspace.service.js';
 /** 缺省智能体 ID / 工作空间名，不可删除；对应目录 ~/.openbot/workspace/default */
 export declare const DEFAULT_AGENT_ID = "default";
-/** 执行器类型：local=本机，coze/openclawx/opencode=远程代理 */
-export type AgentRunnerType = 'local' | 'coze' | 'openclawx' | 'opencode';
+/** 执行器类型：local=本机，coze/openclawx/opencode=远程代理，claude_code=本机 Claude Code CLI */
+export type AgentRunnerType = 'local' | 'coze' | 'openclawx' | 'opencode' | 'claude_code';
 /** Coze 站点：cn=国内 api.coze.cn，com=国际 api.coze.com，凭证不通用 */
 export type CozeRegion = 'cn' | 'com';
 /** 某站点的 Bot 凭证 */
@@ -60,6 +60,8 @@ export interface AgentConfigItem {
     isDefault?: boolean;
     /** MCP 配置：数组（含 transport）或标准 JSON 对象（key 为服务器名称），创建 Session 时归一化使用 */
     mcpServers?: McpServerConfig[] | McpServersStandardFormat;
+    /** MCP 单次返回最大 token；不配置则不限制 */
+    mcpMaxResultTokens?: number;
     /** 自定义系统提示词，会与技能等一起组成最终 systemPrompt */
     systemPrompt?: string;
     /** 智能体图标标识（前端预设图标 id，如 default、star、code 等） */
@@ -72,8 +74,18 @@ export interface AgentConfigItem {
     openclawx?: AgentOpenClawXConfig;
     /** OpenCode 代理配置（runnerType 为 opencode 时使用） */
     opencode?: AgentOpenCodeConfig;
+    /** Claude Code 代理配置（runnerType 为 claude_code 时使用）：工作目录等 */
+    claudeCode?: {
+        workingDirectory?: string;
+    };
     /** 是否使用经验（长记忆）：memory_recall / save_experience；默认 true */
     useLongMemory?: boolean;
+    /** 在线搜索：启用后该智能体拥有 web_search 工具；可选默认 provider、maxResultTokens（前端默认 64K） */
+    webSearch?: {
+        enabled?: boolean;
+        provider?: 'brave' | 'duck-duck-scrape';
+        maxResultTokens?: number;
+    };
 }
 export interface DeleteAgentOptions {
     /** 是否同时删除该工作区在磁盘上的目录及文件；默认 false（仅删数据库中的工作区相关数据，保留目录） */
@@ -104,7 +116,7 @@ export declare class AgentConfigService {
         /** 智能体图标标识 */
         icon?: string;
     }): Promise<AgentConfigItem>;
-    updateAgent(id: string, updates: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'systemPrompt' | 'icon' | 'runnerType' | 'coze' | 'openclawx' | 'opencode' | 'useLongMemory'>>): Promise<AgentConfigItem>;
+    updateAgent(id: string, updates: Partial<Pick<AgentConfigItem, 'name' | 'provider' | 'model' | 'modelItemCode' | 'mcpServers' | 'mcpMaxResultTokens' | 'systemPrompt' | 'icon' | 'runnerType' | 'coze' | 'openclawx' | 'opencode' | 'claudeCode' | 'useLongMemory' | 'webSearch'>>): Promise<AgentConfigItem>;
     deleteAgent(id: string, options?: DeleteAgentOptions): Promise<void>;
     /** 仅删除数据库中与该工作区相关的数据（会话、定时任务、收藏等），不删磁盘目录 */
     private deleteWorkspaceDataFromDb;

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

@@ -162,6 +162,8 @@ let AgentConfigService = class AgentConfigService {
             agent.modelItemCode = updates.modelItemCode;
         if (updates.mcpServers !== undefined)
             agent.mcpServers = updates.mcpServers;
+        if (updates.mcpMaxResultTokens !== undefined)
+            agent.mcpMaxResultTokens = updates.mcpMaxResultTokens;
         if (updates.systemPrompt !== undefined)
             agent.systemPrompt = updates.systemPrompt?.trim() || undefined;
         if (updates.icon !== undefined)
@@ -211,8 +213,24 @@ let AgentConfigService = class AgentConfigService {
             agent.openclawx = updates.openclawx;
         if (updates.opencode !== undefined)
             agent.opencode = updates.opencode;
+        if (updates.claudeCode !== undefined)
+            agent.claudeCode = updates.claudeCode;
         if (updates.useLongMemory !== undefined)
             agent.useLongMemory = updates.useLongMemory;
+        if (updates.webSearch !== undefined) {
+            agent.webSearch =
+                updates.webSearch && (updates.webSearch.enabled || updates.webSearch.provider)
+                    ? {
+                        enabled: !!updates.webSearch.enabled,
+                        provider: updates.webSearch.provider === 'brave' || updates.webSearch.provider === 'duck-duck-scrape'
+                            ? updates.webSearch.provider
+                            : 'duck-duck-scrape',
+                        maxResultTokens: updates.webSearch.maxResultTokens != null && typeof updates.webSearch.maxResultTokens === 'number' && updates.webSearch.maxResultTokens > 0
+                            ? updates.webSearch.maxResultTokens
+                            : undefined,
+                    }
+                    : undefined;
+        }
         await this.writeAgentsFile(file);
         await addPendingAgentReload(id).catch(() => { });
         return { ...agent, isDefault: agent.id === DEFAULT_AGENT_ID };

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

@@ -39,6 +39,19 @@ export declare class ConfigController {
                 embeddingModelItemCode?: string;
             };
             channels?: import("../../core/config/desktop-config.js").ChannelsConfig;
+            tools?: {
+                webSearch?: {
+                    defaultProvider?: "brave" | "duck-duck-scrape";
+                    providers?: {
+                        brave?: {
+                            apiKey?: string;
+                        };
+                    };
+                    timeoutSeconds?: number;
+                    cacheTtlMinutes?: number;
+                    maxResults?: number;
+                };
+            };
         };
     }>;
     updateConfig(updates: Partial<AppConfig>): Promise<{
@@ -78,6 +91,19 @@ export declare class ConfigController {
                 embeddingModelItemCode?: string;
             };
             channels?: import("../../core/config/desktop-config.js").ChannelsConfig;
+            tools?: {
+                webSearch?: {
+                    defaultProvider?: "brave" | "duck-duck-scrape";
+                    providers?: {
+                        brave?: {
+                            apiKey?: string;
+                        };
+                    };
+                    timeoutSeconds?: number;
+                    cacheTtlMinutes?: number;
+                    maxResults?: number;
+                };
+            };
         };
     }>;
     getProviders(): Promise<{

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

@@ -71,6 +71,20 @@ export interface AppConfig {
     };
     /** 通道配置：飞书、Telegram 等 token/key */
     channels?: ChannelsConfig;
+    /** 工具相关：在线搜索等，Brave API Key 存于 providers.brave.apiKey */
+    tools?: {
+        webSearch?: {
+            defaultProvider?: 'brave' | 'duck-duck-scrape';
+            providers?: {
+                brave?: {
+                    apiKey?: string;
+                };
+            };
+            timeoutSeconds?: number;
+            cacheTtlMinutes?: number;
+            maxResults?: number;
+        };
+    };
 }
 export declare class ConfigService {
     private readonly agentConfigService;

package/package.json

@@ -3,7 +3,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.8.36",
+    "version": "0.8.40",
     "description": "OpenClawX - A professional desktop application for managing and executing AI agents with real-time chat, session management, and skills browsing.",
     "type": "module",
     "main": "dist/index.js",
@@ -26,6 +26,7 @@
         "openbot": "./dist/cli/cli.js"
     },
     "dependencies": {
+        "@instantlyeasy/claude-code-sdk-ts": "^0.3.3",
         "@larksuiteoapi/node-sdk": "^1.59.0",
         "@mariozechner/pi-ai": "^0.51.2",
         "@mariozechner/pi-coding-agent": "^0.51.2",
@@ -41,6 +42,7 @@
         "commander": "^14.0.2",
         "croner": "^9.1.0",
         "dingtalk-stream": "^2.1.4",
+        "duck-duck-scrape": "^2.2.7",
         "multer": "^1.4.5-lts.1",
         "node-llama-cpp": "^3.15.0",
         "qrcode": "^1.5.4",