返回顶部
o

openclaw-launcher爪刃发射器

|

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.1.0
安全检测
已通过
119
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

openclaw-launcher

OpenClaw Launcher

前提条件

通过Windows桌面快捷方式一键启动OpenClaw网关。

前置要求

  • - 已安装WSL2并运行Ubuntu(或其他发行版)
  • OpenClaw网关已作为systemd用户服务安装在WSL中
  • Windows PowerShell或PowerShell 7
  • 已安装PIL/Pillow的Python(用于图标转换)

架构

桌面快捷方式 (.lnk)

<用户脚本目录>\start-openclaw.bat

start-openclaw.ps1(隐藏运行,自动关闭)

WSL: systemctl start openclaw-gateway + 保活睡眠

仪表盘在浏览器中打开

路径参考

重要提示: WSL和Windows路径不同:

系统路径示例
WindowsC:\Users\<Windows用户名>\openclaw-scripts\
WSL
/mnt/c/Users//openclaw-scripts/ |
| WSL主目录 | /home// |

在WSL中操作时,使用/mnt/c/...前缀访问Windows文件。
在Windows的PowerShell中操作时,使用C:\...路径。

关于scripts/目录的说明: scripts/文件夹包含参考模板。部署时,这些模板会被复制到C:\Users\\openclaw-scripts\,并替换为实际用户名。请始终使用Python方法在用户机器上生成脚本(参见步骤3)。

分步工作流程

步骤1:收集系统信息

自动检测Windows用户名:
powershell
$WindowsUser = $env:USERNAME
Write-Host Windows用户: $WindowsUser

获取WSL发行版名称(在Windows CMD或PowerShell中):
cmd
wsl --list

获取WSL用户名(在WSL终端中):
bash
whoami

默认快捷方式名称: 询问用户或使用OpenClaw

步骤2:创建脚本目录

在Windows PowerShell中(以用户身份运行,无需管理员权限):
powershell
New-Item -ItemType Directory -Path C:\Users\\openclaw-scripts -Force

替换为实际的Windows用户名,或使用$env:USERNAME。

或者从WSL中创建:
bash
mkdir -p /mnt/c/Users//openclaw-scripts

步骤3:编写核心脚本(start-openclaw.ps1)

⚠️ 重要提示:始终使用Python(而非bash heredoc)编写.ps1文件,以避免转义问题。

需要自定义的关键变量:

  • - $WslDistro:WSL发行版名称(例如Ubuntu)
  • $WslUser:WSL用户名(来自whoami)

步骤3a:首先编写keep-alive.bat(可靠后台运行的必要条件)

