@workclaw/openclaw-workclaw 1.0.19 → 1.0.23

package/src/tools/openclaw-workclaw-cron/src/update/sync.ts

@@ -0,0 +1,161 @@
+/**
+ * 智小途定时任务工具 - 同步修改定时任务到后端
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+import { resolveWorkclawAccountWithCache } from '../../../../accounts.js'
+import { callCronJobUpdate } from '../../api/index.js'
+
+/**
+ * 同步修改定时任务参数
+ */
+export interface UpdateSyncParams {
+  jobId: string
+  name: string
+  kind: 'cron'
+  expr?: string
+  message: string
+}
+
+/**
+ * 参数 Schema 定义
+ */
+const UpdateSyncSchema = {
+  type: 'object',
+  properties: {
+    jobId: {
+      type: 'string',
+      description: `OpenClaw 任务 ID（必须是数字或字符串，不是 cron 表达式）`,
+    },
+    name: {
+      type: 'string',
+      description: '任务名称',
+    },
+    kind: {
+      type: 'string',
+      description: '任务类型（仅支持 cron）',
+      enum: ['cron'],
+    },
+    expr: {
+      type: 'string',
+      description: 'Cron 表达式（kind=cron 时必填）',
+    },
+    message: {
+      type: 'string',
+      description: '提醒消息',
+    },
+  },
+  required: ['jobId', 'name', 'kind', 'message'],
+} as const
+
+/**
+ * 构造工具返回结果
+ */
+function json(data: unknown): any {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }],
+    details: data,
+  }
+}
+
+/**
+ * 获取同步修改定时任务到后端工具
+ */
+function getOpenclawWorkclawCronUpdateSyncTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-cron-update-sync',
+      label: '智小途同步修改提醒',
+      description: '将修改定时任务同步到后端。在 cron 工具修改任务后调用此工具同步后端。',
+      parameters: UpdateSyncSchema,
+      execute: async (_toolCallId: string, params: UpdateSyncParams) => {
+        const p = params as UpdateSyncParams
+
+        api.logger.info(`[智小途-同步修改] 开始同步 jobId=${p.jobId} name=${p.name}`)
+
+        // 参数校验
+        if (!p.jobId) {
+          api.logger.warn('[智小途-同步修改] 缺少 jobId 参数')
+          return json({ error: 'jobId 为必填参数' })
+        }
+        if (!p.name) {
+          api.logger.warn('[智小途-同步修改] 缺少 name 参数')
+          return json({ error: 'name 为必填参数' })
+        }
+        if (!p.message) {
+          api.logger.warn('[智小途-同步修改] 缺少 message 参数')
+          return json({ error: 'message 为必填参数' })
+        }
+
+        // 从 ctx 获取必要参数
+        const accountId = ctx?.agentAccountId
+        const channelUserId = ctx?.From
+
+        // 校验必要参数
+        if (!accountId) {
+          api.logger.warn('[智小途-同步修改] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        const accountConfig = resolveWorkclawAccountWithCache({
+          cfg: ctx.config,
+          accountId,
+        })
+
+        const channelAgentId = accountConfig.configured ? String(accountConfig.config.agentId) : '0'
+
+        api.logger.info(`[智小途-同步修改] accountId=${accountId} channelUserId=${channelUserId} channelAgentId=${channelAgentId}`)
+
+        try {
+          const result = await callCronJobUpdate(api, accountId, {
+            jobId: p.jobId,
+            name: p.name,
+            kind: p.kind,
+            expr: p.expr,
+            message: p.message,
+            agentId: channelAgentId,
+          })
+
+          if (result.success) {
+            api.logger.info(`[智小途-同步修改] 后端同步成功 jobId=${p.jobId}`)
+            return json({
+              code: 0,
+              message: '定时任务已修改并同步到后端',
+              data: {
+                jobId: p.jobId,
+                name: p.name,
+                message: p.message,
+                backendSynced: true,
+              },
+            })
+          }
+          else {
+            api.logger.error(`[智小途-同步修改] 后端同步失败 ${result.error}`)
+            return json({
+              code: -1,
+              error: result.error || '后端同步失败',
+              data: { jobId: p.jobId, name: p.name },
+            })
+          }
+        }
+        catch (error: any) {
+          api.logger.error(`[智小途-同步修改] 后端同步异常 ${error.message}`)
+          return json({
+            code: -1,
+            error: error.message,
+            data: { jobId: p.jobId, name: p.name },
+          })
+        }
+      },
+    }
+  }
+}
+
+/**
+ * 注册同步修改定时任务到后端工具
+ */
+export function registerOpenclawWorkclawCronUpdateSyncTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawCronUpdateSyncTool(api), {
+    name: 'openclaw-workclaw-cron-update-sync',
+  })
+}

