| name | qclaw-openclaw |
| description | [MANDATORY] 本环境没有全局 openclaw CLI。任何需要执行 openclaw 命令的场景（配置管理、
定时任务、模型设置、Skills/Plugins 管理等）都必须通过本 skill 提供的脚本执行。
禁止直接调用 `openclaw` 命令，禁止执行服务管理命令（gateway/daemon），
OpenClaw 服务由 QClaw Electron 守护进程管理。
|
| metadata | {"openclaw":{"emoji":"⚙️"}} |
QClaw OpenClaw CLI
MANDATORY — 必读
本环境没有全局安装 openclaw CLI。 直接执行 openclaw 命令会失败。
所有需要调用 openclaw CLI 的操作（包括但不限于 config、cron、skills、plugins、models、status 等），
必须且只能通过本 skill 提供的 wrapper 脚本执行。不要尝试：
- ❌
openclaw config get ...（全局命令不存在）
- ❌
npx openclaw ...（环境变量不正确）
- ❌ 直接调用
node openclaw.mjs ...（缺少必要的环境变量和路径）
正确做法是使用本 skill 的脚本，它会自动设置所有必要的环境变量和路径。
OpenClaw 服务由 QClaw Electron 守护进程管理（自动拉起、熔断保护），禁止通过 CLI 直接启停服务。
执行方式
本 skill 提供跨平台脚本，位于 skill 目录的 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 — 配置管理
bash <skill_dir>/scripts/openclaw-mac.sh config get <dot.path>
bash <skill_dir>/scripts/openclaw-mac.sh config set <dot.path> <value>
bash <skill_dir>/scripts/openclaw-mac.sh config unset <dot.path>
示例:
bash <skill_dir>/scripts/openclaw-mac.sh config get gateway.port
bash <skill_dir>/scripts/openclaw-mac.sh config set agents.defaults.model.primary "claude-sonnet-4-20250514"
配置生效规则：OpenClaw 的配置修改统一支持热加载，修改后自动在进程内生效。
严禁执行任何服务重启行为（包括但不限于 gateway/daemon restart、kill PID、taskkill）。
[MANDATORY] 修改前官方 Schema 校验规则
对所有会修改 openclaw.json 的操作，必须先完成官方文档校验：
- 先查官方文档：修改前必须先查询 OpenClaw 官方文档中对应配置项（字段路径、类型、可选值、约束、默认值）。
- 无法确认即拒绝：若未找到对应官方文档，或无法确认该字段符合官方 schema，必须拒绝本次修改，不得猜测字段或试错写入。
- 只允许写入官方定义字段：禁止新增或写入官方 schema 未定义字段，禁止写入类型不匹配值。
- 先确认再落盘：只有在确认变更符合官方 schema 后，才允许执行
config set/unset 或其他写入操作。
拒绝话术要求：当缺少官方 schema 依据时，明确回复“缺少 OpenClaw 官方 schema 依据，拒绝修改 openclaw.json”。
[MANDATORY] 配置修改失败自动回滚规则
对所有修改 openclaw.json 配置文件的操作，必须遵循以下事务化规则：
- 先备份后修改：执行修改前，先保存
openclaw.json 的修改前快照（仅用于本次变更回滚）。
- 失败即回滚：如果上下文日志/执行结果显示本次修改失败（无论失败原因），必须立即回滚到本次修改前快照。
- 只回滚本次变更：回滚目标是撤销当前这一次修改，不得覆盖更早的历史有效配置。
- 禁止跳过回滚：检测到失败后，不允许继续后续配置写入，必须先完成回滚再继续。
- 回滚后复核：回滚完成后，必须重新读取目标配置项，确认已恢复到修改前状态。
cron — 定时任务
bash <skill_dir>/scripts/openclaw-mac.sh cron list
bash <skill_dir>/scripts/openclaw-mac.sh cron add --trigger "<cron_expression>" --action "<prompt>"
bash <skill_dir>/scripts/openclaw-mac.sh cron edit <job_id> --trigger "<cron_expression>"
bash <skill_dir>/scripts/openclaw-mac.sh cron enable <job_id>
bash <skill_dir>/scripts/openclaw-mac.sh cron disable <job_id>
bash <skill_dir>/scripts/openclaw-mac.sh cron rm <job_id>
bash <skill_dir>/scripts/openclaw-mac.sh cron run <job_id>
bash <skill_dir>/scripts/openclaw-mac.sh cron runs
bash <skill_dir>/scripts/openclaw-mac.sh cron status
models — 模型配置
bash <skill_dir>/scripts/openclaw-mac.sh models list
bash <skill_dir>/scripts/openclaw-mac.sh models status
bash <skill_dir>/scripts/openclaw-mac.sh models set <model_id>
bash <skill_dir>/scripts/openclaw-mac.sh models set-image <model_id>
bash <skill_dir>/scripts/openclaw-mac.sh models aliases --help
bash <skill_dir>/scripts/openclaw-mac.sh models fallbacks --help
skills — Skills 管理
bash <skill_dir>/scripts/openclaw-mac.sh skills list
bash <skill_dir>/scripts/openclaw-mac.sh skills info <skill_name>
bash <skill_dir>/scripts/openclaw-mac.sh skills check
plugins — 插件管理
bash <skill_dir>/scripts/openclaw-mac.sh plugins list
bash <skill_dir>/scripts/openclaw-mac.sh plugins info <plugin_id>
bash <skill_dir>/scripts/openclaw-mac.sh plugins enable <plugin_id>
bash <skill_dir>/scripts/openclaw-mac.sh plugins disable <plugin_id>
bash <skill_dir>/scripts/openclaw-mac.sh plugins install <path_or_spec>
bash <skill_dir>/scripts/openclaw-mac.sh plugins uninstall <plugin_id>
bash <skill_dir>/scripts/openclaw-mac.sh plugins doctor
agents — Agent 工作区管理
bash <skill_dir>/scripts/openclaw-mac.sh agents list
bash <skill_dir>/scripts/openclaw-mac.sh agents add <name>
bash <skill_dir>/scripts/openclaw-mac.sh agents delete <name>
bash <skill_dir>/scripts/openclaw-mac.sh agents set-identity <name> --emoji "🤖"
channels — 通道管理
bash <skill_dir>/scripts/openclaw-mac.sh channels list
bash <skill_dir>/scripts/openclaw-mac.sh channels status
bash <skill_dir>/scripts/openclaw-mac.sh channels capabilities
bash <skill_dir>/scripts/openclaw-mac.sh channels logs
gateway — 网关状态查询（只读）
bash <skill_dir>/scripts/openclaw-mac.sh gateway status
其他允许的命令
bash <skill_dir>/scripts/openclaw-mac.sh status
bash <skill_dir>/scripts/openclaw-mac.sh health
bash <skill_dir>/scripts/openclaw-mac.sh doctor
bash <skill_dir>/scripts/openclaw-mac.sh security audit
bash <skill_dir>/scripts/openclaw-mac.sh memory search <query>
bash <skill_dir>/scripts/openclaw-mac.sh memory status
bash <skill_dir>/scripts/openclaw-mac.sh sessions list
bash <skill_dir>/scripts/openclaw-mac.sh logs --follow
bash <skill_dir>/scripts/openclaw-mac.sh approvals get
bash <skill_dir>/scripts/openclaw-mac.sh approvals allowlist --help
bash <skill_dir>/scripts/openclaw-mac.sh update status
禁止的命令
以下命令绝对禁止执行，OpenClaw 服务生命周期由 QClaw Electron 守护进程统一管理：
| 命令 | 原因 |
|---|
gateway run/start/stop/restart | 服务由 Electron ProcessSupervisor 管理 |
gateway install/uninstall | 系统服务安装由 Electron 控制 |
注意: gateway status 是允许的，它只是查询状态，不操作服务。
| daemon start/stop/restart | 同上，daemon 是 gateway 的别名 |
| daemon install/uninstall | 同上 |
| node start/stop | Node host 服务管理 |
| reset | 破坏性操作，会清除所有本地配置和状态 |
| uninstall | 破坏性操作，会卸载服务和数据 |
配置热加载与进程内生效
OpenClaw 的配置修改统一采用热加载机制：
- 通过本 skill 执行
config set/unset 后，无需重启服务
- 配置会自动在当前进程内重载并生效
- 禁止任何形式的服务重启操作（包括
gateway/daemon restart、kill、taskkill）
如配置未即时体现，请先用只读命令核对当前状态：
bash <skill_dir>/scripts/openclaw-mac.sh config get <dot.path>
bash <skill_dir>/scripts/openclaw-mac.sh status
bash <skill_dir>/scripts/openclaw-mac.sh health
故障排查
~/.qclaw/qclaw.json 不存在
QClaw 桌面应用未启动或未成功启动 OpenClaw 服务。请先启动 QClaw 应用。
PID 无效（进程不存在）
配置热加载过程中状态可能短暂更新。等待几秒后重新查询 status/health 即可。
命令执行报 Gateway 连接失败
Gateway 服务可能未就绪。先检查健康状态：
bash <skill_dir>/scripts/openclaw-mac.sh health
如果持续失败，执行 doctor 并收集日志，不要进行任何重启操作。
脚本报错找不到 Node 二进制或 openclaw.mjs
qclaw.json 中的路径可能已过期（应用升级后路径变化）。请执行 status/doctor 重新校验元信息并收集日志反馈。
