@workclaw/openclaw-workclaw 1.0.0

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

@@ -0,0 +1,188 @@
+/**
+ * 智小途定时任务工具 - 同步创建定时任务到后端
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+import { resolveOpenclawWorkclawAccount } from '../../../../accounts.js'
+import { callCronJobAdd } from '../../api/index.js'
+
+/**
+ * 同步创建定时任务参数
+ */
+export interface AddSyncParams {
+  jobId: string
+  name: string
+  kind: 'cron'
+  expr?: string
+  message: string
+}
+
+/**
+ * 参数 Schema 定义
+ */
+const AddSyncSchema = {
+  type: 'object',
+  properties: {
+    jobId: {
+      type: 'string',
+      description: `⛔ 重要：jobId 必须从 OpenClaw cron 工具返回值中提取，格式：{"success": true, "jobId": "123456"}
+
+常见错误：
+- 把 cron 表达式（如 "31 12 11 31 3 *"）当作 jobId
+- 把 name 当作 jobId
+- 编造 jobId
+
+正确做法：
+1. 调用 openclaw-workclaw-cron-add-params
+2. 用返回的 cronParams 调用 cron 工具
+3. 从返回值提取 jobId（如 "7382945612345"）
+4. 用提取到的 jobId 调用此工具`,
+    },
+    name: {
+      type: 'string',
+      description: '任务名称，与 add-params 中传入的 name 一致',
+    },
+    kind: {
+      type: 'string',
+      description: '任务类型',
+      enum: ['cron'],
+    },
+    expr: {
+      type: 'string',
+      description: 'Cron 表达式',
+    },
+    message: {
+      type: 'string',
+      description: '提醒消息，与 add-params 中传入的 message 一致',
+    },
+  },
+  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 getOpenclawWorkclawCronAddSyncTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-cron-add-sync',
+      label: '智小途同步创建提醒',
+      description: `【后端同步步骤】将创建定时任务同步到后端。必须在上一步 openclaw-workclaw-cron-add-params 执行后调用此工具完成同步。
+
+⚠️ jobId 必须是 cron 工具返回值 {"success": true, "jobId": "xxx"} 中的 jobId 字段！`,
+      parameters: AddSyncSchema,
+      execute: async (_toolCallId: string, params: AddSyncParams) => {
+        const p = params as AddSyncParams
+
+        api.logger.info(`[智小途-同步创建] 开始同步 jobId=${p.jobId} name=${p.name}`)
+
+        // 参数校验
+        if (!p.jobId) {
+          api.logger.warn('[智小途-同步创建] 缺少 jobId 参数')
+          return json({ error: 'jobId 为必填参数' })
+        }
+
+        // 检查 jobId 是否被错误地设置为 cron 表达式
+        const jobIdTrimmed = p.jobId.trim()
+        const parts = jobIdTrimmed.split(/\s+/)
+        const isCronExpression = parts.length >= 5 && parts.length <= 6 && jobIdTrimmed.includes('*')
+
+        if (isCronExpression) {
+          api.logger.error(`[智小途-同步创建] jobId 格式错误！jobId=${p.jobId}，看起来像 cron 表达式`)
+          return json({
+            error: `jobId="${p.jobId}" 是 cron 表达式，不是任务 ID！jobId 应来自 cron 工具返回值，如 "123456" 或 "abc123"`,
+          })
+        }
+
+        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
+        if (!accountId) {
+          api.logger.warn('[智小途-同步创建] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        const accountConfig = resolveOpenclawWorkclawAccount({
+          cfg: ctx.config,
+          accountId,
+        })
+
+        if (accountConfig.configured) {
+          try {
+            const channelAgentId = String(accountConfig.config.agentId)
+            api.logger.info(`[智小途-同步创建] accountId=${accountId} channelAgentId=${channelAgentId}`)
+            const result = await callCronJobAdd(api, accountId, {
+              jobId: p.jobId,
+              name: p.name,
+              kind: p.kind,
+              expr: p.expr,
+              message: p.message,
+              messageId: 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 },
+            })
+          }
+        }
+        else {
+          api.logger.error(`[智小途-同步创建] 无法获取渠道配置，accountId=${accountId}`)
+          return json({ error: '无法获取渠道配置，请检查账户配置' })
+        }
+      },
+    }
+  }
+}
+
+/**
+ * 注册同步创建定时任务到后端工具
+ */
+export function registerOpenclawWorkclawCronAddSyncTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawCronAddSyncTool(api), {
+    name: 'openclaw-workclaw-cron-add-sync',
+  })
+}

