用途:OpenClaw Macro System CLI 把有价值的 GUI 工作流转换为参数化、可由命令行调用的宏。智能体不直接接触 GUI,而是通过该 CLI 调用宏,运行时将执行路由到最合适的后端(原生插件/API、文件转换、语义 UI 控制或预编译 GUI 宏回放)。
安装:cd openclaw-skill/agent-harness 后执行 pip install -e .。要求 Python 3.10+、PyYAML、click、prompt-toolkit。
主要能力:macro list 列出宏,macro info <name> 查看参数与步骤,macro run <name> --param k=v 执行,macro dry-run 模拟无副作用,macro validate 结构校验,macro define 生成新宏 YAML。session 组提供 status、history、save、list。backends 显示 native_api、file_transform、semantic_ui、gui_macro、recovery 各后端在当前环境是否可用。
用法:全局标志 --json 输出机器可读 JSON,--dry-run 模拟跳过副作用,--session-id 恢复或创建命名会话。参数用 --param key=value 重复传入。JSON 输出含 success、macro_name、output、error、telemetry(duration_ms、steps_total、steps_run、backends_used、dry_run)。失败时 success 为 false,退出码 1,需读取 error 字段。
宏编写:宏为 cli_anything/openclaw/macro_definitions/ 下的 YAML 文件,含 name、version、description、parameters、preconditions、steps(id、backend、action、params、timeout_ms、on_failure)、postconditions、outputs、agent_hints(danger_level、side_effects、reversible)。
使用规则:始终用 --json;执行有副作用宏前先 --dry-run 校验参数;检查 success 而非仅看退出码;success 为 false 时读 error;调用前用 macro info 发现参数;文件参数用绝对路径。
限制:资料未提供具体宏清单、各后端详细实现、错误码全集及性能数据。