> ## Documentation Index
> Fetch the complete documentation index at: https://klaw.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> klaw — kubectl for AI Agents. Enterprise AI agent orchestration.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/eachlabs-cd1377a4/GtJXbRk8J0zZLxGS/logo/klaw-light.png?fit=max&auto=format&n=GtJXbRk8J0zZLxGS&q=85&s=cb891b16f9a73f61d160ae2142a76fc3" alt="klaw" width="200" data-path="logo/klaw-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/eachlabs-cd1377a4/GtJXbRk8J0zZLxGS/logo/klaw-dark.png?fit=max&auto=format&n=GtJXbRk8J0zZLxGS&q=85&s=164e07148900cfe363cff17170ff3875" alt="klaw" width="200" data-path="logo/klaw-dark.png" />
</Frame>

## What is klaw?

**klaw** is enterprise AI agent orchestration — like kubectl, but for AI agents.

```bash theme={null}
$ klaw get agents

NAME              NAMESPACE    STATUS    MODEL              LAST RUN
lead-scorer       sales        running   claude-sonnet-4    2m ago
competitor-watch  research     idle      gpt-4o             1h ago
ticket-handler    support      running   claude-sonnet-4    30s ago
```

Or control everything from Slack:

```
@klaw status
@klaw run lead-scorer
@klaw logs competitor-watch
```

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/docs/quickstart">
    Install and run your first agent in 5 minutes
  </Card>

  <Card title="Core Concepts" icon="lightbulb" href="/docs/concepts/agents">
    Understand agents, namespaces, and tools
  </Card>

  <Card title="Slack Integration" icon="slack" href="/docs/guides/slack-integration">
    Control agents from Slack
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/docs/cli-reference/overview">
    kubectl-style command reference
  </Card>
</CardGroup>

## The Problem

You're running AI agents in production:

* **Lead Scorer** — analyzes CRM leads every hour
* **Competitor Watch** — monitors competitor websites daily
* **Ticket Handler** — auto-responds to support tickets
* **Report Generator** — creates weekly analytics reports

But managing them is chaos:

| Challenge      | Current State                   | With klaw                          |
| -------------- | ------------------------------- | ---------------------------------- |
| **Visibility** | "Is the agent running?"         | `klaw get agents`, `klaw logs`     |
| **Isolation**  | Sales accessing support secrets | Namespaces with scoped permissions |
| **Scheduling** | Messy cron jobs, Lambda         | `klaw cron create` — built-in      |
| **Scaling**    | Manual server provisioning      | `klaw node join` — auto-dispatch   |
| **Debugging**  | grep through CloudWatch         | `klaw logs agent --follow`         |
| **Deployment** | Complex setup                   | Single binary, one command         |

**OpenClaw works, but deployment is painful and scaling is worse.**

klaw brings Kubernetes-style operations to AI agents. One binary. Deploys in seconds.

## The Kubernetes Parallel

If you know kubectl, you already know klaw:

| You Want To... | kubectl                | klaw                  |
| -------------- | ---------------------- | --------------------- |
| List workloads | `kubectl get pods`     | `klaw get agents`     |
| Inspect        | `kubectl describe pod` | `klaw describe agent` |
| View logs      | `kubectl logs`         | `klaw logs`           |
| Deploy         | `kubectl apply -f`     | `klaw apply -f`       |
| Isolate        | Namespaces             | Namespaces            |
| Schedule       | CronJob                | `klaw cron`           |
| Scale out      | Add nodes              | `klaw node join`      |

## Key Features

