cli-anything-openclaw

OpenClaw Macro System CLI

概要

OpenClaw Macro System は、価値のある GUI ワークフローをパラメーター化された CLI から呼び出し可能なマクロに変換します。エージェントはGUI を直接操作することは決してありません — エージェントはこの安定した CLI を通じてマクロを呼び出し、 ランタイムが実行を利用可能な最適なバックエンド（ネイティブプラグイン/API、ファイル変換、セマンティック UI 制御、または プリコンパイルされた GUI マクロのリプレイ）にルーティングします。

インストール

cd openclaw-skill/agent-harness
pip install -e .

要件: Python 3.10+、PyYAML、click、prompt-toolkit。

クイックスタート（エージェント向け）

# 1. See what macros are available
cli-anything-openclaw macro list --json

# 2. Inspect a macro's parameters
cli-anything-openclaw macro info export_file --json

# 3. Dry-run to check params without side effects
cli-anything-openclaw --dry-run macro run export_file \
    --param output=/tmp/test.txt --json

# 4. Execute a macro
cli-anything-openclaw macro run export_file \
    --param output=/tmp/result.txt --json

# 5. See what backends are available
cli-anything-openclaw backends --json

コマンドリファレンス

グローバルフラグ

フラグ	説明
--json	stdout に機械可読な JSON 出力
--dry-run	すべてのステップをシミュレートし、副作用をスキップ
--session-id <id>	名前付きセッションを再開または作成

macro グループ

コマンド	説明
macro list	利用可能なすべてのマクロを一覧表示
macro info <name>	マクロのスキーマ（パラメーター、ステップ、条件）を表示
macro run <name> --param k=v	マクロを実行
macro dry-run <name> --param k=v	副作用なしでシミュレート
macro validate [name]	構造の検証
macro define <name>	新しいマクロ YAML のスキャフォールドを作成

session グループ

コマンド	説明
session status	セッションの統計情報を表示
session history	最近の実行履歴を表示
session save	セッションをディスクに永続化
session list	保存されたすべてのセッションを一覧表示

backends

cli-anything-openclaw backends --json
# Shows: native_api, file_transform, semantic_ui, gui_macro, recovery
# and whether each is available in the current environment.

マクロパラメーター

--param key=value でパラメーターを渡します。複数指定する場合は繰り返します:

cli-anything-openclaw macro run transform_json \
    --param file=/path/to/data.json \
    --param key=settings.theme \
    --param value=dark \
    --json

出力形式（--json）

--json が設定されている場合、すべてのコマンドは JSON を出力します:

{
  "success": true,
  "macro_name": "export_file",
  "output": {
    "exported_file": "/tmp/result.txt"
  },
  "error": "",
  "telemetry": {
    "duration_ms": 312,
    "steps_total": 2,
    "steps_run": 2,
    "backends_used": ["native_api"],
    "dry_run": false
  }
}

失敗時（"success": false）は、"error" フィールドを読んで理由を確認してください。 失敗時の終了コードは 1 です。

実行バックエンド

バックエンドはマクロのステップ定義に基づいて自動的に選択されます:

バックエンド	トリガー条件	ユースケース
native_api	backend: native_api	サブプロセス / シェルコマンド
file_transform	backend: file_transform	XML、JSON、テキストファイルの編集
semantic_ui	backend: semantic_ui	アクセシビリティ / キーボードショートカット
gui_macro	backend: gui_macro	プリコンパイルされた座標リプレイ
recovery	backend: recovery	リトライ / フォールバックのオーケストレーション

マクロの作成

マクロは cli_anything/openclaw/macro_definitions/ にある YAML ファイルです。 次のコマンドでスキャフォールドを作成できます:

cli-anything-openclaw macro define my_macro --output \
    cli_anything/openclaw/macro_definitions/examples/my_macro.yaml

最小スキーマ:

name: my_macro
version: "1.0"
description: What this macro does.

parameters:
  output:
    type: string
    required: true
    description: Where to write results.
    example: /tmp/result.txt

preconditions:
  - file_exists: /path/to/input

steps:
  - id: step1
    backend: native_api
    action: run_command
    params:
      command: [my-app, --export, "${output}"]
    timeout_ms: 30000
    on_failure: fail  # or: skip, continue

postconditions:
  - file_exists: ${output}
  - file_size_gt: [${output}, 100]

outputs:
  - name: result_file
    path: ${output}

agent_hints:
  danger_level: safe  # safe | moderate | dangerous
  side_effects: [creates_file]
  reversible: true

エージェントの使用ルール

1. プログラムによる出力には常に --json を使用する。
2. 副作用のあるマクロを実行する前に、--dry-run でパラメーターを検証する。
3. success フィールドを確認する — 終了コードだけで成功と判断しないこと。
4. success が false の場合は error フィールドを読む — 何が失敗したかが説明されています。
5. macro run を呼び出す前に macro info <name> でパラメーターを確認する。
6. すべてのファイルパラメーターには絶対パスを使用する。

ワークフローの例

# Step 1: What's available?
cli-anything-openclaw macro list --json

# Step 2: What params does transform_json need?
cli-anything-openclaw macro info transform_json --json

# Step 3: Test safely
cli-anything-openclaw --dry-run macro run transform_json \
    --param file=/tmp/config.json \
    --param key=theme \
    --param value=dark --json

# Step 4: Execute for real
cli-anything-openclaw macro run transform_json \
    --param file=/tmp/config.json \
    --param key=theme \
    --param value=dark --json

バージョン

1.0.0