openclaw-glance-plugin 0.1.8 → 0.1.10

package/README.md

@@ -16,13 +16,15 @@
 - 用户修改状态：调用 `activate` / `pause`
 - 用户删除盯盘：调用 `remove`
 - 需要接收触发消息：由插件后台运行时持续接收
+- 需要主动通过邮件、短信、电话发送通知时
 
 ## 功能
 
 - 与 `openclaw-bridge` 建立 WebSocket 长连接
-- 支持请求：`watch.create` / `watch.activate` / `watch.pause` / `watch.delete` / `ping`
-- 支持渠道：`openclaw` / `email` / `call`
+- 支持请求：`watch.create` / `watch.activate` / `watch.pause` / `watch.delete` / `ticker.query` / `notify.send` / `ping`
+- 支持渠道：`openclaw` / `email` / `call` / `sms` / `dingtalk`
 - 订阅推送：`watch.triggered`
+- 主动发起通知结果推送：`notify.sent`
 - 自动重连 + 心跳
 - 严格单活（同 token 只允许一个活跃进程）
 - 断线请求排队（可配置），重连后自动冲刷
@@ -98,7 +100,7 @@ await adapter.submitWatchDemand({
   productType: 'hk_stock',
   condition: 'price >= threshold',
   variables: { threshold: 8.97 },
-  channels: ['openclaw', 'email', 'call'], // openclaw 必传，email/call 可选
+  channels: ['openclaw', 'email', 'call', 'sms', 'dingtalk'], // openclaw 必传，其它可选
   emailConfig: {
     to_address: 'demo@example.com',
     template_id: 4
@@ -106,10 +108,35 @@ await adapter.submitWatchDemand({
   callConfig: {
     phone: '13800138000',
     customer_name: 'Demo'
+  },
+  smsConfig: {
+    receiver: '13800138000',
+    template_id: 90010,
+    content: '测试短信'
+  },
+  dingtalkConfig: {
+    cas_id: 'user.dingtalk',
+    template_id: 3,
+    msg_type: 'text',
+    content: '测试钉钉消息'
   }
 });
 ```
 
+## 插件工具（OpenClaw 调用）
+
+- `watch_query_ticker`
+- `watch_create`
+- `watch_pause`
+- `watch_activate`
+- `watch_remove`
+- `notify_sms`
+- `notify_call`
+- `notify_email`
+- `notify_dingtalk`
+
+`notify_*` 工具走 bridge `notify.send` 直连通知链路，发送完成后客户端会收到 `notify.sent` 回执事件。
+
 ## 客户端事件
 
 - `connected`

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "openclaw-glance-plugin",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "OpenClaw plugin client for ticker-monitor openclaw-bridge",
   "type": "module",
   "main": "index.js",
   "openclaw": {
-    "extensions": ["./index.js"]
+    "extensions": [
+      "./index.js"
+    ]
   },
   "exports": {
     ".": "./index.js",

package/skills/glance-watch/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: glance-watch
-description: 智能盯盘插件，用于监控A股、港股、比特币等金融市场行情并在条件触发时发送提醒。当用户要求盯盘、监控价格、设置提醒时自动触发，例如"帮我盯着比特币"、监控某只股票、涨跌幅提醒等。
+description: 智能盯盘插件，用于监控A股、港股、比特币等金融市场行情并在条件触发时发送提醒。当用户要求盯盘、监控价格、设置提醒、需要通过邮件/电话/短信/钉钉发起通知时自动触发，例如"帮我盯着比特币"、监控某只股票、涨跌幅提醒、短信通知我等。
 ---
 
 # Glance Watch 智能盯盘
@@ -18,8 +18,8 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
    - `variables`: 变量值
 
 3. **通过已安装运行时提交盯盘请求**（长连接由宿主运行时维护）
-
 4. **用户要求“查行情/看当前价格/报价”时**，优先调用 `queryTickerData` 获取实时数据，再决定是否创建盯盘策略。
+5. **用户要求“发短信/打电话/发邮件”时**。
 
 ## 调用契约（必须遵循）
 
@@ -32,12 +32,17 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 - `watch.pause`
 - `watch.activate`
 - `watch.remove`
+- `notify.sms`
+- `notify.call`
+- `notify.email`
+- `notify.dingtalk`
 
 ### 调用顺序
 
 1. 用户是“查行情”意图：先调用 `watch.query_ticker`
 2. 用户是“盯盘创建”意图：先补齐参数后调用 `watch.create`
 3. 用户是“暂停/恢复/删除”意图：分别调用 `watch.pause` / `watch.activate` / `watch.remove`
+4. 用户是“立即发短信/打电话/发邮件/发钉钉”意图：调用 `notify.sms` / `notify.call` / `notify.email` / `notify.dingtalk`
 
 禁止跳步：创建盯盘前若缺关键字段必须先追问。
 
@@ -69,6 +74,12 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 - `channels`（默认至少包含 `openclaw`）
 - 对应渠道配置（`emailConfig/callConfig/smsConfig`）
 
+渠道参数要求（必须）：
+- 只要 `channels` 包含 `email`，必须提供 `emailConfig` 且包含 `to_address`
+- 只要 `channels` 包含 `call`，必须提供 `callConfig` 且包含 `phone`
+- 只要 `channels` 包含 `sms`，必须提供 `smsConfig` 且包含 `receiver`（或 `phone`）
+- 只要 `channels` 包含 `dingtalk`，必须提供 `dingtalkConfig` 且包含 `cas_id`
+
 成功判定：
 - 返回 `success = true`
 
@@ -87,6 +98,23 @@ description: 智能盯盘插件，用于监控A股、港股、比特币等金融
 失败处理：
 - 返回失败原因并提示用户确认策略 ID
 
+#### `notify.sms` / `notify.call` / `notify.email` / `notify.dingtalk`
+
+参数：
+- `notify.sms`：必须提供手机号（`receiver` 或 `phone`）
+- `notify.call`：必须提供 `phone`
+- `notify.email`：必须提供 `to_address`
+- `notify.dingtalk`：必须提供 `cas_id`
+
+成功判定：
+- 返回 `success = true`
+
+失败处理：
+- 明确返回失败原因，不要静默重试
+
+回执说明：
+- 直连通知发送完成后，客户端会收到 `notify.sent` 事件（`overall_status/success_count/failed_count/deliveries`）
+
 ## 调用判定规则
 
 只有在用户明确表达以下意图时调用插件：
@@ -185,13 +213,21 @@ await runtime.queryTickerData({
 
 ## 渠道参数填写
 
-`openclaw` 渠道必传，`email` / `call` / `sms` 可选。如用户没明确说明使用邮件(email)、电话/外呼(call)、短信(sms) 通知提醒，则只需要传入`openclaw` 渠道。
+`openclaw` 渠道必传，`email` / `call` / `sms` / `dingtalk` 可选。如用户没明确说明使用邮件(email)、电话/外呼(call)、短信(sms)、钉钉(dingtalk)通知提醒，则只需要传入`openclaw`渠道。
+
+但一旦用户选择了某个通知渠道，其配置参数必须完整填写：
+- 选择 `email` 必须提供 `emailConfig.to_address`
+- 选择 `call` 必须提供 `callConfig.phone`
+- 选择 `sms` 必须提供 `smsConfig.receiver`（或 `phone`）
+- 选择 `dingtalk` 必须提供 `dingtalkConfig.cas_id`
 
 ### email 参数（emailConfig）
-- `to_address`：收件人邮箱（必填）
+- `to_address`：收件人邮箱（必填，缺失不可创建/不可发送）
 - `template_id`：邮件模板 ID（必填，默认为4，不需要修改）
-- `template_params`：模板变量（可选）
-
+- `template_params`：模板变量
+- `title`: 收到邮件的标题
+- `product_name`: 产品名称 
+- `content`: 消息内容
 示例：
 ```javascript
 emailConfig: {
@@ -199,15 +235,17 @@ emailConfig: {
   template_id: 4,
   template_params: {
     title: '监控提醒',
-    product_name: '比特币'
+    product_name: '比特币',
+    content: '测试消息1'
   }
 }
 ```
+用户收到的是一封title为"监控提醒",内容为"测试消息1"的一封邮件
 
 ### call 参数（callConfig）
-- `phone`：手机号（必填）
-- `customer_name`：客户名称（可选）
-- `condition`：外呼内容（可选，默认用触发消息，如不需要自定义可使用默认消息）
+- `phone`：手机号（必填，缺失不可创建/不可发送）
+- `customer_name`：客户名称
+- `condition`：外呼内容
 
 示例：
 ```javascript
@@ -217,20 +255,42 @@ callConfig: {
   condition: '比特币价格突破阈值'
 }
 ```
+用户收到的是一通打给手机号码为13800138000的电话，电话内容为'比特币价格突破阈值'
+
 
 ### sms 参数（smsConfig）
-- `receiver`：手机号（必填；也可传 `phone`，推荐 `receiver`）
+- `receiver`：手机号（必填，必须是纯数字；缺失不可创建/不可发送）
 - `template_id`：短信模板 ID（可选，默认 90010，不需要修改）
-- `content`：短信变量内容（可选，默认用触发消息，如不需要自定义可使用默认消息）
+- `content`：短信变量内容
 
 示例：
 ```javascript
 smsConfig: {
-  receiver: '13968617776',
+  receiver: '13800138000',
   template_id: 90010,
   content: '测试消息1'
 }
 ```
+用户收到的是一封发送给手机号码为13800138000的短信，短信内容为'测试消息1'
+
+
+### 钉钉 参数（dingtalkConfig）
+- `cas_id`：钉钉用户ID（必填，缺失不可创建/不可发送）
+- `template_id`：钉钉模板 ID（可选，默认 3，不需要修改）
+- `msg_type`: 消息类型：text/markdown，默认 text
+- `content`：消息内容
+
+示例：
+```javascript
+dingtalkConfig: {
+  cas_id: 'user.dingtalk',
+  template_id: 3,
+  msg_type: "text",
+  content: "测试消息1"
+}
+```
+用户收到的是一条发送给钉钉号为user.dingtalk的单聊消息，消息内容为'测试消息1'
+
 
 ## 支持的市场
 
@@ -278,7 +338,7 @@ variables: { threshold: 420, product_name: '腾讯控股' }
 当监控触发时:
 1. 解析 `market_data` 获取价格、涨跌幅等信息
 2. 发送提醒到用户当前对话的渠道（群聊/私聊）
-3. `openclaw` 渠道必传，`email/call/sms` 可按需附加
+3. `openclaw` 渠道必传，`email/call/sms/dingtalk` 可按需附加
 4. 根据触发消息构建友好的提醒文案
 
 如果创建失败（`watch.create.result.success=false`）：

package/src/OpenClawPluginAdapter.js

@@ -98,6 +98,10 @@ export class OpenClawPluginAdapter {
       channelConfigs.sms = demand.smsConfig;
       if (!channels.includes('sms')) channels.push('sms');
     }
+    if (demand.dingtalkConfig) {
+      channelConfigs.dingtalk = demand.dingtalkConfig;
+      if (!channels.includes('dingtalk')) channels.push('dingtalk');
+    }
     if (!channels.includes('openclaw')) channels.unshift('openclaw');
     if (!channelConfigs.openclaw) channelConfigs.openclaw = {};
 

package/src/plugin/index.js

@@ -77,6 +77,10 @@ function mapDemandToCreatePayload(demand = {}) {
     channelConfigs.sms = demand.smsConfig;
     if (!channels.includes('sms')) channels.push('sms');
   }
+  if (demand.dingtalkConfig) {
+    channelConfigs.dingtalk = demand.dingtalkConfig;
+    if (!channels.includes('dingtalk')) channels.push('dingtalk');
+  }
   if (!channels.includes('openclaw')) channels.unshift('openclaw');
   if (!channelConfigs.openclaw) channelConfigs.openclaw = {};
 
@@ -114,6 +118,27 @@ function buildControlApi(startupPromise) {
       const runtime = await getReadyRuntime(startupPromise);
       return runtime.request('watch.create', payload);
     },
+    async sendNotification(input = {}) {
+      const runtime = await getReadyRuntime(startupPromise);
+      const channel = input.channel;
+      const payload = { ...(input.payload || {}) };
+      return runtime.request('notify.send', {
+        ...payload,
+        channel
+      });
+    },
+    async sendSms(payload = {}) {
+      return this.sendNotification({ channel: 'sms', payload });
+    },
+    async sendCall(payload = {}) {
+      return this.sendNotification({ channel: 'call', payload });
+    },
+    async sendEmail(payload = {}) {
+      return this.sendNotification({ channel: 'email', payload });
+    },
+    async sendDingtalk(payload = {}) {
+      return this.sendNotification({ channel: 'dingtalk', payload });
+    },
     async submitWatchDemand(demand = {}) {
       const runtime = await getReadyRuntime(startupPromise);
       return runtime.request('watch.create', mapDemandToCreatePayload(demand));
@@ -133,11 +158,20 @@ function buildControlApi(startupPromise) {
   };
 }
 
-function tryRegisterTool(registerTool, name, description, handler) {
+function tryRegisterTool(registerTool, name, description, parameters, handler) {
   if (typeof registerTool !== 'function') return;
+  const schema =
+    parameters || {
+      type: 'object',
+      additionalProperties: true,
+      properties: {}
+    };
+
   const def = {
     name,
     description,
+    parameters: schema,
+    inputSchema: schema,
     handler,
     execute: async (_toolCallId, params) => handler(params || {})
   };
@@ -170,20 +204,122 @@ function tryRegisterTool(registerTool, name, description, handler) {
 
 function registerControlTools(api, controlApi) {
   const registerTool = api?.registerTool || api?.runtime?.registerTool;
-  tryRegisterTool(registerTool, 'watch.query_ticker', 'Query ticker data', (args) =>
-    controlApi.queryTickerData(args || {})
+
+  tryRegisterTool(
+    registerTool,
+    'watch_query_ticker',
+    'Query ticker data',
+    {
+      type: 'object',
+      additionalProperties: true,
+      properties: {
+        stock_code: { type: 'string' },
+        product_code: { type: 'string' },
+        product_type: { type: 'string' },
+        market: { type: 'string' }
+      }
+    },
+    (args) => controlApi.queryTickerData(args || {})
   );
-  tryRegisterTool(registerTool, 'watch.create', 'Create watch strategy', (args) =>
-    controlApi.createWatch(args || {})
+
+  tryRegisterTool(
+    registerTool,
+    'notify_sms',
+    'Send SMS notification',
+    {
+      type: 'object',
+      additionalProperties: true,
+      properties: {}
+    },
+    (args) => controlApi.sendSms(args || {})
   );
-  tryRegisterTool(registerTool, 'watch.pause', 'Pause watch strategy', (args) =>
-    controlApi.pauseWatch(args?.strategyId || args?.strategy_id)
+
+  tryRegisterTool(
+    registerTool,
+    'notify_call',
+    'Send phone call notification',
+    {
+      type: 'object',
+      additionalProperties: true,
+      properties: {}
+    },
+    (args) => controlApi.sendCall(args || {})
   );
-  tryRegisterTool(registerTool, 'watch.activate', 'Activate watch strategy', (args) =>
-    controlApi.activateWatch(args?.strategyId || args?.strategy_id)
+
+  tryRegisterTool(
+    registerTool,
+    'notify_email',
+    'Send email notification',
+    {
+      type: 'object',
+      additionalProperties: true,
+      properties: {}
+    },
+    (args) => controlApi.sendEmail(args || {})
   );
-  tryRegisterTool(registerTool, 'watch.remove', 'Delete watch strategy', (args) =>
-    controlApi.deleteWatch(args?.strategyId || args?.strategy_id)
+
+  tryRegisterTool(
+    registerTool,
+    'notify_dingtalk',
+    'Send dingtalk notification',
+    {
+      type: 'object',
+      additionalProperties: true,
+      properties: {}
+    },
+    (args) => controlApi.sendDingtalk(args || {})
+  );
+
+  tryRegisterTool(
+    registerTool,
+    'watch_create',
+    'Create watch strategy',
+    {
+      type: 'object',
+      additionalProperties: true,
+      properties: {
+        product_code: { type: 'string' },
+        product_type: { type: 'string' },
+        operator_type: { type: 'string' },
+        operator_parameters: { type: 'object' },
+        channels: { type: 'array', items: { type: 'string' } },
+        channel_configs: { type: 'object' }
+      }
+    },
+    (args) => controlApi.createWatch(args || {})
+  );
+
+  const strategySchema = {
+    type: 'object',
+    additionalProperties: true,
+    properties: {
+      strategy_id: { type: 'string' },
+      strategyId: { type: 'string' }
+    }
+  };
+
+  tryRegisterTool(
+    registerTool,
+    'watch_pause',
+    'Pause watch strategy',
+    strategySchema,
+    (args) => controlApi.pauseWatch(args?.strategyId || args?.strategy_id)
+  );
+
+  tryRegisterTool(
+    registerTool,
+    'watch_activate',
+    'Activate watch strategy',
+    strategySchema,
+    (args) => controlApi.activateWatch(args?.strategyId || args?.strategy_id)
+  );
+
+  tryRegisterTool(
+    registerTool,
+    'watch_remove',
+    'Delete watch strategy',
+    strategySchema,
+    (args) => controlApi.deleteWatch(args?.strategyId || args?.strategy_id)
   );
 }
 
@@ -194,11 +330,9 @@ const plugin = {
   register(api) {
     const pluginConfig =
       api?.config?.plugins?.entries?.['openclaw-glance-plugin']?.config ||
-      api?.config?.plugins?.entries?.openclawGlancePlugin?.config ||
-      api?.config?.plugins?.['openclaw-glance-plugin']?.config ||
-      api?.config?.plugins?.openclawGlancePlugin?.config ||
       api?.config?.plugins?.entries?.['glance-bridge']?.config ||
       api?.config?.plugins?.entries?.glanceBridge?.config ||
+      api?.config?.plugins?.['openclaw-glance-plugin']?.config ||
       api?.config?.plugins?.['glance-bridge']?.config ||
       api?.config?.plugins?.glanceBridge?.config ||
       {};