package/src/tools/openclaw-workclaw-cron/types/index.ts

@@ -0,0 +1,55 @@
+/**
+ * 智小途定时任务工具 - 类型定义
+ */
+
+/**
+ * 后端接口请求体
+ */
+export interface CronJobPayload {
+  agentId: string
+  messageId: string
+  clawJobId: string
+  name: string
+  kind: 'cron'
+  expr?: string
+  message: string
+}
+
+/**
+ * OpenClaw cron 工具参数
+ */
+export interface OpenClawCronParams {
+  action: 'add' | 'list' | 'remove' | 'update' | 'enable' | 'disable'
+  job?: {
+    agentId: string
+    name: string
+    schedule: {
+      kind: 'cron'
+      expr: string
+      tz: string
+    }
+    sessionTarget: 'isolated'
+    wakeMode: 'now'
+    deleteAfterRun?: boolean
+    payload: {
+      kind: 'agentTurn'
+      message: string
+    }
+    delivery: {
+      mode: 'announce'
+      channel: string
+      to: string
+    }
+  }
+  jobId?: string
+}
+
+/**
+ * 工具返回结果
+ */
+export interface CronToolResult {
+  success: boolean
+  jobId?: string
+  jobs?: any[]
+  error?: string
+}

package/src/tools/openclaw-workclaw-cron/utils/index.ts

