@workclaw/openclaw-workclaw 1.0.18 → 1.0.19

package/dist/api.d.ts

@@ -0,0 +1,3 @@
+export { workclawPlugin } from "./src/channel.js";
+export * from "./src/setup-core.js";
+export * from "./src/setup-surface.js";

package/dist/api.js

@@ -0,0 +1,3 @@
+export { workclawPlugin } from "./src/channel.js";
+export * from "./src/setup-core.js";
+export * from "./src/setup-surface.js";

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: import("openclaw/plugin-sdk").ChannelConfigSchema;
+    register: (api: OpenClawPluginApi) => void;
+    channelPlugin: import("openclaw/plugin-sdk").ChannelPlugin<import("./src/types.js").ResolvedWorkclawAccount>;
+    setChannelRuntime?: (runtime: import("openclaw/plugin-sdk").PluginRuntime) => void;
+};
+export default _default;

package/dist/index.js

@@ -0,0 +1,263 @@
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore - types from openclaw 4.2, local dev uses 3.13
+import { defineChannelPluginEntry } from "openclaw/plugin-sdk/core";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { workclawPlugin } from "./src/channel.js";
+import { setWorkclawRuntime, getWorkclawRuntime, getToolResultHint, } from "./src/runtime.js";
+import { resolveWorkspaceDir, isDefaultWorkspace } from "./src/api/workspace.js";
+import { createPromptsApiHandler } from "./src/api/prompts-api.js";
+import { createAccountsApiHandler } from "./src/api/accounts-api.js";
+import { createSessionApiHandler } from "./src/api/session-api.js";
+import { createSkillsApiHandler } from "./src/api/skills-api.js";
+import { registerAllOpenclawWorkclawCronTools } from "./src/tools/openclaw-workclaw-cron/index.js";
+import { getToolContext, setToolCallIdToRunIdMapping, deleteToolContext, } from "./src/runtime.js";
+import { sendMessageWorkclaw } from "./src/outbound/index.js";
+// ============================================================================
+// Tool output formatting helpers
+// ============================================================================
+function formatToolParams(toolName, params) {
+    if (!params || typeof params !== "object") {
+        return "";
+    }
+    const normalizedToolName = (toolName || "").toLowerCase().trim();
+    const p = params;
+    try {
+        if (normalizedToolName === "exec" || normalizedToolName === "bash" || normalizedToolName === "shell") {
+            const cmd = p.command || p.cmd;
+            if (cmd)
+                return `command: ${String(cmd).slice(0, 200)}`;
+        }
+        else if (normalizedToolName === "read" ||
+            normalizedToolName === "file_read" ||
+            normalizedToolName === "view") {
+            const p2 = p.path;
+            if (p2)
+                return `path: ${p2}`;
+        }
+        else if (normalizedToolName === "write" ||
+            normalizedToolName === "file_write" ||
+            normalizedToolName === "edit" ||
+            normalizedToolName === "patch") {
+            const p2 = p.path;
+            if (p2)
+                return `path: ${p2}`;
+        }
+        else if (normalizedToolName === "web_fetch" ||
+            normalizedToolName === "fetch" ||
+            normalizedToolName === "http_get" ||
+            normalizedToolName === "http_request" ||
+            normalizedToolName === "open_url" ||
+            normalizedToolName === "browser_open" ||
+            normalizedToolName === "open") {
+            const u = p.url;
+            if (u)
+                return `url: ${u}`;
+        }
+        else if (normalizedToolName === "search" ||
+            normalizedToolName === "web_search" ||
+            normalizedToolName === "google_search" ||
+            normalizedToolName === "browser_search" ||
+            normalizedToolName === "browser.search") {
+            const q = p.query || p.q || p.search;
+            if (q)
+                return `query: ${q}`;
+        }
+        else if (normalizedToolName === "image_generate" ||
+            normalizedToolName === "generate_image" ||
+            normalizedToolName === "dalle" ||
+            normalizedToolName === "text_to_image") {
+            const prompt = p.prompt;
+            if (prompt)
+                return `prompt: ${String(prompt).slice(0, 200)}`;
+        }
+        else if (normalizedToolName === "code_interpreter" ||
+            normalizedToolName === "python" ||
+            normalizedToolName === "jupyter") {
+            const code = p.code;
+            if (code)
+                return `code: ${String(code).slice(0, 200)}`;
+        }
+        else if (normalizedToolName === "mcp_deliver" || normalizedToolName === "deliver") {
+            const target = p.target || p.to;
+            if (target)
+                return `target: ${target}`;
+        }
+        else {
+            const entries = Object.entries(p);
+            if (entries.length > 0) {
+                return entries
+                    .map(([k, v]) => {
+                    const vStr = typeof v === "string" ? v : JSON.stringify(v);
+                    return vStr.length > 100 ? `${k}: ${vStr.slice(0, 100)}...` : `${k}: ${vStr}`;
+                })
+                    .join("\n");
+            }
+        }
+    }
+    catch {
+        return String(params);
+    }
+    return "";
+}
+function formatToolOutput(toolName, params, _result) {
+    return formatToolParams(toolName, params);
+}
+// ============================================================================
+// Tool hooks
+// ============================================================================
+function registerToolHooks(api) {
+    api.on("agent_end", (event, ctx) => {
+        const { runId } = ctx || {};
+        if (runId) {
+            deleteToolContext(runId);
+            api.logger?.info?.(`[ToolHook] agent_end runId=${runId} cleaned up`);
+        }
+        return event;
+    });
+    api.on("before_tool_call", (event, _ctx) => {
+        api.logger?.info?.(`[ToolHook] before_tool_call event=${JSON.stringify(event)}`);
+    });
+    api.on("after_tool_call", (event, _ctx) => {
+        api.logger?.info?.(`[ToolHook] after_tool_call event=${JSON.stringify(event)}`);
+        const { runId, toolCallId, toolName, params, result } = event || {};
+        const toolCtx = runId ? getToolContext(runId) : undefined;
+        if (toolCtx && result) {
+            const content = formatToolOutput(toolName, params, result);
+            if (content) {
+                try {
+                    const cfg = getWorkclawRuntime().config.loadConfig();
+                    const formattedToolOutput = {
+                        name: getToolResultHint(toolName),
+                        toolName: toolName,
+                        content: content,
+                        state: "result",
+                    };
+                    sendMessageWorkclaw({
+                        cfg,
+                        to: toolCtx.target,
+                        text: JSON.stringify(formattedToolOutput),
+                        msgType: "26",
+                        accountId: toolCtx.accountId,
+                        openConversationId: toolCtx.openConversationId,
+                        agentId: toolCtx.agentId,
+                        replyToMessageId: toolCtx.replyToMessageId,
+                    }).catch((err) => {
+                        api.logger?.error?.(`[ToolHook] after_tool_call push failed: ${err}`);
+                    });
+                    api.logger?.info?.(`[ToolHook] after_tool_call pushed for toolName=${toolName}`);
+                }
+                catch (err) {
+                    api.logger?.error?.(`[ToolHook] after_tool_call push failed: ${err}`);
+                }
+            }
+        }
+        if (runId && toolCallId) {
+            setToolCallIdToRunIdMapping(toolCallId, runId);
+        }
+        return event;
+    });
+    api.on("tool_result_persist", (event, _ctx) => {
+        return { message: event.message };
+    });
+    api.logger?.info?.(`[ToolHook] Tool execution hooks registered`);
+}
+// ============================================================================
+// Templates
+// ============================================================================
+const templateNames = ["SOUL.md", "IDENTITY.md"];
+/**
+ * 获取插件所在目录，兼容 Windows 下的 file:// URL 问题。
+ * 4.2 的插件加载器在 Windows 上可能传入不带协议前缀的路径。
+ */
+function getPluginDir() {
+    try {
+        const url = import.meta.url;
+        if (!url.startsWith("file://")) {
+            // Windows 路径被直接传入（不带 file:// 前缀），直接取目录
+            return path.dirname(url);
+        }
+        return path.dirname(fileURLToPath(url));
+    }
+    catch {
+        return process.cwd();
+    }
+}
+async function writeFileIfMissing(filePath, content) {
+    try {
+        await writeFile(filePath, content, { encoding: "utf-8", flag: "wx" });
+    }
+    catch (error) {
+        if (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "EEXIST") {
+            return;
+        }
+        throw error;
+    }
+}
+async function releaseTemplates(api) {
+    const workspaceDir = resolveWorkspaceDir(api);
+    // 模板文件在根目录的 templates/ 中，而不是 dist/templates/
+    const currentDir = getPluginDir();
+    const templatesDir = path.join(currentDir.endsWith("dist") ? path.dirname(currentDir) : currentDir, "templates");
+    const shouldOverwrite = isDefaultWorkspace(api);
+    await mkdir(workspaceDir, { recursive: true });
+    await Promise.all(templateNames.map(async (name) => {
+        const sourcePath = path.join(templatesDir, name);
+        const targetPath = path.join(workspaceDir, name);
+        const content = await readFile(sourcePath, "utf-8");
+        if (shouldOverwrite) {
+            await writeFile(targetPath, content, { encoding: "utf-8" });
+        }
+        else {
+            await writeFileIfMissing(targetPath, content);
+        }
+    }));
+    api.logger.info(`openclaw-workclaw templates ready: ${workspaceDir}`);
+}
+// ============================================================================
+// Plugin entry point
+// ============================================================================
+export default defineChannelPluginEntry({
+    id: "openclaw-workclaw",
+    name: "openclaw-workclaw",
+    description: "智小途 channel plugin",
+    configSchema: emptyPluginConfigSchema(),
+    plugin: workclawPlugin,
+    registerFull(api) {
+        setWorkclawRuntime(api.runtime);
+        registerAllOpenclawWorkclawCronTools(api);
+        registerToolHooks(api);
+        api.registerService({
+            id: "openclaw-workclaw-templates",
+            start: async () => {
+                await releaseTemplates(api);
+            },
+        });
+        api.registerHttpRoute({
+            path: "/openclaw-workclaw/workspace/prompts",
+            handler: createPromptsApiHandler(api),
+            auth: "plugin",
+        });
+        api.registerHttpRoute({
+            path: "/openclaw-workclaw/accounts",
+            handler: createAccountsApiHandler(api),
+            auth: "plugin",
+        });
+        api.registerHttpRoute({
+            path: "/openclaw-workclaw/skills",
+            handler: createSkillsApiHandler(api),
+            auth: "plugin",
+        });
+        api.registerHttpRoute({
+            path: "/openclaw-workclaw/sessions",
+            handler: createSessionApiHandler(api),
+            auth: "plugin",
+            match: "prefix",
+        });
+    },
+});

