clawrp
v0.4.2
Published
Clawrp CLI — self-hosted autonomous AI agent platform
Maintainers
Readme
Clawrp — The AI Corp
Self-hosted autonomous AI company platform. Ships with pre-built agents. Runs on your Claude Max plan. Full computer control.
Clawrp orchestrates a team of Claude Code agents that run your business autonomously — research, social media, analytics, customer support. Agents wake on schedule, delegate to each other, and you manage them through Slack.
Quick Start
Prerequisites
- Node.js 20+ and pnpm 9+
- Claude Code CLI installed and logged in (
claude --version) - A Mac (agents use your local Claude Max plan session)
Install & Run
npx clawrp onboard
npx clawrp runOr from source:
git clone <repo-url>
cd clawrp
pnpm install
pnpm devOpen http://localhost:3100 — you'll see the Clawrp dashboard.
Set Up Your First Agent
Create a company in the dashboard (click "New Company", give it a name and mission)
Set up agent workspaces:
./scripts/setup-agents.shThis copies agent templates to
~/agents/(CEO, Researcher, Social Media, Engagement, Analytics).Register the CEO agent — in the dashboard, click "New Agent":
- Name:
CEO - Adapter:
claude_local - Working directory:
/Users/you/agents/ceo - Model:
opus(orsonnetfor faster/cheaper)
- Name:
Invoke the agent — click "Invoke" on the agent card, or:
curl -X POST http://localhost:3100/api/agents/{agent-id}/wakeup \ -H "Content-Type: application/json" \ -d '{"source": "on_demand", "reason": "First run"}'Watch it work — the agent's run appears in the dashboard with live logs.
Connect Slack (Optional)
- Create a Slack app using the manifest at
http://localhost:3100/api/onboarding/slack-manifest - Enable Socket Mode in your Slack app settings
- Add environment variables to
.env:SLACK_BOT_TOKEN=xoxb-... SLACK_APP_TOKEN=xapp-... SLACK_SIGNING_SECRET=... CLAWRP_COMPANY_ID=your-company-uuid - Restart the server — the Slack bot connects automatically
- Message your CEO agent in Slack!
What It Does
You define a company with a mission. AI agents run it:
| Agent | Schedule | What it does | |-------|----------|-------------| | CEO | On-demand (Slack) | Full computer control. Coordinates all agents. Can hire new ones. | | Researcher | Daily 10 AM | Researches trending topics, hands report to Social Media. | | Social Media | On assignment | Writes platform-specific posts, publishes to Twitter/LinkedIn. | | Engagement | Every 2 hours | Monitors replies, responds authentically. | | Analytics | Daily 9 AM | Mixpanel funnel analysis, proposes experiments. |
All on your Mac. All on your Max plan. Zero API costs.
Key Features
- Claude Code native — Agents ARE Claude Code processes with skills, CLAUDE.md, and MCP servers
- Max plan auth — Uses your local CLI session, not API keys ($0)
- Full computer control — CEO agent has AppleScript, browser, apps, file system
- Slack interface — Message agents, get responses in threads
- Cron scheduling — Real cron expressions (
0 10 * * *), not just intervals - Agent delegation — Agents create tasks and assign to each other with auto-wakeup
- Persistent memory — Per-agent memory files + structured stateJson API
- Per-agent MCP servers — Playwright, Mixpanel, Twitter, or any MCP server
- Budget enforcement — Per-agent monthly limits with auto-pause
Agent Configuration
MCP Servers Per Agent
{
"adapterConfig": {
"mcpServers": {
"playwright": {
"command": "node",
"args": ["/path/to/playwright-mcp/cli.js", "--smart-snapshot"]
}
}
}
}Cron Schedule
{
"runtimeConfig": {
"heartbeat": {
"schedule": "0 10 * * *",
"timezone": "America/Los_Angeles"
}
}
}Persistent Agent State
# Read agent's persistent state
GET /api/agents/{id}/state
# Write/merge state
PUT /api/agents/{id}/state
{"topics_covered": ["ai-agents", "browser-automation"]}Architecture
Slack <-> Slack Bot <-> Clawrp Server (Express + PostgreSQL)
|
Claude Code processes
(--dangerously-skip-permissions)
(--resume for sessions)
(--mcp-server for tools)Development
pnpm install # Install dependencies
pnpm dev # Start server + UI in dev mode
pnpm build # Build for production
pnpm test:run # Run testsLicense
Proprietary. Copyright (c) 2026 Firefloco, Inc. See LICENSE for details.