package/src/tools/openclaw-workclaw-cron/src/disable/params.ts

@@ -0,0 +1,100 @@
+/**
+ * 智小途定时任务工具 - 生成禁用定时任务参数
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+
+/**
+ * 生成禁用定时任务参数
+ */
+export interface DisableParamsParams {
+  jobId: string
+}
+
+/**
+ * 参数 Schema 定义
+ */
+const DisableParamsSchema = {
+  type: 'object',
+  properties: {
+    jobId: {
+      type: 'string',
+      description: 'OpenClaw 任务 ID',
+    },
+  },
+  required: ['jobId'],
+} as const
+
+/**
+ * 构造工具返回结果
+ */
+function json(data: unknown): any {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }],
+    details: data,
+  }
+}
+
+/**
+ * 获取生成禁用定时任务参数工具
+ */
+function getOpenclawWorkclawCronDisableParamsTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-cron-disable-params',
+      label: '智小途生成禁用提醒参数',
+      description: `生成禁用提醒的 CLI 命令参数。
+
+📋 工作流程：
+1. 调用此工具获取 CLI 命令参数
+2. 使用返回的 cronParams 调用 OpenClaw 的 cron 工具
+3. 调用 openclaw-workclaw-cron-disable-sync 同步到后端`,
+      parameters: DisableParamsSchema,
+      execute: async (_toolCallId: string, params: DisableParamsParams) => {
+        const p = params as DisableParamsParams
+
+        api.logger.info(`[智小途-生成禁用参数] 开始处理 jobId=${p.jobId}`)
+
+        // 参数校验
+        if (!p.jobId) {
+          api.logger.warn('[智小途-生成禁用参数] 缺少 jobId 参数')
+          return json({ error: 'jobId 为必填参数' })
+        }
+
+        // 从 ctx 获取必要参数
+        const accountId = ctx?.agentAccountId
+        if (!accountId) {
+          api.logger.warn('[智小途-生成禁用参数] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        api.logger.info(`[智小途-生成禁用参数] accountId=${accountId} jobId=${p.jobId}`)
+
+        const cronParams = {
+          action: 'disable' as const,
+          jobId: p.jobId,
+        }
+
+        api.logger.info(`[智小途-生成禁用参数] 构建 cron 参数 cronParams=${JSON.stringify(cronParams)}`)
+
+        return json({
+          cronParams,
+          meta: {
+            accountId,
+            jobId: p.jobId,
+          },
+          summary: `⏸️ 提醒已禁用: jobId=${p.jobId}`,
+        })
+      },
+    }
+  }
+}
+
+/**
+ * 注册生成禁用定时任务参数工具
+ */
+export function registerOpenclawWorkclawCronDisableParamsTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawCronDisableParamsTool(api), {
+    name: 'openclaw-workclaw-cron-disable-params',
+  })
+}

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

