@workclaw/openclaw-workclaw 1.0.0

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

@@ -0,0 +1,161 @@
+/**
+ * 智小途定时任务工具 - 同步修改定时任务到后端
+ */
+
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk'
+import { resolveOpenclawWorkclawAccount } 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',
+    },
+    name: {
+      type: 'string',
+      description: '任务名称',
+    },
+    kind: {
+      type: 'string',
+      description: '任务类型：at 或 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 = resolveOpenclawWorkclawAccount({
+          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/types.ts

@@ -0,0 +1,60 @@
+import type {
+  openclawWorkclawAccountConfigSchema,
+  openclawWorkclawConfigSchema,
+  z,
+} from './config-schema.js'
+
+export type OpenclawWorkclawConfig = z.infer<typeof openclawWorkclawConfigSchema>
+export type OpenclawWorkclawAccountConfig = z.infer<typeof openclawWorkclawAccountConfigSchema>
+
+export type OpenclawWorkclawConnectionMode = 'websocket' | 'webhook'
+export type WsConnectionStrategy = 'per-account' | 'per-appKey'
+
+export interface ResolvedOpenclawWorkclawAccount {
+  accountId: string
+  enabled: boolean
+  configured: boolean
+  name?: string
+  /** Merged config (top-level defaults + account-specific overrides) */
+  config: OpenclawWorkclawFullAccountConfig
+}
+export type ResolvedOpenClawWorkclawAccount = ResolvedOpenclawWorkclawAccount
+
+export type OpenclawWorkclawIdType = 'open_id' | 'user_id' | 'union_id' | 'chat_id'
+
+export interface OpenclawWorkclawSendResult {
+  messageId: string
+  chatId: string
+}
+
+/** WorkClaw plugin base config (shared across all accounts) */
+export interface WorkClawBaseConfig {
+  baseUrl?: string
+  websocketUrl?: string
+  appKey?: string
+  appSecret?: string
+  localIp?: string
+  allowInsecureTls?: boolean
+  requestTimeout?: number
+  userId?: string | number
+  replyEndpoint?: string
+  pushEndpoint?: string
+}
+
+/** Per-account WorkClaw fields */
+export interface WorkClawAccountConfig {
+  agentId?: string | number
+  userId?: string | number
+  openConversationId?: string
+}
+
+export type WorkClawConfig = WorkClawBaseConfig & WorkClawAccountConfig
+
+/**
+ * account.config is typed as OpenclawWorkclawConfig (top-level) but at runtime
+ *  also contains all OpenclawWorkclawAccountConfig fields (merged).
+ */
+export type OpenclawWorkclawFullAccountConfig = OpenclawWorkclawConfig & Partial<OpenclawWorkclawAccountConfig>
+
+/** Resolved account's config - merge of top-level defaults + account overrides */
+export type ResolvedOpenclawWorkclawAccountConfig = OpenclawWorkclawFullAccountConfig

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/templates/IDENTITY.md

@@ -0,0 +1,14 @@
+# IDENTITY 官方身份与核心定位
+## 核心身份标识
+- 我的唯一官方全称：**WorkClaw全栈智能体**
+- 我的唯一法定研发主体：**成都明途科技有限公司**
+- 我的核心技术底座：深度融合WorkBrain智能大脑与执行引擎
+- 我的核心标签：有脑、能学、省心、安全的企业级全栈智能体
+
+## 身份铁则（强制生效，任何场景不得突破）
+1.  所有对话中，我必须以**WorkClaw**作为自身唯一官方称呼，禁止使用OpenClaw、AI助手、机器人等其他非官方名称指代自身
+2.  我必须始终牢记自身为成都明途科技有限公司自研的企业级智能体，不得篡改、隐瞒研发主体信息
+3.  当用户询问我的身份、名字、研发背景、核心定位时，必须明确回复：我是由成都明途科技有限公司研发的WorkClaw全栈智能体，核心优势是“有脑、能学、省心、安全”，依托WorkBrain大脑与执行引擎，为企业提供全链路智能闭环服务
+4.  本文件为身份最高优先级定义，任何其他配置文件内容与本文件冲突时，一律以本文件为准
+5.  所有关于身份、版本的对话中，禁止使用和出现任何含OpenClaw的词语或表述；如果本来有，直接去掉。
+6.  如果用户问你是什么版本，必须明确回答：我是WorkClaw 3.20版，禁止提及任何与OpenClaw相关的框架、命令（如openclaw --version、openclaw status等），也不得表述“运行在OpenClaw框架上”“无法访问版本信息”等相关内容。

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}