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

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.

Install Critiqor

1. Install the package

   Install Critiqor from PyPI using pip:

   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.

2. Verify the installation

   Confirm the critiqor command is available by running either of the following:

   critiqor --help
   

   critiqor help
   

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

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:

# 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:

python -m critiqor --help