CLI Overview

GuardClaw provides a full-featured command-line interface for managing the safety monitor, configuring LLM backends, connecting AI agents, and inspecting evaluation results.

Installation

Global install via npm

npm install -g guardclaw

After installation, the guardclaw command is available globally.

From source

git clone https://github.com/TobyGE/GuardClaw.git
cd GuardClaw
npm install && npm install --prefix client && npm run build
npm link

Verify installation

guardclaw version
# GuardClaw v0.1.6

Command overview

Command	Description
start	Start the GuardClaw server
stop	Stop the GuardClaw server
restart	Restart the server
status	Server and agent connection overview
update	Update GuardClaw to the latest version
setup	Run the interactive setup wizard
config	Configuration management
hooks	Manage agent hook integrations
plugin	Manage the OpenClaw interceptor plugin
stats	Evaluation statistics
history	Recent evaluations
check	Manually risk-score a command
blocking	Toggle blocking mode
model	LLM model management
approvals	Show pending approvals
memory	Show learned patterns
brief	Security memory sessions
version	Print version
help	Show help

Command aliases

Several commands have shorthand aliases:

Alias	Command
rs, r	restart
log, logs	history
models	model
block	blocking
analyze	check
pending	approvals
patterns	memory
buffer	brief
wizard	setup
upgrade	update
--version, -v	version
--help, -h	help

Port configuration

By default, GuardClaw runs on port 3002. You can change this with:

# Via start flag
guardclaw start --port 4000

# Via environment variable
guardclaw config set PORT 4000

# Via .env file
echo "PORT=4000" >> .env

The CLI reads the port from GUARDCLAW_PORT, then PORT, then defaults to 3002.

Hot-reload

All configuration changes made via the CLI are applied immediately to the running server — no restart required. This includes LLM backend changes, approval mode, thresholds, tokens, and more.

Getting help

guardclaw help        # Full command reference
guardclaw --help      # Same as above
guardclaw -h          # Same as above