<AccordionGroup>
  <Accordion icon="terminal" title="kubectl-style CLI">
    Familiar commands: `klaw get`, `klaw describe`, `klaw logs`, `klaw apply`. If you know Kubernetes, you know klaw.
  </Accordion>

  <Accordion icon="slack" title="Slack Control">
    Manage agents from Slack. `@klaw status`, `@klaw run agent`, `@klaw logs`. Your AI command center.
  </Accordion>

  <Accordion icon="shield-halved" title="Namespaces & Isolation">
    Isolate agents by team. Sales can't access support's secrets. Each namespace has its own tools and permissions.
  </Accordion>

  <Accordion icon="clock" title="Built-in Scheduling">
    `klaw cron create` — no external scheduler needed. Run agents hourly, daily, weekly.
  </Accordion>

  <Accordion icon="server" title="Distributed Mode">
    Scale from laptop to cluster. Controller dispatches tasks to worker nodes automatically.
  </Accordion>

  <Accordion icon="microchip" title="300+ LLM Models">
    Claude, GPT-4, Gemini, Llama, and 300+ more through a single API. Swap models without code changes.
  </Accordion>

  <Accordion icon="box" title="Single Binary">
    One \~20MB binary with zero dependencies. No Python, no Node.js. Just `klaw`.
  </Accordion>
</AccordionGroup>

## Architecture Overview

```
┌────────────────────────────────────────────────────────────────────────┐
│                           KLAW CONTROL PLANE                            │
│                                                                          │
│  ┌────────────────────────────────────────────────────────────────┐    │
│  │                      NAMESPACES (Isolation)                     │    │
│  │                                                                  │    │
│  │  ┌───────────────┐  ┌───────────────┐  ┌───────────────┐       │    │
│  │  │    SALES      │  │   RESEARCH    │  │    SUPPORT    │       │    │
│  │  │               │  │               │  │               │       │    │
│  │  │ lead-scorer   │  │ competitor-   │  │ ticket-       │       │    │
│  │  │               │  │ watch         │  │ handler       │       │    │
│  │  │ tools:        │  │ tools:        │  │ tools:        │       │    │
│  │  │ • hubspot     │  │ • web_fetch   │  │ • zendesk     │       │    │
│  │  │ • clearbit    │  │ • slack       │  │ • slack       │       │    │
│  │  │               │  │               │  │               │       │    │
│  │  │ secrets:      │  │ secrets:      │  │ secrets:      │       │    │
│  │  │ HUBSPOT_KEY   │  │ SLACK_TOKEN   │  │ ZENDESK_KEY   │       │    │
│  │  └───────────────┘  └───────────────┘  └───────────────┘       │    │
│  └────────────────────────────────────────────────────────────────┘    │
│                                                                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │  SCHEDULER  │  │  CHANNELS   │  │   ROUTER    │  │    NODES    │    │
│  │  (cron)     │  │(Slack, CLI) │  │ (300+ LLMs) │  │  (workers)  │    │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘    │
└────────────────────────────────────────────────────────────────────────┘
```

## Quick Example

```bash theme={null}
# Install
curl -fsSL https://klaw.sh/install.sh | sh

# Configure
export ANTHROPIC_API_KEY=sk-ant-...

# Interactive chat
klaw chat

# Or start full platform with Slack
export SLACK_BOT_TOKEN=xoxb-...
export SLACK_APP_TOKEN=xapp-...
klaw start
```

Create a scheduled agent:

```bash theme={null}
# Create agent
klaw create agent lead-scorer \
  --namespace sales \
  --model claude-sonnet-4-20250514 \
  --skills crm,web-search

# Schedule hourly runs
klaw cron create score-leads \
  --schedule "0 * * * *" \
  --agent lead-scorer \
  --task "Analyze new HubSpot leads, score 1-100, update Lead Score field"

# Monitor
klaw get agents
klaw logs lead-scorer --follow
```

## What's Next?

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/docs/quickstart">
    Install klaw and run your first agent
  </Card>

  <Card title="Agents" icon="robot" href="/docs/concepts/agents">
    Learn how agents work
  </Card>

  <Card title="Namespaces" icon="shield" href="/docs/concepts/namespaces">
    Isolate agents by team
  </Card>

  <Card title="Slack Integration" icon="slack" href="/docs/guides/slack-integration">
    Control agents from Slack
  </Card>
</CardGroup>