package/dist/setup-entry.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelSetupEntryContract<import("openclaw/plugin-sdk").ChannelPlugin>;
+export default _default;

package/dist/setup-entry.js

@@ -0,0 +1,12 @@
+import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
+export default defineBundledChannelSetupEntry({
+    importMetaUrl: import.meta.url,
+    plugin: {
+        specifier: "./api.js",
+        exportName: "workclawPlugin",
+    },
+    secrets: {
+        specifier: "./src/secret-contract-api.js",
+        exportName: "channelSecrets",
+    },
+});

package/dist/src/accounts.d.ts

@@ -0,0 +1,66 @@
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+import type { ResolvedWorkclawAccount, WorkclawConfig } from './types.js';
+/**
+ * Normalize account ID by trimming whitespace
+ */
+export declare function normalizeAccountId(accountId: string | null | undefined): string;
+/**
+ * Build the lookup cache from existing accounts in cfg.
+ * Called once at gateway startup.
+ */
+export declare function buildAccountMap(cfg: OpenClawConfig): void;
+/**
+ * Resolve accountId by userId + agentId.
+ * First checks cache, then falls back to iteration.
+ */
+export declare function resolveAccountByUserIdAndAgentId(cfg: OpenClawConfig, userId: string, agentId: string): string | null;
+/**
+ * Allocate a new workspace-N accountId and register it in the map.
+ */
+export declare function allocateWorkerAccountId(_cfg: OpenClawConfig, userId: string, agentId: string): string;
+/**
+ * Refresh the cache when an account's userId or agentId changes.
+ */
+export declare function refreshAccountCache(cfg: OpenClawConfig): void;
+/**
+ * List all account IDs.
+ * If no accounts are configured but plugin has workclaw config, returns [DEFAULT_ACCOUNT_ID].
+ */
+export declare function listWorkclawAccountIds(cfg: OpenClawConfig): string[];
+/**
+ * Resolve the default account ID.
+ */
+export declare function resolveDefaultWorkclawAccountId(cfg: OpenClawConfig): string;
+export declare function isWorkclawAccountConfigured(config: {
+    appKey?: string;
+    appSecret?: string;
+    agentId?: string | number;
+}): boolean;
+/**
+ * Resolve a complete account with merged config.
+ */
+export declare function resolveWorkclawAccount(params: {
+    cfg: OpenClawConfig;
+    accountId?: string | null;
+}): ResolvedWorkclawAccount;
+/**
+ * List all enabled and configured accounts.
+ */
+export declare function listEnabledWorkclawAccounts(cfg: OpenClawConfig): ResolvedWorkclawAccount[];
+/**
+ * Resolve account and apply cached connection config if available.
+ * This ensures that appKey/appSecret etc. use the stable values captured at connection time,
+ * not potentially mutated values from cfg at resolution time.
+ */
+export declare function resolveWorkclawAccountWithCache(params: {
+    cfg: OpenClawConfig;
+    accountId?: string | null;
+}): ResolvedWorkclawAccount;
+/**
+ * Inspect and probe workclaw credentials.
+ * Returns a function that can be called to test the connection.
+ */
+export declare function inspectWorkclawCredentials(workclawCfg?: WorkclawConfig): (() => Promise<{
+    ok: boolean;
+    botName?: string;
+}>) | null;