@@ -0,0 +1,141 @@
+/**
+ * 智小途定时任务工具 - 工具函数
+ */
+
+/**
+ * 解析相对时间字符串
+ * 支持格式：5m, 1h, 1h30m, 2d, 30s, 1d2h30m 等
+ * @param timeStr - 时间字符串
+ * @returns 毫秒数，解析失败返回 null
+ */
+export function parseRelativeTime(timeStr: string): number | null {
+  const s = timeStr.trim().toLowerCase()
+
+  if (/^\d+$/.test(s)) {
+    return Number.parseInt(s, 10) * 60_000
+  }
+
+  let totalMs = 0
+  let matched = false
+  const regex = /(\d+(?:\.\d+)?)\s*([dhms])/g
+
+  let match: RegExpExecArray | null
+  // eslint-disable-next-line no-cond-assign
+  while ((match = regex.exec(s)) !== null) {
+    matched = true
+    const value = Number.parseFloat(match[1])
+    const unit = match[2]
+    switch (unit) {
+      case 'd': totalMs += value * 86_400_000
+        break
+      case 'h': totalMs += value * 3_600_000
+        break
+      case 'm': totalMs += value * 60_000
+        break
+      case 's': totalMs += value * 1_000
+        break
+    }
+  }
+
+  return matched ? Math.round(totalMs) : null
+}
+
+/**
+ * 判断是否为 cron 表达式
+ * @param timeStr - 时间字符串
+ * @returns 是否为 cron 表达式
+ */
+export function isCronExpression(timeStr: string): boolean {
+  const parts = timeStr.trim().split(/\s+/)
+  return parts.length >= 3 && parts.length <= 6
+}
+
+/**
+ * 校验 cron 表达式格式
+ * @param timeStr - 时间字符串
+ * @returns 校验结果和错误信息
+ */
+export function validateCronExpression(timeStr: string): { valid: boolean, error?: string } {
+  const parts = timeStr.trim().split(/\s+/)
+
+  if (parts.length < 3 || parts.length > 6) {
+    return { valid: false, error: `无效的 cron 表达式：字段数量不正确（期望 3-6 个字段，实际 ${parts.length} 个）` }
+  }
+
+  const patterns = [
+    /^(\*|[0-5]?\d(-[0-5]?\d)?(\/[0-5]?\d)?|L(-[0-5]?\d)?|W?)$/,
+    /^(\*|[0-5]?\d(-[0-5]?\d)?(\/[0-5]?\d)?|L(-[0-5]?\d)?|W?)$/,
+    /^(\*|[01]?\d|2[0-3](-[01]?\d|2[0-3])?(\/\d|[01]?\d|2[0-3])?|L(-[01]?\d|2[0-3])?|W)?$/,
+    /^(\*|1[0-2]|0?[1-9](-[1-9]|0?[1-9])?(\/[1-9]|0?[1-9])?|L(-1[0-2]|0?[1-9])?|W)?$/,
+    /^([*LW]|[0-6](-[0-6])?(\/[0-6])?|L-[0-6])?$/,
+    /^(\*|L|(\*\/)?\d{1,2})?$/,
+  ]
+
+  const fieldNames = ['秒', '分钟', '小时', '日期', '月份', '星期']
+
+  for (let i = 0; i < parts.length && i < patterns.length; i++) {
+    const part = parts[i].trim()
+    const offset = parts.length - patterns.length
+
+    if (i < offset)
+      continue
+
+    if (!patterns[i].test(part)) {
+      return { valid: false, error: `无效的 cron 表达式：${fieldNames[i]}字段 "${part}" 格式不正确` }
+    }
+  }
+
+  return { valid: true }
+}
+
+/**
+ * 校验时间格式（相对时间或 cron 表达式）
+ * @param timeStr - 时间字符串
+ * @returns 校验结果和错误信息
+ */
+export function validateTimeFormat(timeStr: string): { valid: boolean, error?: string } {
+  if (!timeStr || typeof timeStr !== 'string' || timeStr.trim() === '') {
+    return { valid: false, error: '时间参数不能为空' }
+  }
+
+  const trimmed = timeStr.trim()
+
+  if (trimmed.startsWith('+') || /^\d+$/.test(trimmed) || /^\d+[dhms]/.test(trimmed)) {
+    const relativeMs = parseRelativeTime(trimmed)
+    if (relativeMs === null) {
+      return { valid: false, error: `无法解析相对时间 "${trimmed}"，支持的格式：5m、1h、1h30m、2d、30s 等` }
+    }
+    if (relativeMs < 30_000) {
+      return { valid: false, error: '提醒时间不能少于 30 秒' }
+    }
+    return { valid: true }
+  }
+
+  if (isCronExpression(trimmed)) {
+    return validateCronExpression(trimmed)
+  }
+
+  return { valid: false, error: `无法解析时间 "${trimmed}"，请使用相对时间（如 5m、1h）或 cron 表达式（如 0 8 * * *）` }
+}
+
+/**
+ * 将相对时间转换为标准 cron 表达式
+ * @param timeStr - 相对时间字符串，如 "5m", "1h", "2h30m"
+ * @returns 标准 cron 表达式（秒 分 时 日 月 星期），格式为 "SS MM HH DD MM *"
+ */
+export function relativeToCron(timeStr: string): string {
+  const delayMs = parseRelativeTime(timeStr)
+  if (delayMs === null) {
+    return timeStr
+  }
+
+  const futureTime = new Date(Date.now() + delayMs)
+
+  const seconds = futureTime.getSeconds()
+  const minutes = futureTime.getMinutes()
+  const hours = futureTime.getHours()
+  const dayOfMonth = futureTime.getDate()
+  const month = futureTime.getMonth() + 1
+
+  return `${seconds} ${minutes} ${hours} ${dayOfMonth} ${month} *`
+}

package/src/tools/openclaw-workclaw-system/index.ts

@@ -0,0 +1,17 @@
+/**
+ * 智小途系统信息工具 - 统一出口
+ *
+ * 提供统一的工具注册入口，一次性注册所有系统信息相关工具
+ */
+
+import { registerOpenclawWorkclawSystemConfigTool } from './src/get/index.js'
+import { registerOpenclawWorkclawSystemTokenTool } from './src/token/index.js'
+
+/**
+ * 统一注册所有系统信息工具
+ * @param api - OpenClaw API 实例
+ */
+export function registerAllOpenclawWorkclawSystemTools(api: any): void {
+  registerOpenclawWorkclawSystemConfigTool(api)
+  registerOpenclawWorkclawSystemTokenTool(api)
+}

