GoClaw CLI

A production-ready CLI for managing GoClaw AI agent gateway servers.

Features

• Full API coverage — Every dashboard feature accessible via CLI
• Dual mode — Interactive (humans) + Automation (AI agents / CI)
• Security-first — OS keyring credential storage, TLS by default, no secrets in ps
• Multiple output formats — Table, JSON, YAML
• Streaming — Real-time chat, log tailing via WebSocket
• Multi-profile — Manage multiple server connections

Installation

From Source

go install github.com/nextlevelbuilder/goclaw-cli@latest

From Release

Download the latest binary from Releases.

Quick Start

# Login with token
goclaw auth login --server https://goclaw.example.com --token your-token

# Or use device pairing
goclaw auth login --server https://goclaw.example.com --pair

# Check server health
goclaw health

# List agents
goclaw agents list

# Chat with an agent
goclaw chat myagent

# Single-shot message (automation)
goclaw chat myagent -m "What is the status?" -o json

# Pipe input
echo "Analyze this log" | goclaw chat myagent

Commands

API Keys

Create scoped, revocable API keys for CI/CD and integrations:

# Create a key with read+write scopes
goclaw api-keys create --name "ci-deploy" --scopes "operator.read,operator.write"

# Create a key with 30-day expiry
goclaw api-keys create --name "temp-access" --scopes "operator.read" --expires-in 2592000

# List all keys (raw key is only shown at creation)
goclaw api-keys list

# Revoke a key
goclaw api-keys revoke <key-id>

Available scopes: operator.admin, operator.read, operator.write, operator.approvals, operator.pairing

API Docs

# Open Swagger UI in browser
goclaw api-docs open

# Fetch OpenAPI 3.0 spec as JSON
goclaw api-docs spec -o json

Automation Mode

All commands support automation via flags:

# JSON output
goclaw agents list -o json

# Skip confirmations
goclaw agents delete abc123 -y

# Environment variables
export GOCLAW_SERVER=https://goclaw.example.com
export GOCLAW_TOKEN=your-token
goclaw agents list

Multi-Tenant

All commands support tenant context via the --tenant-id flag:

# Set tenant context for all operations
goclaw agents list --tenant-id my-tenant

# Or via environment variable
export GOCLAW_TENANT_ID=my-tenant
goclaw agents list

# Manage tenants (admin only)
goclaw tenants list
goclaw tenants create --name "My Tenant"
goclaw tenants users list <tenant-id>

Configuration

Config stored in ~/.goclaw/config.yaml:

active_profile: production
profiles:
  - name: production
    server: https://goclaw.example.com
    token: your-token
  - name: staging
    server: https://staging.goclaw.example.com
    token: staging-token

Environment variables:

Switch profiles:

goclaw auth use-context staging

Development

make build    # Build binary
make test     # Run tests
make lint     # Run go vet
make install  # Install to GOPATH/bin

License

MIT