本技能为 QClaw 环境提供 OpenClaw CLI 的受控调用入口。根据说明,当前环境没有全局安装 openclaw CLI,直接执行 openclaw 命令会失败;因此所有需要调用 openclaw CLI 的操作(包括但不限于 config、cron、skills、plugins、models、status 等)必须且只能通过本技能提供的 wrapper 脚本执行。文档明确不建议尝试全局 openclaw 命令、npx openclaw 或直接调用 node openclaw.mjs,因为脚本会自动设置所有必要的环境变量与路径。OpenClaw 服务由 QClaw Electron 守护进程管理(自动拉起、熔断保护),禁止通过 CLI 直接启停服务。
使用方式:跨平台脚本位于技能目录的 scripts/ 下,并会自动从 ~/.qclaw/qclaw.json 读取运行时路径和环境变量。macOS 使用 bash <skill_dir>/scripts/openclaw-mac.sh <command> [args...],Windows 使用 <skill_dir>\scripts\openclaw-win.cmd <command> [args...],其中 <skill_dir> 是本 SKILL.md 所在目录路径。
允许的命令按用途分为多组。config 用于配置管理,支持 config get/set/unset 点路径值,示例包括查看网关端口 config get gateway.port,以及设置默认模型 config set agents.defaults.model.primary "claude-sonnet-4-20250514";配置修改统一支持热加载,修改后自动在进程内生效。cron 用于定时任务,支持 list、add(--trigger 与 --action)、edit、enable、disable、rm、run、runs、status。models 用于模型配置,支持 list、status、set、set-image,以及 aliases、fallbacks 的帮助入口。skills 用于技能管理,支持 list、info、check。plugins 用于插件管理,支持 list、info、enable、disable、install、uninstall、doctor。agents 用于 Agent 工作区管理,支持 list、add、delete、set-identity。channels 用于通道管理,支持 list、status、capabilities、logs。gateway 仅支持只读的 gateway status,用于查看网关详细状态,不操作服务。此外还允许 status、health、doctor、security audit、memory search/status、sessions list、logs --follow、approvals get 与 approvals allowlist 帮助、update status(仅查看状态,不执行更新)。
限制方面,文档列出的禁止命令包括:gateway run/start/stop/restart、gateway install/uninstall、daemon start/stop/restart、daemon install/uninstall、node start/stop、reset、uninstall。原因是服务生命周期由 QClaw Electron 守护进程统一管理,reset 与 uninstall 属于破坏性操作,会清除本地配置、状态或卸载服务与数据。
配置修改设有两组强制规则。第一是官方 Schema 校验:先查官方文档确认字段路径、类型、可选值、约束与默认值;无法确认即拒绝修改;只允许写入官方定义字段,禁止新增未定义字段或写入类型不匹配值;确认符合 schema 后才允许执行写入;缺少依据时应明确回复“缺少 OpenClaw 官方 schema 依据,拒绝修改 openclaw.json”。第二是失败自动回滚:先备份后修改,失败即回滚到本次修改前快照,只回滚本次变更,禁止跳过回滚,回滚后必须重新读取目标配置项确认已恢复。
故障排查部分说明:若 ~/.qclaw/qclaw.json 不存在,通常意味着 QClaw 桌面应用未启动或未成功启动 OpenClaw 服务;PID 无效可能只是热加载期间状态短暂更新,可等待几秒后重新查询 status/health;若报 Gateway 连接失败,先检查 health,持续失败则执行 doctor 并收集日志,不要进行任何重启操作;若脚本报错找不到 Node 二进制或 openclaw.mjs,可能是 qclaw.json 中的路径已过期(应用升级后路径变化),应执行 status/doctor 重新校验元信息并收集日志反馈。
适用场景为在 QClaw 环境下以受控、可回滚的方式完成 OpenClaw 的日常配置与运维查询类操作。相关资料未提供收费、价格、平台支持范围与效果的进一步信息。