openclaw-remote-skills 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Assistant
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# OpenClaw Remote Skills
+
+一个包含两个强大远程技能的 OpenClaw 扩展包，让你可以远程操作 Windows 节点和 WPS365 功能。
+
+## 📦 包含的技能
+
+### 1. `remote-wps365-skill`
+**远程调用 Windows 节点上的 WPS365 功能**
+
+特性:
+- ✅ 即时消息：搜索会话、发送消息、获取历史消息
+- ✅ 日历管理：创建、查询、更新日历事件
+- ✅ 联系人管理：搜索、查看联系人
+- ✅ 云盘操作：上传、下载、搜索文件
+- ✅ 数据表操作：读写数据表
+- ✅ 会议管理：创建、加入会议
+- ✅ **Agentspace 自动安装**：一键安装配置 agentspace 插件
+- ✅ 批量消息发送
+- ✅ 完整的错误处理和重试机制
+
+### 2. `remote-node-skill`
+**远程节点操作技能**
+
+特性:
+- ✅ 检查节点状态和连接
+- ✅ 在远程节点上执行系统命令
+- ✅ 读取远程文件内容
+- ✅ 列出远程目录
+- ✅ 获取系统信息
+- ✅ 控制远程浏览器
+- ✅ 支持 Windows 和 Linux/Mac 节点
+
+## 🚀 快速安装
+
+### 方法1：使用 npx（推荐）
+```bash
+# 一键安装
+npx openclaw-remote-skills
+
+# 显示详细安装信息
+npx openclaw-remote-skills --verbose
+
+# 强制重新安装
+npx openclaw-remote-skills --force
+```
+
+### 方法2：全局安装
+```bash
+# 全局安装
+npm install -g openclaw-remote-skills
+
+# 安装技能
+install-openclaw-skills
+```
+
+### 方法3：本地安装
+```bash
+# 作为项目依赖安装
+npm install openclaw-remote-skills
+
+# 运行安装脚本
+npx install-openclaw-skills
+```
+
+## 🔧 配置步骤
+
+安装脚本会自动复制技能文件。你需要手动配置 OpenClaw：
+
+### 1. 编辑 OpenClaw 配置文件
+编辑 `~/.openclaw/openclaw.json`，在 `skills.load.extraDirs` 数组中添加：
+
+```json
+{
+  "skills": {
+    "load": {
+      "extraDirs": [
+        "/home/你的用户名/.openclaw/skills/remote-wps365-skill",
+        "/home/你的用户名/.openclaw/skills/remote-node-skill"
+      ]
+    }
+  }
+}
+```
+
+**注意：** 将 `/home/你的用户名` 替换为你的实际用户目录。
+
+### 2. 重启 OpenClaw
+```bash
+openclaw gateway restart
+```
+
+### 3. 验证安装
+在 OpenClaw 会话中询问：
+```
+你有哪些可用的skills
+```
+
+应该能看到 `remote-wps365-skill` 和 `remote-node-skill` 在列表中。
+
+## 📖 使用指南
+
+### remote-wps365-skill 使用示例
+
+```javascript
+// 在你的 OpenClaw 技能或脚本中使用
+const { wps365 } = require('~/.openclaw/skills/remote-wps365-skill/wps365-remote.js')
+
+// 发送消息到群聊
+await wps365.sendMessageToGroup("个人测试告警群", "**系统通知**\n测试消息")
+
+// 搜索会话
+const chats = await wps365.runCommand("im", "search", {
+  keyword: "测试",
+  page_size: 10
+})
+
+// 一键安装 agentspace
+const { installAgentspace } = require('~/.openclaw/skills/remote-wps365-skill/wps365-remote.js')
+const result = await installAgentspace()
+```
+
+### remote-node-skill 使用示例
+
+```javascript
+// 使用 OpenClaw 的 nodes 工具
+const status = nodes(action="status")
+
+// 获取 Windows 节点 ID
+const windowsNode = status.nodes.find(node => 
+  node.platform === "win32" && node.connected === true
+)
+
+// 执行远程命令
+const result = nodes(
+  action="invoke",
+  node=windowsNode.nodeId,
+  invokeCommand="system.run",
+  invokeParamsJson={"command": ["cmd.exe", "/c", "echo Hello from Windows"]}
+)
+```
+
+### 命令行使用
+
+```bash
+# 进入技能目录
+cd ~/.openclaw/skills/remote-wps365-skill
+
+# 运行演示
+npm run demo
+
+# 安装 agentspace
+npm run install-agentspace
+
+# 检查 agentspace 状态
+npm run check-agentspace
+
+# 发送消息
+npm run send -- "群名" "消息内容"
+```
+
+## 🛠️ 依赖和要求
+
+### 系统要求
+- Node.js >= 14.0.0
+- OpenClaw >= 2026.3.7
+- 网络连接（用于下载 agentspace 安装器）
+
+### Windows 节点要求
+- Windows 节点已与 OpenClaw 配对并连接
+- Windows 节点上已安装 wps365-skill（路径：`C:\Users\KSG\.openclaw\skills\wps365-skill`）
+- Windows 节点的 openclaw.json 中配置了正确的 wps_sid
+- 节点具有 system.run 执行权限
+
+## 🔍 故障排除
+
+### 技能未显示
+1. 检查技能路径是否正确配置在 `openclaw.json` 中
+2. 确保 OpenClaw 已重启
+3. 检查技能目录权限
+4. 运行检查命令：`npx openclaw-remote-skills check`
+
+### Windows 节点连接问题
+1. 确认 Windows 节点已配对：`openclaw nodes status`
+2. 确认节点在线并连接
+3. 检查防火墙设置
+
+### agentspace 安装失败
+1. 确认网络连接正常
+2. 确认 Windows 节点上有 agentspace 配置
+3. 检查是否有权限写入 `openclaw.json`
+4. 查看详细错误：`npx openclaw-remote-skills --verbose`
+
+## 🔄 更新
+
+### 更新 npm 包
+```bash
+# 如果是全局安装
+npm update -g openclaw-remote-skills
+
+# 如果是本地安装
+npm update openclaw-remote-skills
+
+# 重新运行安装
+npx openclaw-remote-skills --force
+```
+
+### 手动更新
+```bash
+# 备份旧版本
+cp -r ~/.openclaw/skills/remote-wps365-skill ~/.openclaw/skills/remote-wps365-skill.backup
+cp -r ~/.openclaw/skills/remote-node-skill ~/.openclaw/skills/remote-node-skill.backup
+
+# 重新安装
+npx openclaw-remote-skills --force
+```
+
+## 📁 项目结构
+
+```
+openclaw-remote-skills/
+├── bin/
+│   └── install.js          # 安装脚本（命令行入口）
+├── skills/
+│   ├── remote-wps365-skill/  # WPS365 远程技能
+│   └── remote-node-skill/    # 远程节点技能
+├── index.js                # 主模块
+├── package.json           # npm 包配置
+└── README.md             # 本文档
+```
+
+## 🤝 贡献
+
+欢迎贡献代码！请遵循以下步骤：
+
+1. Fork 仓库
+2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add some amazing feature'`)
+4. 推送分支 (`git push origin feature/amazing-feature`)
+5. 创建 Pull Request
+
+## 📄 许可证
+
+本项目基于 MIT 许可证开源 - 查看 [LICENSE](LICENSE) 文件了解详情。
+
+## 🙏 致谢
+
+感谢 [OpenClaw](https://openclaw.ai) 社区的支持和贡献。
+
+## 📞 支持
+
+- **问题报告**: [GitHub Issues](https://github.com/your-username/openclaw-remote-skills/issues)
+- **讨论**: [OpenClaw Discord](https://discord.com/invite/clawd)
+- **文档**: [OpenClaw Docs](https://docs.openclaw.ai)
+
+---
+
+**提示**: 安装完成后，记得重启 OpenClaw 并检查技能是否出现在可用技能列表中！

package/bin/install.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * OpenClaw Remote Skills 安装脚本
+ * 这是包的 bin 入口，支持直接运行
+ */
+
+const path = require('path')
+const { installSkills } = require('../index.js')
+
+// 彩色输出
+const colors = {
+  reset: '\x1b[0m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m'
+}
+
+function colorize(text, color) {
+  return colors[color] + text + colors.reset
+}
+
+// 显示横幅
+console.log(colorize(`
+╔══════════════════════════════════════════════════════════╗
+║                                                          ║
+║    ╔═╗┌─┐┌┬┐┌─┐┬  ┌─┐┬─┐  ╦═╗┌─┐┬ ┬┌┬┐┬┌┐┌┌─┐         ║
+║    ╠═╝├┤  │ ├─┘│  ├┤ ├┬┘  ╠╦╝│ ││ │ │ ││││├┤          ║
+║    ╩  └─┘ ┴ ┴  ┴─┘└─┘┴└─  ╩╚═└─┘└─┘ ┴ ┴┘└┘└─┘         ║
+║                                                          ║
+║                  Remote Skills Installer                 ║
+║                                                          ║
+╚══════════════════════════════════════════════════════════╝
+`, 'cyan'))
+
+console.log(colorize('🚀 开始安装 OpenClaw Remote Skills...', 'yellow'))
+console.log()
+
+// 解析命令行参数
+const args = process.argv.slice(2)
+const options = {
+  verbose: args.includes('--verbose') || args.includes('-v'),
+  force: args.includes('--force') || args.includes('-f'),
+  help: args.includes('--help') || args.includes('-h')
+}
+
+// 显示帮助
+if (options.help) {
+  console.log(colorize('使用方法:', 'green'))
+  console.log('  npx openclaw-remote-skills')
+  console.log('  npx openclaw-remote-skills [选项]')
+  console.log()
+  console.log(colorize('选项:', 'green'))
+  console.log('  -v, --verbose   显示详细安装信息')
+  console.log('  -f, --force     强制重新安装已存在的技能')
+  console.log('  -h, --help      显示此帮助信息')
+  console.log()
+  console.log(colorize('示例:', 'green'))
+  console.log('  npx openclaw-remote-skills')
+  console.log('  npx openclaw-remote-skills --verbose')
+  console.log('  npx openclaw-remote-skills --force')
+  console.log()
+  process.exit(0)
+}
+
+// 执行安装
+try {
+  console.log(colorize('📦 正在安装技能包...', 'blue'))
+  
+  const result = installSkills(options)
+  
+  console.log()
+  console.log(colorize('✅ 安装完成！', 'green'))
+  
+  // 显示安装摘要
+  console.log(colorize('\n📊 安装摘要:', 'cyan'))
+  result.results.forEach(item => {
+    const statusIcon = item.status === 'installed' ? '✅' : 
+                      item.status === 'skipped' ? '⏭️' : '❌'
+    const statusColor = item.status === 'installed' ? 'green' : 
+                       item.status === 'skipped' ? 'yellow' : 'red'
+    
+    console.log(`  ${statusIcon} ${colorize(item.name, statusColor)}`)
+    if (item.status === 'failed') {
+      console.log(`    错误: ${colorize(item.error, 'red')}`)
+    }
+  })
+  
+  // 显示配置提示
+  console.log(colorize('\n🔧 配置说明:', 'magenta'))
+  console.log(result.configPrompt)
+  
+  // 显示使用提示
+  console.log(colorize('\n🎯 使用技能:', 'yellow'))
+  console.log(`
+  安装完成后，重启 OpenClaw 即可使用:
+  
+  1. 重启 OpenClaw:
+     ${colorize('openclaw gateway restart', 'cyan')}
+  
+  2. 验证技能加载:
+     在 OpenClaw 会话中询问 "你有哪些可用的skills"
+  
+  3. 使用技能:
+     • remote-wps365-skill: 远程 WPS365 操作
+     • remote-node-skill: 远程节点操作
+  `)
+  
+  console.log(colorize('\n💡 提示:', 'blue'))
+  console.log('  可以通过以下命令检查安装状态:')
+  console.log(`  ${colorize('npx openclaw-remote-skills check', 'cyan')}`)
+  
+  console.log(colorize('\n✨ 安装完成！重启 OpenClaw 后即可使用远程技能。', 'green'))
+  
+} catch (error) {
+  console.error(colorize(`\n❌ 安装失败: ${error.message}`, 'red'))
+  console.error(colorize('错误详情:', 'red'))
+  console.error(error.stack)
+  process.exit(1)
+}

package/index.js

@@ -0,0 +1,306 @@
+#!/usr/bin/env node
+/**
+ * OpenClaw Remote Skills 主入口文件
+ * 
+ * 这个包提供两个强大的 OpenClaw 远程技能：
+ * 1. remote-wps365-skill - 远程调用 Windows 节点上的 WPS365 功能
+ * 2. remote-node-skill - 远程节点操作技能
+ * 
+ * @file 主模块文件
+ * @module openclaw-remote-skills
+ */
+
+const path = require('path')
+const fs = require('fs')
+
+/**
+ * 获取技能安装信息
+ * @returns {Object} 技能信息
+ */
+function getSkillsInfo() {
+  return {
+    skills: [
+      {
+        name: 'remote-wps365-skill',
+        description: '远程调用 Windows 节点上的 WPS365 功能',
+        path: path.join(__dirname, 'skills', 'remote-wps365-skill'),
+        version: '1.0.0'
+      },
+      {
+        name: 'remote-node-skill',
+        description: '远程节点操作技能',
+        path: path.join(__dirname, 'skills', 'remote-node-skill'),
+        version: '1.0.0'
+      }
+    ],
+    version: require('./package.json').version,
+    installPath: getOpenClawSkillsPath()
+  }
+}
+
+/**
+ * 获取 OpenClaw 技能路径
+ * @returns {string} 技能安装路径
+ */
+function getOpenClawSkillsPath() {
+  const homeDir = process.env.HOME || process.env.USERPROFILE || '/home/' + process.env.USER
+  return path.join(homeDir, '.openclaw', 'skills')
+}
+
+/**
+ * 检查技能是否已安装
+ * @returns {Object} 检查结果
+ */
+function checkInstallation() {
+  const openclawSkillsPath = getOpenClawSkillsPath()
+  const skills = getSkillsInfo().skills
+  
+  const results = skills.map(skill => {
+    const targetPath = path.join(openclawSkillsPath, skill.name)
+    return {
+      name: skill.name,
+      installed: fs.existsSync(targetPath),
+      path: targetPath
+    }
+  })
+  
+  const allInstalled = results.every(r => r.installed)
+  
+  return {
+    allInstalled,
+    skills: results,
+    openclawSkillsPath
+  }
+}
+
+/**
+ * 安装技能
+ * @param {Object} options - 安装选项
+ * @returns {Object} 安装结果
+ */
+function installSkills(options = {}) {
+  const { verbose = false, force = false } = options
+  const openclawSkillsPath = getOpenClawSkillsPath()
+  const skills = getSkillsInfo().skills
+  
+  console.log('🚀 开始安装 OpenClaw Remote Skills...')
+  console.log(`目标目录: ${openclawSkillsPath}`)
+  
+  // 创建目标目录
+  if (!fs.existsSync(openclawSkillsPath)) {
+    fs.mkdirSync(openclawSkillsPath, { recursive: true })
+    if (verbose) console.log(`✅ 创建目录: ${openclawSkillsPath}`)
+  }
+  
+  const results = []
+  
+  // 安装每个技能
+  skills.forEach(skill => {
+    const sourcePath = skill.path
+    const targetPath = path.join(openclawSkillsPath, skill.name)
+    
+    if (fs.existsSync(targetPath) && !force) {
+      if (verbose) console.log(`⏭️  跳过 ${skill.name} (已存在)`)
+      results.push({ name: skill.name, status: 'skipped', path: targetPath })
+      return
+    }
+    
+    try {
+      // 复制技能
+      copyFolderSync(sourcePath, targetPath)
+      
+      if (verbose) {
+        console.log(`✅ 安装 ${skill.name}`)
+        console.log(`   来源: ${sourcePath}`)
+        console.log(`   目标: ${targetPath}`)
+      } else {
+        console.log(`✅ ${skill.name}`)
+      }
+      
+      results.push({ name: skill.name, status: 'installed', path: targetPath })
+    } catch (error) {
+      console.error(`❌ 安装 ${skill.name} 失败: ${error.message}`)
+      results.push({ name: skill.name, status: 'failed', error: error.message })
+    }
+  })
+  
+  // 生成配置提示
+  const installedSkills = results.filter(r => r.status === 'installed')
+  
+  return {
+    success: results.every(r => r.status !== 'failed'),
+    results,
+    configPrompt: generateConfigPrompt(installedSkills)
+  }
+}
+
+/**
+ * 复制文件夹（同步）
+ * @param {string} src - 源路径
+ * @param {string} dest - 目标路径
+ */
+function copyFolderSync(src, dest) {
+  if (!fs.existsSync(src)) {
+    throw new Error(`源路径不存在: ${src}`)
+  }
+  
+  // 确保目标目录存在
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true })
+  }
+  
+  // 复制目录内容
+  const items = fs.readdirSync(src)
+  
+  items.forEach(item => {
+    const srcPath = path.join(src, item)
+    const destPath = path.join(dest, item)
+    
+    const stat = fs.statSync(srcPath)
+    
+    if (stat.isDirectory()) {
+      copyFolderSync(srcPath, destPath)
+    } else {
+      fs.copyFileSync(srcPath, destPath)
+    }
+  })
+}
+
+/**
+ * 生成配置提示信息
+ * @param {Array} installedSkills - 已安装的技能
+ * @returns {string} 配置提示
+ */
+function generateConfigPrompt(installedSkills) {
+  if (installedSkills.length === 0) {
+    return '没有需要配置的技能。'
+  }
+  
+  const openclawSkillsPath = getOpenClawSkillsPath()
+  const configLines = installedSkills.map(skill => {
+    const skillPath = path.join(openclawSkillsPath, skill.name)
+    return `"${skillPath}"`
+  })
+  
+  return `
+📋 下一步配置:
+
+1. 编辑 OpenClaw 配置文件:
+   ~/.openclaw/openclaw.json
+
+2. 在 "skills.load.extraDirs" 数组中添加以下路径:
+${configLines.map(line => `   - ${line}`).join('\n')}
+
+3. 重启 OpenClaw:
+   openclaw gateway restart
+
+安装完成后，技能会自动出现在 OpenClaw 的可用技能列表中。`
+}
+
+/**
+ * 显示使用帮助
+ */
+function showHelp() {
+  console.log(`
+OpenClaw Remote Skills 工具
+
+用法:
+  node index.js [命令] [选项]
+
+命令:
+  install     安装技能
+  check       检查安装状态
+  info        显示包信息
+  help        显示此帮助信息
+
+选项:
+  --verbose   显示详细输出
+  --force     强制重新安装
+
+示例:
+  node index.js install --verbose
+  node index.js check
+  node index.js info
+  `)
+}
+
+/**
+ * 显示包信息
+ */
+function showInfo() {
+  const info = getSkillsInfo()
+  
+  console.log(`
+OpenClaw Remote Skills - v${info.version}
+========================================
+
+包含技能:
+${info.skills.map(skill => `  • ${skill.name} - ${skill.description}`).join('\n')}
+
+安装路径: ${info.installPath}
+
+特性:
+  • 一键安装两个远程技能
+  • 自动配置提示
+  • 支持 Windows 节点远程操作
+  • 包含 WPS365 功能集成
+  • 包含 agentspace 自动安装
+  `)
+}
+
+// 命令行接口
+if (require.main === module) {
+  const args = process.argv.slice(2)
+  
+  if (args.length === 0) {
+    showHelp()
+    process.exit(0)
+  }
+  
+  const command = args[0]
+  const options = {
+    verbose: args.includes('--verbose'),
+    force: args.includes('--force')
+  }
+  
+  switch (command) {
+    case 'install':
+      const result = installSkills(options)
+      console.log('\n' + result.configPrompt)
+      process.exit(result.success ? 0 : 1)
+      break
+      
+    case 'check':
+      const check = checkInstallation()
+      console.log('\n安装状态检查:')
+      check.skills.forEach(skill => {
+        console.log(`  ${skill.name}: ${skill.installed ? '✅ 已安装' : '❌ 未安装'}`)
+        if (skill.installed) {
+          console.log(`    路径: ${skill.path}`)
+        }
+      })
+      console.log(`\nOpenClaw 技能目录: ${check.openclawSkillsPath}`)
+      break
+      
+    case 'info':
+      showInfo()
+      break
+      
+    case 'help':
+      showHelp()
+      break
+      
+    default:
+      console.error(`未知命令: ${command}`)
+      showHelp()
+      process.exit(1)
+  }
+}
+
+// 导出模块
+module.exports = {
+  getSkillsInfo,
+  checkInstallation,
+  installSkills,
+  getOpenClawSkillsPath
+}