package/src/tools/openclaw-workclaw-system/src/get/index.ts

@@ -0,0 +1,77 @@
+/**
+ * 智小途系统信息工具 - 获取系统配置信息
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+import { resolveWorkclawAccountWithCache } from '../../../../accounts.js'
+
+/**
+ * 构造工具返回结果
+ */
+function json(data: unknown): any {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }],
+    details: data,
+  }
+}
+
+/**
+ * 获取系统配置信息工具
+ */
+function getOpenclawWorkclawSystemConfigTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-system-config',
+      label: '智小途获取系统信息',
+      description: '获取当前渠道的系统配置信息，包括 appKey、appSecret、agentId、userId 等',
+      execute: async () => {
+        api.logger.info('[智小途-系统信息] 开始获取系统配置信息')
+
+        const accountId = ctx?.agentAccountId
+        if (!accountId) {
+          api.logger.warn('[智小途-系统信息] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        api.logger.info(`[智小途-系统信息] accountId=${accountId}`)
+
+        const accountConfig = resolveWorkclawAccountWithCache({
+          cfg: ctx.config,
+          accountId,
+        })
+
+        if (!accountConfig.configured) {
+          api.logger.error('[智小途-系统信息] 账户未配置')
+          return json({ error: '账户未配置，请检查账户配置' })
+        }
+
+        const accConfig = accountConfig.config
+
+        const result = {
+          accountId,
+          appKey: accConfig.appKey,
+          appSecret: accConfig.appSecret,
+          agentId: accConfig.agentId,
+          userId: accConfig.userId,
+        }
+
+        api.logger.info(`[智小途-系统信息] 获取成功${JSON.stringify(result)}`)
+
+        return json({
+          code: 0,
+          message: '系统信息获取成功',
+          data: result,
+        })
+      },
+    }
+  }
+}
+
+/**
+ * 注册获取系统配置信息工具
+ */
+export function registerOpenclawWorkclawSystemConfigTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawSystemConfigTool(api), {
+    name: 'openclaw-workclaw-system-config',
+  })
+}

package/src/tools/openclaw-workclaw-system/src/token/index.ts

@@ -0,0 +1,93 @@
+/**
+ * 智小途系统信息工具 - 获取用户 AccessToken
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+import { resolveWorkclawAccountWithCache } from '../../../../accounts.js'
+import { getWorkclawAccessToken } from '../../../../connection/workclaw-client.js'
+
+/**
+ * 构造工具返回结果
+ */
+function json(data: unknown): any {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }],
+    details: data,
+  }
+}
+
+/**
+ * 获取用户 AccessToken 工具
+ */
+function getOpenclawWorkclawSystemTokenTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-system-token',
+      label: '智小途获取 AccessToken',
+      description: '获取用户的 AccessToken',
+      execute: async () => {
+        api.logger.info('[智小途-系统信息] 开始获取 AccessToken')
+
+        const accountId = ctx?.agentAccountId
+        if (!accountId) {
+          api.logger.warn('[智小途-系统信息] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        api.logger.info(`[智小途-系统信息] accountId=${accountId}`)
+
+        const accountConfig = resolveWorkclawAccountWithCache({
+          cfg: ctx.config,
+          accountId,
+        })
+
+        if (!accountConfig.configured) {
+          api.logger.error('[智小途-系统信息] 账户未配置')
+          return json({ error: '账户未配置，请检查账户配置' })
+        }
+
+        const accConfig = accountConfig.config
+
+        try {
+          const tokenCacheKey = accConfig.appKey || accountId
+
+          api.logger.info(`[智小途-系统信息] 正在获取 AccessToken，accountId=${accountId}`)
+
+          const accessToken = await getWorkclawAccessToken(tokenCacheKey, {
+            baseUrl: accConfig.baseUrl,
+            appKey: accConfig.appKey,
+            appSecret: accConfig.appSecret,
+            allowInsecureTls: accConfig.allowInsecureTls,
+            requestTimeout: accConfig.requestTimeout,
+          })
+
+          api.logger.info('[智小途-系统信息] AccessToken 获取成功')
+
+          return json({
+            code: 0,
+            message: 'AccessToken 获取成功',
+            data: {
+              accessToken,
+            },
+          })
+        }
+        catch (error: any) {
+          api.logger.error(`[智小途-系统信息] AccessToken 获取失败 ${error.message}`)
+          return json({
+            code: -1,
+            error: error.message || 'AccessToken 获取失败',
+          })
+        }
+      },
+    }
+  }
+}
+
+/**
+ * 注册获取用户 AccessToken 工具
+ */
+export function registerOpenclawWorkclawSystemTokenTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawSystemTokenTool(api), {
+    name: 'openclaw-workclaw-system-token',
+  })
+}

