MyClaw CLI
为 OpenClaw 教学环境设计的一站式命令行工具。
npm install -g @aiyiran/myclaw
命令速查
| 命令 | 说明 | 平台 |
|---|---|---|
myclaw prepare | 🚀 一键初始化（推荐第一次用） | 全平台 |
myclaw open | 打开浏览器（自动带 Token） | 全平台 |
myclaw update up | 自动升级 MyClaw 到最新版（无缓存） | 全平台 |
myclaw patch | 注入 UI 扩展（语音输入等） | Mac/Linux |
myclaw unpatch | 移除 UI 扩展 | Mac/Linux |
myclaw install | 安装 OpenClaw | 全平台 |
myclaw status | 查看 Gateway / Agent 状态 | 全平台 |
myclaw new <name> | 创建新 Agent | 全平台 |
myclaw restart | 重启 Gateway | 全平台 |
myclaw bat | 生成 Windows 桌面快捷启动器 | Windows |
myclaw wsl2 | WSL2 安装向导 | Windows |
myclaw weixin | 微信绑定向导 | 全平台 |
myclaw rebind | 微信重绑向导 | 全平台 |
myclaw help | 显示帮助 | 全平台 |
核心流程
myclaw prepare — 初始化链条
自动检测环境并按需执行安装、配置、注入：
Step 1: 检测环境 (Mac / Windows / Linux / WSL)
Step 2: 检测 Chrome 浏览器
Step 3: 检测 OpenClaw → 未装则安装
Step 4: 执行 Patch（受 AUTO_PATCH 开关控制）
Step 5: [Windows] 生成桌面快捷启动器
触发方式：
- 手动运行
myclaw prepare npm install -g @aiyiran/myclaw时通过postinstall自动触发
postinstall 模式（无交互）：
- OpenClaw 已装 → 自动 patch
- OpenClaw 未装 → 跳过，提示手动安装
- 不会弹出 y/n 询问
myclaw bat — Windows 桌面启动器
生成一个 .bat 启动脚本 + 桌面快捷方式，双击即可智能启动。
快捷方式命名规则：
版本号_OpenClaw_MM-DD_HH-MM-SS.lnk
例: 1.0.46_OpenClaw_04-01_00-36-19.lnk
通过桌面图标名称可验证 prepare 是否执行过，以及执行的版本和时间。
双击后的完整流程：
Gateway 未运行:
[1/5] WSL → 检测/安装 WSL2
[2/5] OpenClaw Linux → 检测/导入 WSL 发行版
[3/5] Gateway → 未运行 → 更新 myclaw
[4/5] Patch → 注入 UI 扩展
[5/5] Browser → myclaw open（带 Token）
→ 启动 openclaw gateway（保持窗口）
Gateway 已运行:
[1/4] WSL
[2/4] OpenClaw Linux
[3/4] Gateway → 已运行
[4/4] Browser → myclaw open（带 Token）
→ 进入 WSL 终端（cd /root/.openclaw）
myclaw patch — UI 扩展注入
向 OpenClaw 的 control-ui 注入自定义功能：
myclaw-inject.js— 自定义 UI 逻辑voice-input.js— 语音输入 SDK
原理： 修改 control-ui/index.html，在 </body> 前插入 <script> 标签。
myclaw patch # 注入
myclaw unpatch # 还原
注意：每次 OpenClaw 更新后需要重新 patch（index.html 会被覆盖）。
myclaw open — 打开浏览器
自动检测 Chrome 路径，拼接 Token 打开：
http://127.0.0.1:18789?token=aiyiran
支持的 Chrome 路径：
- Mac:
/Applications/Google Chrome.app - Windows:
C:\Program Files\Google\Chrome\Application\chrome.exe - Linux:
google-chrome/chromium-browser
myclaw wsl2 — WSL2 安装向导
Windows 专用，分两阶段：
| 阶段 | 内容 |
|---|---|
| Phase 1 | 启用 WSL 功能 + 安装 WSL2（需要重启） |
| Phase 2 | 下载并导入 OpenClaw rootfs.tar |
已安装时会提示：
是否要重新安装 Linux 环境? (y/N):
配置文件
config.js
module.exports = {
TOKEN: 'aiyiran', // Gateway 认证 Token
DEFAULT_URL: 'http://127.0.0.1:18789', // 默认地址
AUTO_PATCH: true, // prepare 时是否自动 patch
};
| 配置项 | 说明 |
|---|---|
TOKEN | 所有 open 命令和 bat 启动器使用的认证令牌 |
DEFAULT_URL | Gateway 地址 |
AUTO_PATCH | true = prepare/postinstall 自动 patch；false = 跳过 |
文件结构
myclaw/
├── index.js # CLI 主入口 + 命令路由 + bat 模板
├── config.js # 全局配置（Token、URL、开关）
├── prepare.js # 初始化链条
├── patch.js # UI 扩展注入逻辑
├── wsl2.js # WSL2 安装向导
├── create_agent.js # Agent 创建
├── package.json # npm 包配置（含 postinstall）
├── publish.sh # 一键发布脚本
├── assets/
│ ├── myclaw-inject.js # 注入到 control-ui 的 JS
│ └── detect-browser.sh # Chrome 检测脚本
├── voice-input/
│ ├── index.html # 语音输入独立页
│ └── voice-input.js # 语音 SDK
└── wizards/ # 交互式向导系统
├── index.js # 向导入口
├── runner/ # 向导运行引擎
├── configs/ # 向导配置文件
├── scripts/ # Python 后端脚本
└── commons/ # 共享步骤定义
调试
查看 prepare 执行日志
prepare 运行时会写入日志文件：
- Mac/Linux:
/tmp/myclaw-prepare.log - Windows WSL:
/tmp/myclaw-prepare.log
cat /tmp/myclaw-prepare.log
示例输出：
[2026-04-01T00:30:00.000Z] === prepare start (postinstall=true, version=1.0.46)
[2026-04-01T00:30:00.100Z] Step 1: env=linux
[2026-04-01T00:30:00.200Z] Step 2: chrome=true
[2026-04-01T00:30:00.300Z] Step 3: openclaw=installed
[2026-04-01T00:30:00.400Z] Step 4: AUTO_PATCH=true, env=linux
[2026-04-01T00:30:01.000Z] Step 4: patch executed
[2026-04-01T00:30:01.100Z] === prepare end (success)
npm 缓存问题
如果 npm install -g @aiyiran/myclaw 拿到旧版本：
# 方案 1: 强制最新
npm install -g @aiyiran/myclaw@latest --prefer-online
# 方案 2: 清缓存
npm cache clean --force
npm install -g @aiyiran/myclaw
# 方案 3: 先 view 刷新元数据
npm view @aiyiran/myclaw version
npm install -g @aiyiran/myclaw
发布
cd myclaw
sh publish.sh
自动完成：git commit → 版本号 +1 → git push + tag → npm publish