ClawStation Documentation

Everything you need to deploy and configure your AI Agent Command Center.

Getting Started

Get ClawStation running in under 5 minutes.

git clone https://github.com/YOUR_USERNAME/clawstation-product.git
cd clawstation-product
npm install
cp config.example.json config.json
cp .env.example .env.local
npm run build
npm start

Open http://localhost:3000 in your browser. On first run, you'll see the Setup Wizard.

Requirements

• Node.js 20+ — Required for Next.js runtime
• OpenClaw — Installed on each agent machine
• Jira Cloud (optional) — For task board integration
• n8n (optional) — For workflow automation

Configuration

All configuration lives in config.json at the project root. Copy from config.example.json to get started.

Architecture Modes

Config Reference

Field	Type	Description
mode	string	"single" or "multi"
auth.username	string	Dashboard login username
auth.password	string	Dashboard login password
owner.name	string	Your name (shown in org chart)
jira.enabled	boolean	Enable Jira integration
jira.site	string	e.g. yourcompany.atlassian.net
jira.email	string	Jira account email
jira.apiToken	string	Jira API token
n8n.enabled	boolean	Enable n8n workflow integration
n8n.url	string	n8n instance URL
agents	array	Agent definitions (see below)
theme.primaryColor	string	Hex color for UI theme

Agent Configuration

{
  "id": "my-agent",
  "name": "Atlas",
  "title": "Lead Agent",
  "model": "Claude Opus 4.6",
  "machine": "Local",
  "ip": "127.0.0.1",
  "sshUser": "",
  "accent": "#ef4444"
}

Setup Wizard

On first launch (no config.json), ClawStation shows an interactive setup wizard at /setup that walks you through:

1. Setting your login credentials
2. Adding agents (name, model, IP, SSH config)
3. Connecting Jira (optional)
4. Connecting n8n (optional)
5. Entering your license key

The wizard writes config.json automatically. You can always edit it manually later.

Adding Agents

Each agent needs an OpenClaw instance running on the target machine. For single-machine setups, all agents share 127.0.0.1.

Multi-Machine SSH Setup

For remote agents, ensure passwordless SSH is configured:

ssh-keygen -t ed25519
ssh-copy-id user@agent-ip

Then set the agent's ip, sshHost, and sshUser in config.json.

Integrations

Jira Cloud

ClawStation syncs with Jira Cloud to display tasks on the Kanban board. To connect:

1. Go to Atlassian API Tokens
2. Create a new token
3. Add to config.json: site, email, and apiToken

n8n Workflows

Connect your n8n instance to visualize and monitor workflows:

1. Install n8n locally or via Docker
2. Set n8n.enabled: true and n8n.url in config.json

Deployment

PM2 (Recommended)

npm run build
pm2 start npm --name clawstation -- start
pm2 save

Docker

docker build -t clawstation .
docker run -p 3000:3000 -v ./config.json:/app/config.json clawstation

Cloudflare Tunnel (Remote Access)

cloudflared tunnel --url http://localhost:3000

Licensing

ClawStation requires a valid license key. Enter it in Settings → License.

License keys are verified against clawstation.dev every 24 hours. A 7-day offline grace period allows continued use if the verification server is unreachable.

API Reference

ClawStation exposes REST endpoints for dashboard data. All endpoints require authentication (except /api/metrics).

Endpoint	Method	Description
/api/agents	GET	List all agents with live status
/api/agents/test?id=X	GET	Test agent SSH connectivity
/api/metrics	GET	Current + historical metrics (no auth)
/api/crons	GET	Cron jobs across all agents
/api/jira	GET	Jira tickets for configured projects
/api/files/[agentId]	GET	File tree for an agent
/api/n8n	GET	n8n workflow status
/api/activity	GET	Recent activity feed
/api/events	GET	Calendar events
/api/settings	GET/POST	Read/update settings
/api/setup	GET/POST	First-run setup wizard
/api/license	GET/POST	License status / activate key

FAQ