@@ -0,0 +1,127 @@
+/**
+ * 智小途定时任务工具 - 同步禁用定时任务到后端
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+import { resolveOpenclawWorkclawAccount } from '../../../../accounts.js'
+import { callCronJobDisabled } from '../../api/index.js'
+
+/**
+ * 同步禁用定时任务参数
+ */
+export interface DisableSyncParams {
+  jobId: string
+}
+
+/**
+ * 参数 Schema 定义
+ */
+const DisableSyncSchema = {
+  type: 'object',
+  properties: {
+    jobId: {
+      type: 'string',
+      description: 'OpenClaw 任务 ID',
+    },
+  },
+  required: ['jobId'],
+} as const
+
+/**
+ * 构造工具返回结果
+ */
+function json(data: unknown): any {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }],
+    details: data,
+  }
+}
+
+/**
+ * 获取同步禁用定时任务到后端工具
+ */
+function getOpenclawWorkclawCronDisableSyncTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-cron-disable-sync',
+      label: '智小途同步禁用提醒',
+      description: '将禁用定时任务同步到后端。在 cron 工具禁用任务后调用此工具同步后端。',
+      parameters: DisableSyncSchema,
+      execute: async (_toolCallId: string, params: DisableSyncParams) => {
+        const p = params as DisableSyncParams
+
+        api.logger.info(`[智小途-同步禁用] 开始同步 jobId=${p.jobId}`)
+
+        // 参数校验
+        if (!p.jobId) {
+          api.logger.warn('[智小途-同步禁用] 缺少 jobId 参数')
+          return json({ error: 'jobId 为必填参数' })
+        }
+
+        // 从 ctx 获取必要参数
+        const accountId = ctx?.agentAccountId
+        if (!accountId) {
+          api.logger.warn('[智小途-同步禁用] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        const accountConfig = resolveOpenclawWorkclawAccount({
+          cfg: ctx.config,
+          accountId,
+        })
+
+        if (accountConfig.configured) {
+          try {
+            const channelAgentId = String(accountConfig.config.agentId)
+            api.logger.info(`[智小途-同步禁用] accountId=${accountId} channelAgentId=${channelAgentId}`)
+
+            const result = await callCronJobDisabled(api, accountId, {
+              jobId: p.jobId,
+            })
+
+            if (result.success) {
+              api.logger.info(`[智小途-同步禁用] 后端同步成功 jobId=${p.jobId}`)
+              return json({
+                code: 0,
+                message: '定时任务已禁用并同步到后端',
+                data: {
+                  jobId: p.jobId,
+                  backendSynced: true,
+                },
+              })
+            }
+            else {
+              api.logger.error(`[智小途-同步禁用] 后端同步失败 ${result.error}`)
+              return json({
+                code: -1,
+                error: result.error || '后端同步失败',
+                data: { jobId: p.jobId },
+              })
+            }
+          }
+          catch (error: any) {
+            api.logger.error(`[智小途-同步禁用] 后端同步异常 ${error.message}`)
+            return json({
+              code: -1,
+              error: error.message,
+              data: { jobId: p.jobId },
+            })
+          }
+        }
+        else {
+          api.logger.error(`[智小途-同步禁用] 无法获取渠道配置，accountId=${accountId}`)
+          return json({ error: '无法获取渠道配置，请检查账户配置' })
+        }
+      },
+    }
+  }
+}
+
+/**
+ * 注册同步禁用定时任务到后端工具
+ */
+export function registerOpenclawWorkclawCronDisableSyncTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawCronDisableSyncTool(api), {
+    name: 'openclaw-workclaw-cron-disable-sync',
+  })
+}

package/src/tools/openclaw-workclaw-cron/src/enable/params.ts

@@ -0,0 +1,100 @@
+/**
+ * 智小途定时任务工具 - 生成启用定时任务参数
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+
+/**
+ * 生成启用定时任务参数
+ */
+export interface EnableParamsParams {
+  jobId: string
+}
+
+/**
+ * 参数 Schema 定义
+ */
+const EnableParamsSchema = {
+  type: 'object',
+  properties: {
+    jobId: {
+      type: 'string',
+      description: 'OpenClaw 任务 ID',
+    },
+  },
+  required: ['jobId'],
+} as const
+
+/**
+ * 构造工具返回结果
+ */
+function json(data: unknown): any {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }],
+    details: data,
+  }
+}
+
+/**
+ * 获取生成启用定时任务参数工具
+ */
+function getOpenclawWorkclawCronEnableParamsTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-cron-enable-params',
+      label: '智小途生成启用提醒参数',
+      description: `生成启用提醒的 CLI 命令参数。
+
+📋 工作流程：
+1. 调用此工具获取 CLI 命令参数
+2. 使用返回的 cronParams 调用 OpenClaw 的 cron 工具
+3. 调用 openclaw-workclaw-cron-enable-sync 同步到后端`,
+      parameters: EnableParamsSchema,
+      execute: async (_toolCallId: string, params: EnableParamsParams) => {
+        const p = params as EnableParamsParams
+
+        api.logger.info(`[智小途-生成启用参数] 开始处理 jobId=${p.jobId}`)
+
+        // 参数校验
+        if (!p.jobId) {
+          api.logger.warn('[智小途-生成启用参数] 缺少 jobId 参数')
+          return json({ error: 'jobId 为必填参数' })
+        }
+
+        // 从 ctx 获取必要参数
+        const accountId = ctx?.agentAccountId
+        if (!accountId) {
+          api.logger.warn('[智小途-生成启用参数] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        api.logger.info(`[智小途-生成启用参数] accountId=${accountId} jobId=${p.jobId}`)
+
+        const cronParams = {
+          action: 'enable' as const,
+          jobId: p.jobId,
+        }
+
+        api.logger.info(`[智小途-生成启用参数] 构建 cron 参数 cronParams=${JSON.stringify(cronParams)}`)
+
+        return json({
+          cronParams,
+          meta: {
+            accountId,
+            jobId: p.jobId,
+          },
+          summary: `✅ 提醒已启用: jobId=${p.jobId}`,
+        })
+      },
+    }
+  }
+}
+
+/**
+ * 注册生成启用定时任务参数工具
+ */
+export function registerOpenclawWorkclawCronEnableParamsTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawCronEnableParamsTool(api), {
+    name: 'openclaw-workclaw-cron-enable-params',
+  })
+}

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

