> ## Documentation Index
> Fetch the complete documentation index at: https://critiqor.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Critiqor to Monitor OpenClaw Agent Sessions

> Install Critiqor with pip on Python 3.10 to 3.13. Supports macOS, Linux, and Windows. Currently integrates with OpenClaw agents only.

Installing Critiqor gives you a CLI tool and a bundled OpenClaw plugin that together turn your OpenClaw sessions into structured runtime evidence, automated diagnosis, and a local reliability dashboard. After installation you'll have the `critiqor` command available globally and everything you need to start your first monitored session.

## Requirements

Before you install, confirm your environment meets the following:

| Requirement          | Details                                                       |
| -------------------- | ------------------------------------------------------------- |
| **Python**           | 3.10 or higher (3.10, 3.11, 3.12, and 3.13 are all supported) |
| **Operating system** | macOS, Linux, or Windows                                      |
| **Agent framework**  | OpenClaw — the only framework Critiqor currently supports     |

<Note>
  OpenClaw must be installed separately and working in your environment before Critiqor can monitor it. Critiqor launches OpenClaw internally via `openclaw chat`, so that command must be available on your PATH.
</Note>

## Install Critiqor

<Steps>
  <Step title="Install the package">
    Install Critiqor from PyPI using pip:

    ```bash theme={null}
    pip install critiqor
    ```

    This installs the `critiqor` CLI and the bundled OpenClaw plugin. No separate plugin install is needed — the plugin ships inside the package at `clawhub/critiqor-openclaw` and is attached automatically when you run `critiqor monitor openclaw`.
  </Step>

  <Step title="Verify the installation">
    Confirm the `critiqor` command is available by running either of the following:

    ```bash theme={null}
    critiqor --help
    ```

    ```bash theme={null}
    critiqor help
    ```

    You should see the list of available Critiqor commands printed to your terminal. If you see the help output, installation was successful.
  </Step>
</Steps>

## Bundled OpenClaw Plugin

Critiqor ships a lightweight OpenClaw plugin at `clawhub/critiqor-openclaw`. You do not need to install it separately — it is included in the `critiqor` package and loaded automatically when you start a monitoring session. The plugin observes OpenClaw runtime activity, normalizes events, and writes immutable raw evidence to `runs/<run_id>/session.json`. It does not score runs, generate diagnoses, or render dashboards on its own.

## Troubleshooting

**`critiqor: command not found` after installation**

Your Python `Scripts` directory (Windows) or `bin` directory (macOS/Linux) may not be on your system `PATH`. Find the location pip installed the script to and add it to your PATH:

```bash theme={null}
# macOS / Linux — find the bin directory
python3 -m site --user-base
# The critiqor script is in <output>/bin — add that to your PATH

# Windows — find the Scripts directory
py -m site --user-site
# The critiqor.exe is typically a few levels up in Scripts\
```

Alternatively, you can run Critiqor directly through Python while you sort out your PATH:

```bash theme={null}
python -m critiqor --help
```