Get Started

Install PicoClaw via precompiled binary, from source, or Docker. Then configure config and LLM API keys.

Quick Install (one-liner)

git clone https://github.com/sipeed/picoclaw && cd picoclaw && picoclaw onboard

Then run picoclaw agent -m "Hello" or picoclaw agent for interactive chat. See Configuration for ~/.picoclaw/config.json.

Three Steps

1. Clone

git clone https://github.com/sipeed/picoclaw.git

Or use a precompiled binary from releases.

2. Initialize

cd picoclaw && picoclaw onboard

Follow prompts for LLM API key and preferences. Edit config.json as needed.

3. Chat

picoclaw agent
# Or one-shot:
picoclaw agent -m "Hello, introduce yourself"

For bots: configure a channel and run picoclaw gateway.

System Requirements

  • Linux / macOS / Windows (WSL2 supported)
  • x86_64 / ARM64 / RISC-V
  • Memory ≥ 64MB (512MB recommended)
  • LLM API key (optional for some flows; see Providers)

Supported: macOS, Linux, Windows (WSL2), Raspberry Pi, Docker. See Download and Docker.

Core Features to Try

  • Interactive chat: picoclaw agent
  • Single message: picoclaw agent -m "Your question"
  • Gateway (Telegram, Discord, etc.): picoclaw gateway — see Integrations
  • Scheduled tasks: Heartbeat and picoclaw cron list
  • Long-term memory and skills: Workspace

Related