🦞 ClawClaw

Lightweight Soul Spec agent runtime. Runs in browsers, WebContainers, and Node.js.

Install

npm install clawclaw

CLI Usage

# In a directory with SOUL.md, IDENTITY.md, AGENTS.md
export CLAWCLAW_API_KEY=your-key
npx clawclaw

# Or with flags
npx clawclaw --provider anthropic --model claude-sonnet-4-6 --api-key sk-xxx

Programmatic Usage

import { loadSoulPackage, buildSystemPrompt, chat } from 'clawclaw';

const pkg = loadSoulPackage('./my-agent');
const prompt = buildSystemPrompt(pkg);
const response = await chat(
  { provider: 'anthropic', apiKey: 'sk-xxx', model: 'claude-sonnet-4-6' },
  [{ role: 'system', content: prompt }, { role: 'user', content: 'Hello!' }]
);

Providers

| Provider | Env Var | Default Model | |----------|---------|---------------| | OpenRouter | CLAWCLAW_API_KEY | openrouter/auto | | Anthropic | CLAWCLAW_API_KEY | claude-sonnet-4-6 | | OpenAI | CLAWCLAW_API_KEY | gpt-4o | | Gemini | CLAWCLAW_API_KEY | gemini-2.5-flash | | Ollama | (none needed) | llama3.2 |

Features

• Zero runtime dependencies
• WebContainer compatible (no native addons)
• 5 LLM providers with streaming
• Soul Spec file loading
• Interactive CLI with colored output
• ~100KB package size

License

Apache-2.0