Skip to main content

Install klaw

Verify:
klaw version
# klaw v1.0.0 (darwin/arm64)

Configure Your Provider

Start Chatting

klaw chat
You’ll see:
klaw v1.0.0 — kubectl for AI Agents
Model: claude-sonnet-4-20250514

> Hello! Help me understand this codebase.

I'll explore the codebase for you...

[tool: glob] Finding files...
├── cmd/
├── internal/
├── go.mod
└── README.md

This is a Go project. Let me read the main files...

Create Your First Agent

1. Create a namespace

klaw create namespace sales

2. Create an agent

klaw create agent lead-scorer \
  --namespace sales \
  --model claude-sonnet-4-20250514 \
  --skills crm,web-search

3. Check your agents

$ klaw get agents

NAME          NAMESPACE   STATUS   MODEL              LAST RUN
lead-scorer   sales       idle     claude-sonnet-4    never

4. Run the agent

klaw dispatch "Analyze the lead john@acme.com and score their fit" \
  --agent lead-scorer

5. View logs

klaw logs lead-scorer --follow

Schedule Recurring Tasks

# Run every hour
klaw cron create score-leads \
  --schedule "0 * * * *" \
  --agent lead-scorer \
  --task "Check HubSpot for new leads, score them 1-100, update Lead Score field"

# View scheduled jobs
klaw cron list

# Disable when needed
klaw cron disable score-leads

Add Slack Control

1. Set up Slack tokens

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_APP_TOKEN=xapp-...

2. Start the platform

klaw start

3. Control from Slack

@klaw status                    # List all agents
@klaw run lead-scorer           # Trigger agent
@klaw logs lead-scorer          # View logs
@klaw "score john@bigco.com"    # Quick task

What’s Next?

Agents

Learn how agents work

Namespaces

Isolate agents by team

Slack Integration

Full Slack setup guide

Distributed Mode

Scale across multiple nodes

Example Use Cases

klaw create agent lead-scorer --namespace sales --skills crm,web-search
klaw cron create hourly-scoring --schedule "0 * * * *" --agent lead-scorer \
  --task "Score new HubSpot leads 1-100 based on company size and fit"
klaw create agent competitor-watch --namespace research --skills web-fetch,slack
klaw cron create daily-check --schedule "0 9 * * *" --agent competitor-watch \
  --task "Check competitor.com/pricing for changes, post diff to #competitive-intel"
klaw create agent ticket-handler --namespace support --skills zendesk,slack
# Agent responds to @klaw mentions in Slack support channels
klaw create agent reporter --namespace analytics --skills sql,charts,slack
klaw cron create weekly-report --schedule "0 8 * * MON" --agent reporter \
  --task "Query last week's metrics, generate charts, post to #team-updates"