适用于 Openclaw 的 跨平台通知器

一个统一的系统通知实用工具,使 AI 代理能够在 Windows、macOS、Linux 和 WSL 上发送原生桌面警报。

1tsnakers
v1.0.0
2026年6月1日
0
556
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install cross-platform-notifier

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 cross-platform-notifier。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 跨平台通知器?

跨平台通知器是一个高度可靠的脚本,旨在弥合不同操作系统与本地桌面通知机制之间的鸿沟。该通知模块专为使用 Openclaw Skills 的开发者打造,使自动化的 AI 工作流能够在需要人工关注时轻松地向系统操作员发送提醒。无论您是在 Windows Subsystem for Linux (WSL) 中运行复杂任务、在 macOS 上进行原生工作,还是在 Linux 服务器上管理作业,此工具都能动态调整以在本地提示用户。

通过集成此警报功能,您可以确保 AI 代理永远不会让您处于等待状态。它解决了开发者在后台启动长时间编译、数据分析或测试循环后却将其遗忘的经典问题。将此辅助工具添加到您的 Openclaw Skills 套件中,可以在后台自动化任务与人工验证之间架起桥梁。

跨平台通知器 应用场景

  • 长时间运行任务完成: 在繁重的后台进程(如 docker 构建或数据集解析)完成后,立即提醒开发者。
  • 紧急代码阻塞: 当自动化测试或安全扫描脚本遇到需要立即手动处理的失败时,通知开发者。
  • 操作确认: 在数据库植入或基础设施部署等高影响力的 CLI 任务成功完成后,提供清晰的视觉确认。

跨平台通知器 工作原理

  1. 执行请求: AI 代理通过包含所需消息和标题的统一 shell 命令触发通知器。
  2. 环境与内核检测: 底层脚本 notify.sh 会分析主机操作系统的环境,专门检查原生 Linux、macOS、Windows 或 Microsoft WSL 内核。
  3. OS 特定通知调度:
    • Windows: 调用 PowerShell 并调用 System.Windows.Forms.MessageBox API。
    • macOS: 运行 osascript 来触发原生 AppleScript 警报框。
    • Linux: 使用 notify-send 发送系统通知。
    • WSL: 将执行上下文清晰地传回给 Windows 主机,通过 powershell.exe 渲染原生 Windows 警报对话框。
  4. 完成状态: 返回成功退出代码,确认视觉警报已在主机屏幕上渲染。

跨平台通知器 配置指南

要将此通知功能集成到您的自动化代理中,请按照以下配置步骤操作:

  1. 确保脚本在您的终端中具有适当的执行权限:
chmod +x ./skills/cross-platform-notifier/scripts/notify.sh
  1. 使用以下格式直接从您的终端测试警报功能:
./skills/cross-platform-notifier/scripts/notify.sh "This is a test notification" "Hello World"

跨平台通知器 数据架构与分类体系

此实用工具是独立的,纯粹作为执行块运行,不维护状态数据库。它接受位置参数以生成标准警报,如下所述:

参数索引 参数类型 描述 必需
$1 String 通知消息:在系统通知对话框中显示的主要文本内容。
$2 String 通知标题:在警报框顶部显示的标题文本。 否(可选)

此模块不会生成任何动态日志文件或跟踪数据库。

跨平台通知器 高级特性

  • WSL 转换循环: 自动检测 WSL 虚拟化内核,以无缝地将警报正确路由到主机 Windows 桌面环境。
  • 零依赖核心: 利用原生操作系统二进制文件(osascriptpowershell.exenotify-send),避免复杂的第三方系统依赖。
  • 代理钩子: 可轻松集成到自动化管道和其他 Openclaw Skills 中,作为任务完成后的后置钩子操作。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*