WorkClaw CLI 是一个用于初始化和配置 WorkClaw 插件的命令行工具。通过一条命令即可在目标机器上完成插件的下载与安装。

安装

前置要求：Node.js >= 18.0.0、可用的 npm。

# 本地电脑安装
npx @workclaw/cli local

# 盒子设备安装
npx @workclaw/cli box

local - 本地电脑安装

面向用户的个人电脑 / 桌面端。安装时需提供手机号 + 密码。

选项

参数	说明	默认值
--env	环境（test / prod）	test
--phone	手机号（11 位）	-
--user-pass	用户密码	-
--plugin-version	锁定插件版本号（如 1.0.100）	最新版
--openclaw-path	OpenClaw 安装目录绝对路径	~/.openclaw
--model	选择模型	MiniMax-M2.5
--merge-mode	配置合并模式（merge / replace / reset-keys）	merge
--scene	场景（test / production）	production
--debug	开启调试日志	false
--print-token	安装成功后输出登录 Token	false

未传的参数会通过交互式问答补充。

示例

npx @workclaw/cli local --phone 13800000000 --user-pass your_password

box - 盒子设备安装

面向 mini 主机 / 盒子设备（专用设备 / 无人值守环境）。直接传 appKey + appSecret。

选项

参数	说明	默认值
--env	环境（test / prod）	test
--app-key	AppKey	-
--app-secret	AppSecret	-
--plugin-version	锁定插件版本号	最新版
--openclaw-path	OpenClaw 安装目录绝对路径	~/.openclaw
--model	选择模型	MiniMax-M2.5
--merge-mode	配置合并模式（merge / replace / reset-keys）	merge
--scene	场景（test / production）	production
--debug	开启调试日志	false

未传的参数会通过交互式问答补充。

示例

npx @workclaw/cli box --app-key your-app-key --app-secret your-app-secret