夜雨聆风
OpenClaw配置使用自定义软件指南
OpenClaw配置使用自定义软件指南
OpenClaw 是一款开源的 AI 智能体 / 自动化框架，支持通过多种方式配置使用你自己制作的软件，以下是三种不同复杂度的方法，你可以根据自己的需求选择：
方法一：直接命令调用（最简单，无需额外配置）
这种方式适合临时启动软件，不需要提前配置，直接通过自然语言指令让 OpenClaw 执行软件的启动命令。
步骤：
1确认权限：确保 OpenClaw 已获得系统执行权限（在启动 OpenClaw 时，选择 “Full System Access” 或者在配置文件中开启相关权限）。
1发送指令：在 OpenClaw 的交互界面（如 Telegram、WebUI、飞书等）发送类似以下的指令：
1Windows 系统：执行命令：D:/你的软件路径/your-app.exe
1macOS/Linux 系统：执行命令：/home/你的用户名/your-app（注意替换为你自己软件的绝对路径）
注意事项：
1如果软件需要管理员权限，需要以管理员身份运行 OpenClaw，或者在命令前添加sudo（Linux/macOS）。
1确保软件的路径是绝对路径，避免因工作目录问题导致找不到软件。
方法二：创建简单自定义技能（适合自然语言触发，无需复杂开发）
这种方式可以让你通过自然语言指令（如 “启动我的项目管理软件”）来触发软件启动，适合日常使用。
步骤：
1找到工作区目录：
1Windows：C:\Users<你的用户名>.openclaw\workspace
1macOS/Linux：~/.openclaw/workspace
1创建技能目录： 在 workspace 目录下创建skills文件夹（如果不存在），然后在skills里创建一个新的文件夹，比如my-custom-app-skill。
1编写技能描述文件（[SKILL.md](SKILL.md)）： 在my-custom-app-skill目录下创建SKILL.md，内容如下：
|
markdown — name: 我的自定义软件启动技能 description: 启动我自己制作的软件 argument-hint: （可选，如需传递参数可填写，比如“软件的启动参数”） allowed-tools: exec — # 启动我的自定义软件 这个技能可以快速启动我自己制作的软件。 ## 用法 发送“启动我的自定义软件”即可触发，如需传递参数可以发送“启动我的自定义软件 –参数1 参数2”。 |
1编写执行逻辑（index.js）： 在my-custom-app-skill目录下创建index.js，内容如下：
|
javascript module.exports = async function({ message, tools }) { // 替换成你的软件的绝对路径 const appPath = “D:/你的软件路径/your-app.exe”; // Windows示例 // const appPath = “/home/你的用户名/your-app”; // macOS/Linux示例 // 处理参数（可选） const args = message.content.replace(/启动我的自定义软件\s*/, “”).trim(); const fullCommand = args ? `${appPath} ${args}` : appPath; try { const result = await tools.exec(fullCommand); return `已成功启动你的自定义软件，执行结果：${result}`; } catch (error) { return `启动软件失败，错误信息：${error.message}`; } }; |
1加载技能： 重启 OpenClaw，或者等待 OpenClaw 自动加载新技能（部分版本支持热加载，无需重启）。
1测试技能： 在交互界面发送 “启动我的自定义软件”，即可触发技能启动你的软件。
方法三：开发完整自定义 Skill（适合复杂场景，支持高级逻辑）
这种方式适合需要处理复杂逻辑的场景，比如需要传递复杂参数、处理软件的输出、进行错误处理等，需要基础的 JavaScript/TypeScript 开发能力。
步骤：
1初始化 Skill 项目：
|
bash # 创建技能目录 mkdir my-custom-skill cd my-custom-skill # 初始化package.json npm init -y # 安装TypeScript（可选，如使用JavaScript可跳过） npm install typescript @types/node –save-dev # 生成tsconfig.json npx tsc –init –target ES2020 –module CommonJS –outDir dist |
1编写 plugin.json（技能元信息）： 创建plugin.json文件，内容如下：
|
json { “name”: “my-custom-app-skill”, “version”: “1.0.0”, “description”: “启动并管理我自己制作的软件”, “author”: “你的名字”, “skills”: [ { “action”: “start-custom-app”, “description”: “启动我自己制作的软件”, “parameters”: [ { “name”: “appPath”, “type”: “string”, “required”: false, “default”: “D:/你的软件路径/your-app.exe”, “description”: “软件的绝对路径” }, { “name”: “args”, “type”: “string”, “required”: false, “description”: “软件的启动参数” } ], “permissions”: [ “file.exec” ] } ] } |
1编写核心执行逻辑：
1如果使用 JavaScript，创建index.js：
|
javascript const { exec } = require(‘child_process’); module.exports = { async startCustomApp({ appPath, args }) { const fullCommand = args ? `${appPath} ${args}` : appPath; return new Promise((resolve, reject) => { exec(fullCommand, (error, stdout, stderr) => { if (error) { reject(`启动失败：${error.message}`); return; } if (stderr) { resolve(`软件启动成功，标准错误输出：${stderr}`); return; } resolve(`软件启动成功，输出：${stdout}`); }); }); } }; |
1如果使用 TypeScript，创建index.ts，编译后将 dist 目录的内容放入技能目录。
1部署 Skill： 将整个my-custom-skill目录复制到 OpenClaw 的skills目录（通常位于 OpenClaw 安装目录下的skills文件夹，或者~/.openclaw/skills），然后重启 OpenClaw。
1测试 Skill： 在交互界面发送指令：执行start-custom-app，参数：{“args”: “–debug”}，即可触发技能。
通用注意事项
1权限问题：
1Windows：确保 OpenClaw 有足够的权限执行软件，必要时以管理员身份运行 OpenClaw。
1macOS/Linux：给软件添加可执行权限：chmod +x /path/to/your-app，如果需要管理员权限，在命令前添加sudo。
1路径问题：
1尽量使用绝对路径，避免因 OpenClaw 的工作目录变化导致找不到软件。
1调试技巧：
1在执行逻辑中添加日志打印，比如console.log()，可以在 OpenClaw 的启动终端中查看日志，定位问题。
1如果技能无法加载，检查技能目录的结构是否正确，是否包含必要的文件（如 [SKILL.md](SKILL.md) 或 plugin.json）。
1安全问题：
1不要给 OpenClaw 过高的权限，遵循最小权限原则，避免因安全问题导致风险。
1不要在技能中硬编码敏感信息（如密码、API 密钥），可以使用环境变量或配置文件来管理。
