picoclaw-ai-assistant
picoclaw-ai-assistant — an installable skill for AI agents.
By reason-machines · 1,345 installs
npx skills add reason-machines/trending-skills --skill picoclaw-ai-assistant
Source repository · Upstream listing
PicoClaw AI Assistant
Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.
PicoClaw is an ultra lightweight personal AI assistant written in Go. It runs on $10 hardware with under 10MB RAM and boots in under 1 second. It supports multiple LLM providers (OpenAI compatible, Anthropic, Volcengine), optional web search tools, and deploys as a single self contained binary on x86 64, ARM64, MIPS, and RISC V Linux devices.
Installation
Precompiled Binary
Download from the [releases page](https://github.com/sipeed/picoclaw/releases):
Build from Source
Docker Compose
Docker: Web Console (Launcher Mode)
Docker: One shot Agent Mode
Docker: Expose Gateway to Host
If the gateway needs to be reachable from the host, set:
Or set PICOCLAW GATEWAY HOST=0.0.0.0 in docker/data/config.json .
Termux (Android)
Quick Start
1. Initialize
This creates ~/.picoclaw/config.json with a starter configuration.
2. Configure ~/.picoclaw/config.json
Never hard code API keys. Reference environment variables using $VAR NAME notation in config, or set them in your shell environment before launch.
3. Run
Key CLI Commands
Command Description
picoclaw onboard Initialize config and workspace
picoclaw Start interactive chat session
picoclaw m "..." Send a single message and exit
picoclaw model <name Override the default model
picoclaw config <path Use a custom config file
Configuration Reference
Model Entry Fields
Supported Provider Prefixes
Prefix Provider
openai/ OpenAI and OpenAI compatible APIs
anthropic/ Anthropic Claude
volcengine/ Volcengine (Ark)
Agent Defaults
Web Search Tools
Get free API keys:
Tavily : https://tavily.com — 1,000 free queries/month
Brave Search : https://brave.com/search/api — 2,000 free queries/month
Only enable one search provider at a time unless you want fallback behavior.
Common Patterns
Pattern: Minimal $10 Device Setup
For a LicheeRV Nano or similar ultra low resource board:
Pattern: Full Stack Dev Assistant with Web Search
Pattern: Docker with Environment Variables
Pattern: Build for a Specific Target in Go
Troubleshooting
Binary won't execute on device
"Permission denied" on Termux
Termux requires proot for some system calls:
API key not recognized
Do not use "api key": "sk ..." literals in config — set env vars and reference them as "$OPENAI API KEY" .
Verify the env var is exported in your current shell: echo $OPENAI API KEY .
Docker gateway not reachable from host
Set PICOCLAW GATEWAY HOST=0.0.0.0 in the environment or in config.json before starting the container.
High memory usage in recent versions
The project notes that recent PRs may push RAM usage to 10–20MB. If this is a concern on ultra low memory devices, pin to an earlier release tag:
Config file location
Default: ~/.picoclaw/config.json
Override at runtime:
Rebuild after dependency changes
Hardware Targets Quick Reference
Device Price Binary
LicheeRV Nano (E/W) ~$10 picoclaw linux riscv64
NanoKVM ~$30–50 picoclaw linux riscv64
MaixCAM / MaixCAM2 ~$50–100 picoclaw linux arm64
Raspberry Pi Zero 2 W (32 bit OS) ~$15 picoclaw linux arm
Raspberry Pi Zero 2 W (64 bit OS) ~$15 picoclaw linux arm64
Android via Termux — picoclaw linux arm64
Standard Linux x86 64 — picoclaw linux amd64