python
content = @echo off\nstart /b cmd /c wsl.exe --distribution Ubuntu --user -- bash -c sleep 86400\n
with open(/mnt/c/Users//openclaw-scripts/keep-alive.bat, w, encoding=ascii) as f:
f.write(content)

步骤3b:使用Python编写start-openclaw.ps1

python
lines = [
# OpenClaw网关启动脚本(隐藏模式),
,
$wslConfig = cmd /c wsl.exe --distribution Ubuntu --user -- cat ~/.openclaw/openclaw.json 2>&1,
$tokenMatch = [regex]::Match($wslConfig, [a-f0-9]{40}),
if ($tokenMatch.Success) {,
$TOKEN = $tokenMatch.Value,
} else {,
Write-Host [错误] 无法从WSL配置中读取令牌,
exit 1,
},
$DASHBOARD_URL = http://localhost:18789/#token=$TOKEN,
,
# 获取WSL IP,
$wslIpRaw = cmd /c wsl.exe --distribution Ubuntu --user -- hostname -I 2>&1,
$wslIp = ($wslIpRaw -split )[0],
,
# 设置端口代理(需要管理员权限),
cmd /c netsh interface portproxy delete v4tov4 listenport=18789 listenaddress=127.0.0.1 2>nul,
cmd /c netsh interface portproxy add v4tov4 listenport=18789 listenaddress=127.0.0.1 connectport=18789 connectaddress=$wslIp protocol=tcp 2>nul,
,
# 检查并按需启动服务,
$status = cmd /c wsl.exe --distribution Ubuntu --user -- systemctl --user is-active openclaw-gateway 2>&1,
if ($status -ne active) {,
cmd /c wsl.exe --distribution Ubuntu --user -- systemctl --user start openclaw-gateway 2>nul,
Start-Sleep -Seconds 3,
},
,
# 通过预创建的批处理文件启动保活(比内联Start-Process更可靠),
Start-Process -FilePath cmd.exe -ArgumentList /c,C:\\Users\\\\openclaw-scripts\\keep-alive.bat -WindowStyle Hidden,
,
# 打开仪表盘,
start $DASHBOARD_URL,
]

content = \n.join(lines)
with open(/mnt/c/Users//openclaw-scripts/start-openclaw.ps1, wb) as f:
f.write(b\xef\xbb\xbf) # PowerShell的UTF-8 BOM
f.write(content.encode(utf-8))

步骤4:编写Bat启动器

powershell
$batContent = @echo off
chcp 65001 >nul
powershell -ExecutionPolicy Bypass -WindowStyle Hidden -File %~dp0start-openclaw.ps1

Set-Content -Path C:\Users\\openclaw-scripts\start-openclaw.bat -Value $batContent -Encoding ASCII

注意: .bat文件必须使用-ExecutionPolicy Bypass以允许脚本无提示运行。

步骤5:准备图标(可选)

  1. 1. 获取PNG图片(256x256或更大)
  2. 复制到Windows脚本文件夹或可访问的位置
  3. 使用WSL中的Python转换为ICO:

bash

如果PNG位于Windows路径(可从WSL访问):


python3 -c
from PIL import Image
img = Image.open(/mnt/c/Users//Desktop/icon.png)
img = img.resize((256, 256), Image.Resampling.LANCZOS)
img.save(/mnt/c/Users//openclaw-scripts/icon.ico, format=ICO)

步骤6:创建桌面快捷方式

powershell
$WshShell = New-Object -ComObject WScript.Shell
$Shortcut = $WshShell.CreateShortcut(C:\Users\\Desktop\<快捷方式名称>.lnk)
$Shortcut.TargetPath = C:\Users\\openclaw-scripts\start-openclaw.bat
$Shortcut.WorkingDirectory = C:\Users\\openclaw-scripts
$Shortcut.IconLocation = C:\Users\\openclaw-scripts\icon.ico
$Shortcut.Save()

步骤7:测试

  1. 1. 双击快捷方式
  2. 验证:无可见PowerShell窗口
  3. 验证:浏览器打开仪表盘URL
  4. 验证:网关正在运行:
bash systemctl --user is-active openclaw-gateway
  1. 5. 验证:保活进程正在运行(在WSL中):
bash ps aux | grep sleep 86400

应显示一个由您的用户拥有的sleep 86400进程。

步骤8:验证无网关正在停止问题

如果脚本运行后网关立即停止,请检查:

  1. 1. 保活进程是否正在运行?(ps aux | grep sleep)
  2. 如果未运行,Start-Process中的批处理文件路径可能错误
  3. 尝试以管理员权限运行脚本以设置端口代理

故障排除

网关已断开/网关正在停止

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 openclaw-launcher-1775933720 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 openclaw-launcher-1775933720 技能

通过命令行安装

skillhub install openclaw-launcher-1775933720

下载

⬇ 下载 openclaw-launcher v1.1.0(免费)

文件大小: 4.41 KB | 发布时间: 2026-4-12 10:50

v1.1.0 最新 2026-4-12 10:50
Fixed: Token extraction now uses [regex]::Match() for reliability. Fixed: Keep-alive now uses pre-created batch file to prevent gateway stopping. Added: Admin privilege warning for portproxy. Security: Removed hardcoded usernames.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部