package/src/types.ts

@@ -0,0 +1,50 @@
+import type {
+  workclawAccountConfigSchema,
+  workclawConfigSchema,
+  z,
+} from './config-schema.js'
+
+export type WorkclawConfig = z.infer<typeof workclawConfigSchema>
+export type WorkclawAccountConfig = z.infer<typeof workclawAccountConfigSchema>
+
+export interface ResolvedWorkclawAccount {
+  accountId: string
+  enabled: boolean
+  configured: boolean
+  name?: string
+  config: WorkclawFullAccountConfig
+}
+export type ResolvedOpenClawWorkclawAccount = ResolvedWorkclawAccount
+
+export type WorkclawIdType = 'open_id' | 'user_id' | 'union_id' | 'chat_id'
+
+export interface WorkclawSendResult {
+  messageId: string
+  chatId: string
+}
+
+export interface WorkClawBaseConfig {
+  baseUrl?: string
+  websocketUrl?: string
+  appKey?: string
+  appSecret?: string
+  localIp?: string
+  allowInsecureTls?: boolean
+  requestTimeout?: number
+  userId?: string | number
+  replyEndpoint?: string
+  pushEndpoint?: string
+  [key: string]: any
+}
+
+export interface WorkClawAccountConfig {
+  agentId?: string | number
+  userId?: string | number
+  openConversationId?: string
+  [key: string]: any
+}
+
+export type WorkClawConfig = WorkClawBaseConfig & WorkClawAccountConfig
+
+export type WorkclawFullAccountConfig = WorkclawConfig & Partial<WorkclawAccountConfig>
+export type ResolvedWorkclawAccountConfig = WorkclawFullAccountConfig

package/src/utils/content.ts

@@ -0,0 +1,40 @@
+/**
+ * Content extraction utilities - copied from SDK's internal implementations
+ * node_modules/openclaw/dist/plugin-sdk/thread-bindings-SYAnWHuW.js (collectTextContentBlocks)
+ * node_modules/openclaw/dist/auth-profiles-DRjqKE3G.js (extractToolResultText)
+ */
+
+/**
+ * Extract text blocks from chat content array.
+ * Handles content format: [{ type: "text", text: "..." }]
+ */
+export function collectTextContentBlocks(content: unknown): string[] {
+  if (!Array.isArray(content))
+    return []
+  const parts: string[] = []
+  for (const block of content) {
+    if (!block || typeof block !== 'object')
+      continue
+    const rec = block as { type?: string, text?: string }
+    if (rec.type === 'text' && typeof rec.text === 'string')
+      parts.push(rec.text)
+  }
+  return parts
+}
+
+/**
+ * Extract plain text from a tool result object.
+ * Handles result.content as array of text blocks or direct text fields.
+ */
+export function extractToolResultText(result: unknown): string | undefined {
+  if (!result || typeof result !== 'object')
+    return
+  const record = result as { content?: unknown }
+  const texts = collectTextContentBlocks(record.content).map((item) => {
+    const trimmed = item.trim()
+    return trimmed || void 0
+  }).filter(value => Boolean(value))
+  if (texts.length === 0)
+    return
+  return texts.join('\n')
+}

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": [
+      "ES2022",
+      "ESNext"
+    ],
+    "moduleDetection": "force",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "types": [
+      "node"
+    ],
+    "allowImportingTsExtensions": false,
+    "allowJs": true,
+    "strict": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "rootDir": ".",
+    "declaration": true,
+    "outDir": "dist",
+  },
+  "include": ["./**/*.ts", "./index.ts"],
+  "exclude": ["node_modules", "dist"]
+}
+