What Changed from NanoClaw

NanoPieLot is a full port of NanoClaw from Anthropic/Claude to the GitHub Copilot SDK:

• Any Copilot model. /model list to see what's available, /model <id> to switch. GPT-4.1, Claude, Gemini — whatever your GitHub plan gives you.
• Same architecture. Everything else works exactly like NanoClaw: containers, channels, skills, groups, scheduling.
• Authentication via copilot login device flow.

Quick Start

gh repo fork trsdn/nanopielot --clone
cd nanopielot
copilot

Then run /setup.

Commands prefixed with / (like /setup, /add-whatsapp) are CLI agent skills. Type them inside the copilot prompt, not in your regular terminal.

Requirements

• macOS, Linux, or Windows (via WSL2)
• Node.js 20+
• GitHub Copilot CLI
• Apple Container (macOS) or Docker (macOS/Linux)

Migration from NanoClaw

If you are migrating an existing NanoClaw setup or maintaining a fork, read the NanoPieLot-specific migration notes in docs/MIGRATION.md.

Troubleshooting

For common NanoPieLot-specific deployment and runtime problems, see docs/TROUBLESHOOTING.md.

Architecture

Channels → SQLite → Polling loop → Container (GitHub Copilot SDK) → Response

Single Node.js process. Channels self-register at startup. Agents run in isolated Linux containers. Per-group message queue with concurrency control.

Contributing Workflow

For issue-driven work, create a dedicated branch and merge via pull request. Avoid developing feature or issue work directly on main.

Special Thanks

NanoPieLot wouldn't exist without NanoClaw. The original project's philosophy, architecture, and skill system are the foundation of everything here. We just swapped the engine. 🥧

Forked from upstream commit a3fb3be (2026-03-28).

License

MIT — see LICENSE