@@ -0,0 +1,127 @@
+/**
+ * 智小途定时任务工具 - 同步启用定时任务到后端
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+import { resolveOpenclawWorkclawAccount } from '../../../../accounts.js'
+import { callCronJobEnabled } from '../../api/index.js'
+
+/**
+ * 同步启用定时任务参数
+ */
+export interface EnableSyncParams {
+  jobId: string
+}
+
+/**
+ * 参数 Schema 定义
+ */
+const EnableSyncSchema = {
+  type: 'object',
+  properties: {
+    jobId: {
+      type: 'string',
+      description: 'OpenClaw 任务 ID',
+    },
+  },
+  required: ['jobId'],
+} as const
+
+/**
+ * 构造工具返回结果
+ */
+function json(data: unknown): any {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }],
+    details: data,
+  }
+}
+
+/**
+ * 获取同步启用定时任务到后端工具
+ */
+function getOpenclawWorkclawCronEnableSyncTool(api: OpenClawPluginApi) {
+  return (ctx: any) => {
+    return {
+      name: 'openclaw-workclaw-cron-enable-sync',
+      label: '智小途同步启用提醒',
+      description: '将启用定时任务同步到后端。在 cron 工具启用任务后调用此工具同步后端。',
+      parameters: EnableSyncSchema,
+      execute: async (_toolCallId: string, params: EnableSyncParams) => {
+        const p = params as EnableSyncParams
+
+        api.logger.info(`[智小途-同步启用] 开始同步 jobId=${p.jobId}`)
+
+        // 参数校验
+        if (!p.jobId) {
+          api.logger.warn('[智小途-同步启用] 缺少 jobId 参数')
+          return json({ error: 'jobId 为必填参数' })
+        }
+
+        // 从 ctx 获取必要参数
+        const accountId = ctx?.agentAccountId
+        if (!accountId) {
+          api.logger.warn('[智小途-同步启用] 无法获取账户 ID')
+          return json({ error: '无法获取账户 ID（accountId），请确保已配置账户' })
+        }
+
+        const accountConfig = resolveOpenclawWorkclawAccount({
+          cfg: ctx.config,
+          accountId,
+        })
+
+        if (accountConfig.configured) {
+          try {
+            const channelAgentId = String(accountConfig.config.agentId)
+            api.logger.info(`[智小途-同步启用] accountId=${accountId} channelAgentId=${channelAgentId}`)
+
+            const result = await callCronJobEnabled(api, accountId, {
+              jobId: p.jobId,
+            })
+
+            if (result.success) {
+              api.logger.info(`[智小途-同步启用] 后端同步成功 jobId=${p.jobId}`)
+              return json({
+                code: 0,
+                message: '定时任务已启用并同步到后端',
+                data: {
+                  jobId: p.jobId,
+                  backendSynced: true,
+                },
+              })
+            }
+            else {
+              api.logger.error(`[智小途-同步启用] 后端同步失败 ${result.error}`)
+              return json({
+                code: -1,
+                error: result.error || '后端同步失败',
+                data: { jobId: p.jobId },
+              })
+            }
+          }
+          catch (error: any) {
+            api.logger.error(`[智小途-同步启用] 后端同步异常 ${error.message}`)
+            return json({
+              code: -1,
+              error: error.message,
+              data: { jobId: p.jobId },
+            })
+          }
+        }
+        else {
+          api.logger.error(`[智小途-同步启用] 无法获取渠道配置，accountId=${accountId}`)
+          return json({ error: '无法获取渠道配置，请检查账户配置' })
+        }
+      },
+    }
+  }
+}
+
+/**
+ * 注册同步启用定时任务到后端工具
+ */
+export function registerOpenclawWorkclawCronEnableSyncTool(api: OpenClawPluginApi): void {
+  (api.registerTool as any)(getOpenclawWorkclawCronEnableSyncTool(api), {
+    name: 'openclaw-workclaw-cron-enable-sync',
+  })
+}