{
  "description": "Run one headless agent turn or check OpenClaw status. Gateway, channels, plugins, onboarding and configuration commands are left out.",
  "name": "openclaw",
  "subcommands": [
    {
      "name": "agent",
      "subcommands": [
        {
          "name": "exec",
          "description": "Run one agent turn",
          "options": [
            {
              "names": [
                "--message-file"
              ],
              "description": "Read the prompt from a UTF-8 file instead.",
              "args": {
                "name": "message_file",
                "description": "Read the prompt from a UTF-8 file instead.",
                "isOptional": false,
                "template": "filepaths"
              }
            },
            {
              "names": [
                "--cwd"
              ],
              "description": "Sets both the agent workspace and the tool working directory.",
              "args": {
                "name": "cwd",
                "description": "Sets both the agent workspace and the tool working directory.",
                "isOptional": false,
                "template": "folders"
              }
            },
            {
              "names": [
                "--config"
              ],
              "description": "Config file",
              "args": {
                "name": "config",
                "isOptional": false,
                "template": "filepaths"
              }
            },
            {
              "names": [
                "--isolated"
              ],
              "description": "Ignore ambient config"
            },
            {
              "names": [
                "--model"
              ],
              "description": "provider/model.",
              "args": {
                "name": "model",
                "description": "provider/model.",
                "isOptional": false
              }
            },
            {
              "names": [
                "--fallback"
              ],
              "description": "Ordered fallbacks; requires a model.",
              "args": {
                "name": "fallback",
                "description": "Ordered fallbacks; requires a model.",
                "isOptional": false,
                "isVariadic": true
              },
              "isRepeatable": true
            },
            {
              "names": [
                "--thinking"
              ],
              "description": "Thinking level",
              "args": {
                "name": "thinking",
                "isOptional": false
              }
            },
            {
              "names": [
                "--local-model-lean"
              ],
              "description": "Lean tool surface for local models"
            },
            {
              "names": [
                "--timeout"
              ],
              "description": "Default 600; 0 disables the deadline.",
              "args": {
                "name": "timeout",
                "description": "Default 600; 0 disables the deadline.",
                "isOptional": false
              }
            },
            {
              "names": [
                "--json"
              ],
              "description": "JSON output"
            }
          ],
          "args": [
            {
              "name": "message",
              "isOptional": true
            }
          ]
        }
      ]
    },
    {
      "name": "status",
      "description": "Check status",
      "options": [
        {
          "names": [
            "--all"
          ],
          "description": "Full diagnosis"
        },
        {
          "names": [
            "--deep"
          ],
          "description": "Deep channel health checks"
        },
        {
          "names": [
            "--usage"
          ],
          "description": "Provider usage"
        },
        {
          "names": [
            "--agent"
          ],
          "description": "Agent auth/profile scope for usage.",
          "args": {
            "name": "agent",
            "description": "Agent auth/profile scope for usage.",
            "isOptional": false
          }
        },
        {
          "names": [
            "--json"
          ],
          "description": "JSON output"
        },
        {
          "names": [
            "--timeout"
          ],
          "description": "Timeout (ms)",
          "args": {
            "name": "timeout",
            "isOptional": false
          }
        }
      ]
    }
  ]
}