Clawctl CLI

Command-line interface for Clawctl — The WP Engine for AI Agents.

Installation

Via npm (Recommended)

npm install -g clawctl-cli

Via npx (No Install)

npx clawctl-cli status

Direct Download

curl -fsSL https://clawctl.com/install.sh | bash

Updating the CLI

Via npm

# Update to the latest version
npm update -g clawctl-cli

# Or force install the latest version
npm install -g clawctl-cli@latest

# Check your current version
clawctl --version

Via Direct Download

Re-run the install script to update to the latest version:

curl -fsSL https://clawctl.com/install.sh | bash

The script will overwrite the existing installation with the latest version.

Via npx

If you use npx, you always get the latest version automatically:

npx clawctl-cli@latest status

To clear the npx cache and ensure you get a fresh version:

npx --yes clawctl-cli@latest status

Configuration

Set your environment variables:

export CLAWCTL_API="https://api.clawctl.com"
export OPENCLAW_TENANT_KEY="your-api-key-here"

Add to your shell config (~/.bashrc or ~/.zshrc) for persistence:

echo 'export CLAWCTL_API="https://api.clawctl.com"' >> ~/.bashrc
echo 'export OPENCLAW_TENANT_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

Usage

# Check status, usage, and pending approvals
clawctl status

# Show tenant and plan information
clawctl whoami

# View detailed usage vs plan limits
clawctl usage

# List and manage pending approvals (Team+ plans)
clawctl approvals list
clawctl approvals approve 1
clawctl approvals deny 2

# List deployments
clawctl deployments

# Upgrade your plan
clawctl upgrade team

# Show help
clawctl help

Commands

| Command | Description | |---------|-------------| | clawctl status | Show status, usage stats, and pending approvals | | clawctl whoami | Show current tenant and plan information | | clawctl usage | Show detailed usage vs plan limits | | clawctl approvals | List and manage pending approvals (Team+) | | clawctl deployments | List recent deployments | | clawctl upgrade [plan] | Upgrade to a higher plan | | clawctl audit | Search and export audit logs (Team+) | | clawctl policies | Manage security policies (Team+) | | clawctl version | Show CLI version | | clawctl help | Show help message |

Approvals (Team+ Plans)

On Team plan and above, risky actions are held for approval instead of being blocked:

# List pending approvals
clawctl approvals list

# Approve an action
clawctl approvals approve 1

# Deny an action
clawctl approvals deny 1

On Starter plan, risky actions are blocked automatically (Safe Mode). Upgrade to enable approvals:

clawctl upgrade team

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CLAWCTL_API | Yes | API URL (e.g., https://api.clawctl.com) | | OPENCLAW_TENANT_KEY | Yes | Your tenant API key | | CLAWCTL_WEB | No | Web URL for upgrade links (default: https://clawctl.com) |

Getting Your API Key

Your API key is displayed on the success page after completing checkout at clawctl.com.

If you've lost your API key, contact [email protected].

Development

# Clone the repo
git clone https://github.com/clawctl/clawctl.git
cd clawctl/cli

# Install dependencies
npm install

# Run locally
npm start -- status

# Link for local development
npm link
clawctl status

Publishing (Maintainers)

# Bump version
npm version patch  # or minor, major

# Publish to npm
npm publish

Requirements

• Node.js 20+

License

MIT

Support

• Email: [email protected]
• Docs: https://docs.clawctl.com