openclaw-remote-skills
v1.0.3
Published
OpenClaw remote skills package - remote-wps365-skill and remote-node-skill
Maintainers
Readme
OpenClaw Remote Skills
一个包含两个强大远程技能的 OpenClaw 扩展包,让你可以远程操作 Windows 节点和 WPS365 功能。
📦 包含的技能
1. remote-wps365-skill
远程调用 Windows 节点上的 WPS365 功能
特性:
- ✅ 即时消息:搜索会话、发送消息、获取历史消息
- ✅ 日历管理:创建、查询、更新日历事件
- ✅ 联系人管理:搜索、查看联系人
- ✅ 云盘操作:上传、下载、搜索文件
- ✅ 数据表操作:读写数据表
- ✅ 会议管理:创建、加入会议
- ✅ Agentspace 自动安装:一键安装配置 agentspace 插件
- ✅ 批量消息发送
- ✅ 完整的错误处理和重试机制
2. remote-node-skill
远程节点操作技能
特性:
- ✅ 检查节点状态和连接
- ✅ 在远程节点上执行系统命令
- ✅ 读取远程文件内容
- ✅ 列出远程目录
- ✅ 获取系统信息
- ✅ 控制远程浏览器
- ✅ 支持 Windows 和 Linux/Mac 节点
🚀 快速安装
方法1:使用 npx(推荐)
# 一键安装
npx openclaw-remote-skills
# 显示详细安装信息
npx openclaw-remote-skills --verbose
# 强制重新安装
npx openclaw-remote-skills --force方法2:全局安装
# 全局安装
npm install -g openclaw-remote-skills
# 安装技能
install-openclaw-skills方法3:本地安装
# 作为项目依赖安装
npm install openclaw-remote-skills
# 运行安装脚本
npx install-openclaw-skills🔧 配置步骤
安装脚本会自动复制技能文件。你需要手动配置 OpenClaw:
1. 编辑 OpenClaw 配置文件
编辑 ~/.openclaw/openclaw.json,在 skills.load.extraDirs 数组中添加:
{
"skills": {
"load": {
"extraDirs": [
"/home/你的用户名/.openclaw/skills/remote-wps365-skill",
"/home/你的用户名/.openclaw/skills/remote-node-skill"
]
}
}
}注意: 将 /home/你的用户名 替换为你的实际用户目录。
2. 重启 OpenClaw
openclaw gateway restart3. 验证安装
在 OpenClaw 会话中询问:
你有哪些可用的skills应该能看到 remote-wps365-skill 和 remote-node-skill 在列表中。
📖 使用指南
remote-wps365-skill 使用示例
// 在你的 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 使用示例
// 使用 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"]}
)命令行使用
# 进入技能目录
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 执行权限
🔍 故障排除
技能未显示
- 检查技能路径是否正确配置在
openclaw.json中 - 确保 OpenClaw 已重启
- 检查技能目录权限
- 运行检查命令:
npx openclaw-remote-skills check
Windows 节点连接问题
- 确认 Windows 节点已配对:
openclaw nodes status - 确认节点在线并连接
- 检查防火墙设置
agentspace 安装失败
- 确认网络连接正常
- 确认 Windows 节点上有 agentspace 配置
- 检查是否有权限写入
openclaw.json - 查看详细错误:
npx openclaw-remote-skills --verbose
🔄 更新
更新 npm 包
# 如果是全局安装
npm update -g openclaw-remote-skills
# 如果是本地安装
npm update openclaw-remote-skills
# 重新运行安装
npx openclaw-remote-skills --force手动更新
# 备份旧版本
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 # 本文档🤝 贡献
欢迎贡献代码!请遵循以下步骤:
- Fork 仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add some amazing feature') - 推送分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
📄 许可证
本项目基于 MIT 许可证开源 - 查看 LICENSE 文件了解详情。
🙏 致谢
感谢 OpenClaw 社区的支持和贡献。
📞 支持
- 问题报告: GitHub Issues
- 讨论: OpenClaw Discord
- 文档: OpenClaw Docs
提示: 安装完成后,记得重启 OpenClaw 并检查技能是否出现在可用技能列表中!