package/dist/src/accounts.js

@@ -0,0 +1,279 @@
+import { DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk/account-id';
+import { getWorkclawLogger, getWorkclawConnectionConfig } from './runtime.js';
+// =============================================================================
+// In-memory lookup cache for (userId, agentId) → workspace-N accountId
+// Problem: OpenClaw doesn't support dashes in account IDs, agentId can be negative
+// Solution: workspace-N naming + in-memory Map for O(1) lookups
+// =============================================================================
+/**
+ * Normalize account ID by trimming whitespace
+ */
+export function normalizeAccountId(accountId) {
+    return String(accountId ?? '').trim();
+}
+/**
+ * Key format for the lookup map: "userId|agentId"
+ */
+function makeLookupKey(userId, agentId) {
+    return `${userId}|${agentId}`;
+}
+/**
+ * In-memory map: lookupKey -> accountId
+ */
+const lookupCache = new Map();
+/**
+ * In-memory map: accountId -> { userId, agentId }
+ */
+const accountIndex = new Map();
+/**
+ * Next workspace number to allocate
+ */
+let nextWorkspaceNum = 1;
+/**
+ * Build the lookup cache from existing accounts in cfg.
+ * Called once at gateway startup.
+ */
+export function buildAccountMap(cfg) {
+    lookupCache.clear();
+    accountIndex.clear();
+    nextWorkspaceNum = 1;
+    const _WorkclawConfig = (cfg.channels?.['openclaw-workclaw'] || {});
+    const accounts = _WorkclawConfig?.accounts;
+    if (!accounts || typeof accounts !== 'object')
+        return;
+    for (const [accountId, accountCfg] of Object.entries(accounts)) {
+        if (!accountCfg)
+            continue;
+        const userId = accountCfg.userId || _WorkclawConfig.userId;
+        const agentId = accountCfg.agentId;
+        if (!agentId)
+            continue;
+        // userId may not be present for config-defined accounts; only build
+        // lookup if userId is available (dynamically created accounts have it)
+        if (userId) {
+            const key = makeLookupKey(String(userId), String(agentId));
+            lookupCache.set(key, accountId);
+        }
+        accountIndex.set(accountId, { userId: String(userId ?? ''), agentId: String(agentId) });
+        if (accountId.startsWith('workspace-')) {
+            const num = Number.parseInt(accountId.slice(accountId.lastIndexOf('-') + 1), 10);
+            if (!Number.isNaN(num) && num >= nextWorkspaceNum) {
+                nextWorkspaceNum = num + 1;
+            }
+        }
+    }
+    // 默认账户允许直接使用顶层 userId/agentId，不要求必须存在 accounts.default
+    if (!accountIndex.has(DEFAULT_ACCOUNT_ID) && _WorkclawConfig.userId && _WorkclawConfig.agentId) {
+        const userId = String(_WorkclawConfig.userId);
+        const agentId = String(_WorkclawConfig.agentId);
+        const key = makeLookupKey(userId, agentId);
+        lookupCache.set(key, DEFAULT_ACCOUNT_ID);
+        accountIndex.set(DEFAULT_ACCOUNT_ID, { userId, agentId });
+    }
+    getWorkclawLogger().info(`[AccountManager] Built account map with ${lookupCache.size} entries, nextWorkspaceNum=${nextWorkspaceNum}`);
+}
+/**
+ * Resolve accountId by userId + agentId.
+ * First checks cache, then falls back to iteration.
+ */
+export function resolveAccountByUserIdAndAgentId(cfg, userId, agentId) {
+    const key = makeLookupKey(userId, agentId);
+    if (lookupCache.has(key)) {
+        return lookupCache.get(key);
+    }
+    const _WorkclawConfig = (cfg.channels?.['openclaw-workclaw'] || {});
+    const accounts = _WorkclawConfig?.accounts;
+    if (accounts && typeof accounts === 'object') {
+        for (const [accountId, accountCfg] of Object.entries(accounts)) {
+            if (!accountCfg)
+                continue;
+            const accountUserId = accountCfg.userId || _WorkclawConfig.userId;
+            if (String(accountUserId) === userId && String(accountCfg.agentId) === agentId) {
+                lookupCache.set(key, accountId);
+                accountIndex.set(accountId, { userId, agentId });
+                return accountId;
+            }
+        }
+    }
+    // 兼容默认账户直接写在顶层配置中的场景
+    if (String(_WorkclawConfig.userId ?? '') === userId
+        && String(_WorkclawConfig.agentId ?? '') === agentId) {
+        lookupCache.set(key, DEFAULT_ACCOUNT_ID);
+        accountIndex.set(DEFAULT_ACCOUNT_ID, { userId, agentId });
+        return DEFAULT_ACCOUNT_ID;
+    }
+    return null;
+}
+/**
+ * Allocate a new workspace-N accountId and register it in the map.
+ */
+export function allocateWorkerAccountId(_cfg, userId, agentId) {
+    const accountId = `workspace-${nextWorkspaceNum}`;
+    nextWorkspaceNum++;
+    const key = makeLookupKey(userId, agentId);
+    lookupCache.set(key, accountId);
+    accountIndex.set(accountId, { userId, agentId });
+    getWorkclawLogger().info(`[AccountManager] Allocated accountId=${accountId} for userId=${userId} agentId=${agentId}`);
+    return accountId;
+}
+/**
+ * Refresh the cache when an account's userId or agentId changes.
+ */
+export function refreshAccountCache(cfg) {
+    buildAccountMap(cfg);
+}
+// =============================================================================
+// Account config resolution (pure functions, no in-memory state)
+// =============================================================================
+/**
+ * List all configured account IDs from the accounts field.
+ */
+function listConfiguredAccountIds(cfg) {
+    const accounts = cfg.channels?.['openclaw-workclaw']?.accounts;
+    if (!accounts || typeof accounts !== 'object') {
+        return [];
+    }
+    return Object.keys(accounts).filter(Boolean);
+}
+/**
+ * Check if plugin-level workclaw config exists (appKey + appSecret)
+ */
+function hasPluginLevelWorkClawConfig(cfg) {
+    const workclawCfg = cfg.channels?.['openclaw-workclaw'];
+    const key = typeof workclawCfg?.appKey === 'string' ? workclawCfg.appKey.trim() : '';
+    const secret = typeof workclawCfg?.appSecret === 'string' ? workclawCfg.appSecret.trim() : '';
+    return Boolean(key && secret);
+}
+/**
+ * List all account IDs.
+ * If no accounts are configured but plugin has workclaw config, returns [DEFAULT_ACCOUNT_ID].
+ */
+export function listWorkclawAccountIds(cfg) {
+    const ids = listConfiguredAccountIds(cfg);
+    if (ids.length === 0) {
+        // 如果没有配置账户，但插件级别有 workclaw 配置，返回默认账户
+        if (hasPluginLevelWorkClawConfig(cfg)) {
+            return [DEFAULT_ACCOUNT_ID];
+        }
+        // Backward compatibility: no accounts configured, use default
+        return [DEFAULT_ACCOUNT_ID];
+    }
+    return [...ids].toSorted((a, b) => a.localeCompare(b));
+}
+/**
+ * Resolve the default account ID.
+ */
+export function resolveDefaultWorkclawAccountId(cfg) {
+    const ids = listWorkclawAccountIds(cfg);
+    if (ids.includes(DEFAULT_ACCOUNT_ID)) {
+        return DEFAULT_ACCOUNT_ID;
+    }
+    return ids[0] ?? DEFAULT_ACCOUNT_ID;
+}
+/**
+ * Get the raw account-specific config.
+ */
+function resolveAccountConfig(cfg, accountId) {
+    const accounts = cfg.channels?.['openclaw-workclaw']?.accounts;
+    if (!accounts || typeof accounts !== 'object') {
+        return undefined;
+    }
+    return accounts[accountId];
+}
+function hasWorkClawConfig(config) {
+    const key = typeof config.appKey === 'string' ? config.appKey.trim() : '';
+    const secret = typeof config.appSecret === 'string' ? config.appSecret.trim() : '';
+    // 只要有 appKey 和 appSecret 就认为配置了 workclaw（agentId 可以动态添加）
+    return Boolean(key && secret);
+}
+export function isWorkclawAccountConfigured(config) {
+    return hasWorkClawConfig(config);
+}
+/**
+ * Merge top-level config with account-specific config.
+ * Account-specific fields override top-level fields.
+ */
+function mergeWorkclawAccountConfig(cfg, accountId) {
+    const workclawCfg = cfg.channels?.['openclaw-workclaw'];
+    // Extract base config (exclude accounts field to avoid recursion)
+    const { accounts: _ignored, ...base } = workclawCfg ?? {};
+    // Get account-specific overrides
+    const account = resolveAccountConfig(cfg, accountId) ?? {};
+    // Merge: account config overrides base config
+    return { ...base, ...account };
+}
+/**
+ * Resolve a complete account with merged config.
+ */
+export function resolveWorkclawAccount(params) {
+    const accountId = normalizeAccountId(params.accountId);
+    const workclawCfg = params.cfg.channels?.['openclaw-workclaw'];
+    // Base enabled state (top-level)
+    const baseEnabled = workclawCfg?.enabled !== false;
+    // Merge configs
+    const merged = mergeWorkclawAccountConfig(params.cfg, accountId);
+    // Account-level enabled state
+    const accountEnabled = merged.enabled !== false;
+    const enabled = baseEnabled && accountEnabled;
+    return {
+        accountId,
+        enabled,
+        configured: isWorkclawAccountConfigured(merged),
+        name: merged.name?.trim() || undefined,
+        config: merged,
+    };
+}
+/**
+ * List all enabled and configured accounts.
+ */
+export function listEnabledWorkclawAccounts(cfg) {
+    return listConfiguredAccountIds(cfg)
+        .map(accountId => resolveWorkclawAccount({ cfg, accountId }))
+        .filter(account => account.enabled && account.configured);
+}
+/**
+ * Resolve account and apply cached connection config if available.
+ * This ensures that appKey/appSecret etc. use the stable values captured at connection time,
+ * not potentially mutated values from cfg at resolution time.
+ */
+export function resolveWorkclawAccountWithCache(params) {
+    const account = resolveWorkclawAccount(params);
+    const cachedConfig = getWorkclawConnectionConfig(account.accountId);
+    if (cachedConfig) {
+        // Apply cached values to ensure stability
+        account.config.appKey = cachedConfig.appKey || account.config.appKey;
+        account.config.appSecret = cachedConfig.appSecret || account.config.appSecret;
+        if (cachedConfig.baseUrl)
+            account.config.baseUrl = cachedConfig.baseUrl;
+        if (cachedConfig.websocketUrl !== undefined)
+            account.config.websocketUrl = cachedConfig.websocketUrl;
+        if (cachedConfig.localIp !== undefined)
+            account.config.localIp = cachedConfig.localIp;
+        if (cachedConfig.allowInsecureTls !== undefined)
+            account.config.allowInsecureTls = cachedConfig.allowInsecureTls;
+        if (cachedConfig.requestTimeout !== undefined)
+            account.config.requestTimeout = cachedConfig.requestTimeout;
+    }
+    return account;
+}
+/**
+ * Inspect and probe workclaw credentials.
+ * Returns a function that can be called to test the connection.
+ */
+export function inspectWorkclawCredentials(workclawCfg) {
+    const appKey = typeof workclawCfg?.appKey === 'string' ? workclawCfg.appKey.trim() : '';
+    const appSecret = typeof workclawCfg?.appSecret === 'string' ? workclawCfg.appSecret.trim() : '';
+    if (!appKey || !appSecret) {
+        return null;
+    }
+    return async () => {
+        try {
+            // 这里可以实现凭证验证逻辑
+            // 暂时返回成功,因为实际验证需要连接工作线程
+            return { ok: true };
+        }
+        catch {
+            return { ok: false };
+        }
+    };
+}

package/dist/src/api/accounts-api.d.ts

@@ -0,0 +1,2 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare function createAccountsApiHandler(api: OpenClawPluginApi): (req: any, res: any) => Promise<void>;