{"id":44494135,"url":"https://github.com/sipeed/picoclaw","last_synced_at":"2026-06-13T03:11:36.339Z","repository":{"id":337578384,"uuid":"1149707767","full_name":"sipeed/picoclaw","owner":"sipeed","description":"Tiny, Fast, and Deployable anywhere — automate the mundane, unleash your creativity","archived":false,"fork":false,"pushed_at":"2026-05-28T01:03:33.000Z","size":39162,"stargazers_count":29203,"open_issues_count":90,"forks_count":4181,"subscribers_count":143,"default_branch":"main","last_synced_at":"2026-05-28T03:23:49.310Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://picoclaw.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sipeed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security/ANTIGRAVITY_AUTH.fr.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-04T12:32:35.000Z","updated_at":"2026-05-28T03:12:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"d5ed5d92-5028-48ea-bc58-7299447aad04","html_url":"https://github.com/sipeed/picoclaw","commit_stats":null,"previous_names":["sipeed/picoclaw"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/sipeed/picoclaw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipeed%2Fpicoclaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipeed%2Fpicoclaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipeed%2Fpicoclaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipeed%2Fpicoclaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sipeed","download_url":"https://codeload.github.com/sipeed/picoclaw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipeed%2Fpicoclaw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33678271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-13T05:00:20.133Z","updated_at":"2026-06-13T03:11:36.332Z","avatar_url":"https://github.com/sipeed.png","language":"Go","funding_links":[],"categories":["🗂️ Projects","Go","Personal Assistants","框架与衍生项目","Setup Methods (1-10 Minutes)","Main Projects","Lightweight Alternatives \u0026 Forks","By Category","Alternative Architekturen","Uncategorized","Catalog","Lightweight \u0026 Embedded Claws","OpenClaw Rewrites \u0026 Alternatives","Terminal-native coding agents","⚡ Alternative Clients \u0026 Runtimes"],"sub_categories":["📋 Project Overview","Recommended","Embedded / Edge","Uncategorized","OpenClaw Forks","Comparison Table","OpenClaw ecosystem"],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"assets/logo.webp\" alt=\"PicoClaw\" width=\"512\"\u003e\n\n\u003ch1\u003ePicoClaw: Ultra-Efficient AI Assistant in Go\u003c/h1\u003e\n\n\u003ch3\u003e$10 Hardware · 10MB RAM · ms Boot · Let's Go, PicoClaw!\u003c/h3\u003e\n  \u003cp\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat\u0026logo=go\u0026logoColor=white\" alt=\"Go\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Arch-x86__64%2C%20ARM64%2C%20MIPS%2C%20RISC--V%2C%20LoongArch-blue\" alt=\"Hardware\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"License\"\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://picoclaw.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/Website-picoclaw.io-blue?style=flat\u0026logo=google-chrome\u0026logoColor=white\" alt=\"Website\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://docs.picoclaw.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Docs-Official-007acc?style=flat\u0026logo=read-the-docs\u0026logoColor=white\" alt=\"Docs\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://deepwiki.com/sipeed/picoclaw\"\u003e\u003cimg src=\"https://img.shields.io/badge/Wiki-DeepWiki-FFA500?style=flat\u0026logo=wikipedia\u0026logoColor=white\" alt=\"Wiki\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://x.com/SipeedIO\"\u003e\u003cimg src=\"https://img.shields.io/badge/X_(Twitter)-SipeedIO-black?style=flat\u0026logo=x\u0026logoColor=white\" alt=\"Twitter\"\u003e\u003c/a\u003e\n    \u003ca href=\"./assets/wechat.png\"\u003e\u003cimg src=\"https://img.shields.io/badge/WeChat-Group-41d56b?style=flat\u0026logo=wechat\u0026logoColor=white\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://discord.gg/V4sAZ9XWpN\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord-Community-4c60eb?style=flat\u0026logo=discord\u0026logoColor=white\" alt=\"Discord\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n[中文](docs/project/README.zh.md) | [日本語](docs/project/README.ja.md) | [한국어](docs/project/README.ko.md) | [Português](docs/project/README.pt-br.md) | [Tiếng Việt](docs/project/README.vi.md) | [Français](docs/project/README.fr.md) | [Italiano](docs/project/README.it.md) | [Bahasa Indonesia](docs/project/README.id.md) | [Malay](docs/project/README.ms.md) | **English**\n\n\u003c/div\u003e\n\n---\n\n\u003e **PicoClaw** is an independent open-source project initiated by [Sipeed](https://sipeed.com), written entirely in **Go** from scratch — not a fork of OpenClaw, NanoBot, or any other project.\n\n**PicoClaw** is an ultra-lightweight personal AI assistant inspired by [NanoBot](https://github.com/HKUDS/nanobot). It was rebuilt from the ground up in **Go** through a \"self-bootstrapping\" process — the AI Agent itself drove the architecture migration and code optimization.\n\n**Runs on $10 hardware with \u003c10MB RAM** — that's 99% less memory than OpenClaw and 98% cheaper than a Mac mini!\n\n\u003ctable align=\"center\"\u003e\n\u003ctr align=\"center\"\u003e\n\u003ctd align=\"center\" valign=\"top\"\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/picoclaw_mem.gif\" width=\"360\" height=\"240\"\u003e\n\u003c/p\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" valign=\"top\"\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/licheervnano.png\" width=\"400\" height=\"240\"\u003e\n\u003c/p\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003e [!CAUTION]\n\u003e **Security Notice**\n\u003e\n\u003e * **NO CRYPTO:** PicoClaw has **not** issued any official tokens or cryptocurrency. All claims on `pump.fun` or other trading platforms are **scams**.\n\u003e * **OFFICIAL DOMAIN:** The **ONLY** official website is **[picoclaw.io](https://picoclaw.io)**, and company website is **[sipeed.com](https://sipeed.com)**\n\u003e * **BEWARE:** Many `.ai/.org/.com/.net/...` domains have been registered by third parties. Do not trust them.\n\u003e * **NOTE:** PicoClaw is in early rapid development. There may be unresolved security issues. Do not deploy to production before v1.0.\n\u003e * **NOTE:** PicoClaw has recently merged many PRs. Recent builds may use 10-20MB RAM. Resource optimization is planned after feature stabilization.\n\n## 📢 News\n\n2026-05-11 🛒 **LicheeRV-Claw on AliExpress!** You can now purchase LicheeRV-Claw from [AliExpress](https://www.aliexpress.com/item/1005006519668532.html), making it easier to try PicoClaw on compact RISC-V hardware.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.aliexpress.com/item/1005006519668532.html\"\u003e\n    \u003cimg src=\"assets/licheerv-claw.jpg\" alt=\"LicheeRV-Claw on AliExpress\" width=\"520\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n2026-05-28 🚀 **v0.2.9 Released!** MCP server management in Web UI, configurable Sogou-backed web search, tool feedback animation in channels, `pretty_print` and `disable_escape_html` defaults, and numerous bug fixes across providers and channels.\n\n2026-05-14 🚀 **v0.2.8 Released!** MCP CLI commands (`show`, `add`, `list`, `remove`, `test`, `edit`), empty object instead of null for MCP tool parameters, and build fixes.\n\n2026-05-07 🚀 **v0.2.7 Released!** Configurable Sogou-backed web search, channel tool feedback animation, linter fixes.\n\n2026-04-23 🚀 **v0.2.6 Released!** Hooks with respond action and comprehensive documentation, isolation support, help banner fix.\n\n2026-04-11 🚀 **v0.2.5 Released!** Zoneinfo from TZ/ZONEINFO env, Matrix CommonMark rendering alignment, `read_file` by lines.\n\n2026-03-31 📱 **Android Support!** PicoClaw now runs on Android! Download the APK at [picoclaw.io](https://picoclaw.io/download)\n\n2026-03-25 🚀 **v0.2.4 Released!** Agent architecture overhaul (SubTurn, Hooks, Steering, EventBus), WeChat/WeCom integration, security hardening (.security.yml, sensitive data filtering), new providers (AWS Bedrock, Azure, Xiaomi MiMo), and 35 bug fixes. PicoClaw has reached **26K Stars**!\n\n2026-03-17 🚀 **v0.2.3 Released!** System tray UI (Windows \u0026 Linux), sub-agent status query (`spawn_status`), experimental Gateway hot-reload, Cron security gating, and 2 security fixes. PicoClaw has reached **25K Stars**!\n\n2026-03-09 🎉 **v0.2.1 — Biggest update yet!** MCP protocol support, 4 new channels (Matrix/IRC/WeCom/Discord Proxy), 3 new providers (Kimi/Minimax/Avian), vision pipeline, JSONL memory store, model routing.\n\n2026-02-28 📦 **v0.2.0** released with Docker Compose and Web UI Launcher support.\n\n\u003cdetails\u003e\n\u003csummary\u003eEarlier news...\u003c/summary\u003e\n\n2026-02-26 🎉 PicoClaw hits **20K Stars** in just 17 days! Channel auto-orchestration and capability interfaces are live.\n\n2026-02-16 🎉 PicoClaw breaks 12K Stars in one week! Community maintainer roles and [Roadmap](ROADMAP.md) officially launched.\n\n2026-02-13 🎉 PicoClaw breaks 5000 Stars in 4 days! Project roadmap and developer groups in progress.\n\n2026-02-09 🎉 **PicoClaw Released!** Built in 1 day to bring AI Agents to $10 hardware with \u003c10MB RAM. Let's Go, PicoClaw!\n\n\u003c/details\u003e\n\n## ✨ Features\n\n🪶 **Ultra-lightweight**: Core memory footprint \u003c10MB — 99% smaller than OpenClaw.*\n\n💰 **Minimal cost**: Efficient enough to run on $10 hardware — 98% cheaper than a Mac mini.\n\n⚡️ **Lightning-fast boot**: 400x faster startup. Boots in \u003c1s even on a 0.6GHz single-core processor.\n\n🌍 **Truly portable**: Single binary across RISC-V, ARM, MIPS, and x86 architectures. One binary, runs everywhere!\n\n🤖 **AI-bootstrapped**: Pure Go native implementation — 95% of core code was generated by an Agent and fine-tuned through human-in-the-loop review.\n\n🔌 **MCP support**: Native [Model Context Protocol](https://modelcontextprotocol.io/) integration — connect any MCP server to extend Agent capabilities.\n\n👁️ **Vision pipeline**: Send images and files directly to the Agent — automatic base64 encoding for multimodal LLMs.\n\n🧠 **Smart routing**: Rule-based model routing — simple queries go to lightweight models, saving API costs.\n\n_*Recent builds may use 10-20MB due to rapid PR merges. Resource optimization is planned. Boot speed comparison based on 0.8GHz single-core benchmarks (see table below)._\n\n\u003cdiv align=\"center\"\u003e\n\n|                                | OpenClaw      | NanoBot                  | **PicoClaw**                           |\n| ------------------------------ | ------------- | ------------------------ | -------------------------------------- |\n| **Language**                   | TypeScript    | Python                   | **Go**                                 |\n| **RAM**                        | \u003e1GB          | \u003e100MB                   | **\u003c 10MB***                            |\n| **Boot time**\u003c/br\u003e(0.8GHz core) | \u003e500s         | \u003e30s                     | **\u003c1s**                                |\n| **Cost**                       | Mac Mini $599 | Most Linux boards ~$50   | **Any Linux board**\u003c/br\u003e**from $10**   |\n\n\u003cimg src=\"assets/compare.jpg\" alt=\"PicoClaw\" width=\"512\"\u003e\n\n\u003c/div\u003e\n\n\u003e **[Hardware Compatibility List](docs/guides/hardware-compatibility.md)** — See all tested boards, from $5 RISC-V to Raspberry Pi to Android phones. Your board not listed? Submit a PR!\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/hardware-banner.jpg\" alt=\"PicoClaw Hardware Compatibility\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n## 🦾 Demonstration\n\n### 🛠️ Standard Assistant Workflows\n\n\u003ctable align=\"center\"\u003e\n\u003ctr align=\"center\"\u003e\n\u003cth\u003e\u003cp align=\"center\"\u003eFull-Stack Engineer Mode\u003c/p\u003e\u003c/th\u003e\n\u003cth\u003e\u003cp align=\"center\"\u003eLogging \u0026 Planning\u003c/p\u003e\u003c/th\u003e\n\u003cth\u003e\u003cp align=\"center\"\u003eWeb Search \u0026 Learning\u003c/p\u003e\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\u003cp align=\"center\"\u003e\u003cimg src=\"assets/picoclaw_code.gif\" width=\"240\" height=\"180\"\u003e\u003c/p\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cp align=\"center\"\u003e\u003cimg src=\"assets/picoclaw_memory.gif\" width=\"240\" height=\"180\"\u003e\u003c/p\u003e\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\u003cp align=\"center\"\u003e\u003cimg src=\"assets/picoclaw_search.gif\" width=\"240\" height=\"180\"\u003e\u003c/p\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003eDevelop · Deploy · Scale\u003c/td\u003e\n\u003ctd align=\"center\"\u003eSchedule · Automate · Remember\u003c/td\u003e\n\u003ctd align=\"center\"\u003eDiscover · Insights · Trends\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🐜 Innovative Low-Footprint Deployment\n\nPicoClaw can be deployed on virtually any Linux device!\n\n- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) E(Ethernet) or W(WiFi6) edition, for a minimal home assistant\n- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), or $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html), for automated server operations\n- $50 [MaixCAM](https://www.aliexpress.com/item/1005008053333693.html) or $100 [MaixCAM2](https://www.kickstarter.com/projects/zepan/maixcam2-build-your-next-gen-4k-ai-camera), for smart surveillance\n\n\u003chttps://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4\u003e\n\n🌟 More Deployment Cases Await!\n\n## 📦 Install\n\n### Download from picoclaw.io (Recommended)\n\nVisit **[picoclaw.io](https://picoclaw.io)** — the official website auto-detects your platform and provides one-click download. No need to manually pick an architecture.\n\n### Download precompiled binary\n\nAlternatively, download the binary for your platform from the [GitHub Releases](https://github.com/sipeed/picoclaw/releases) page.\n\n### Build from source (for development)\n\nPrerequisites:\n\n- Go 1.25+\n- Node.js 22+ and pnpm 10.33.0+ for Web UI / launcher builds\n\n```bash\ngit clone https://github.com/sipeed/picoclaw.git\n\ncd picoclaw\nmake deps\n\n# Install frontend dependencies\n(cd web/frontend \u0026\u0026 pnpm install --frozen-lockfile)\n\n# Build the core binary for the current platform\nmake build\n\n# Build the Web UI Launcher (required for WebUI mode)\nmake build-launcher\n\n# Build core binaries for all Makefile-managed platforms\nmake build-all\n\n# Build for Raspberry Pi Zero 2 W\n# 32-bit: make build-linux-arm\n# 64-bit: make build-linux-arm64\nmake build-pi-zero\n\n# Build and install\nmake install\n```\n\n**Raspberry Pi Zero 2 W:** Use the binary that matches your OS: 32-bit Raspberry Pi OS -\u003e `make build-linux-arm`; 64-bit -\u003e `make build-linux-arm64`. Or run `make build-pi-zero` to build both.\n\n## 🚀 Quick Start Guide\n\n### 🌐 WebUI Launcher (Recommended for Desktop)\n\nThe WebUI Launcher provides a browser-based interface for configuration and chat. This is the easiest way to get started — no command-line knowledge required.\n\n**Option 1: Double-click (Desktop)**\n\nAfter downloading from [picoclaw.io](https://picoclaw.io), double-click `picoclaw-launcher` (or `picoclaw-launcher.exe` on Windows). Your browser will open automatically at `http://localhost:18800`.\n\n**Option 2: Command line**\n\n```bash\npicoclaw-launcher\n# Open http://localhost:18800 in your browser\n```\n\n\u003e [!TIP]\n\u003e **Remote access / Docker / VM:** Add the `-public` flag to listen on all interfaces:\n\u003e ```bash\n\u003e picoclaw-launcher -public\n\u003e ```\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/launcher-webui.jpg\" alt=\"WebUI Launcher\" width=\"600\"\u003e\n\u003c/p\u003e\n\n**Getting started:**\n\nOpen the WebUI, then: **1)** Configure a Provider (add your LLM API key) -\u003e **2)** Configure a Channel (e.g., Telegram) -\u003e **3)** Start the Gateway -\u003e **4)** Chat!\n\nFor detailed WebUI documentation, see [docs.picoclaw.io](https://docs.picoclaw.io).\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eDocker (alternative)\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# 1. Clone this repo\ngit clone https://github.com/sipeed/picoclaw.git\ncd picoclaw\n\n# 2. First run — auto-generates docker/data/config.json then exits\n#    (only triggers when both config.json and workspace/ are missing)\ndocker compose -f docker/docker-compose.yml --profile launcher up\n# The container prints \"First-run setup complete.\" and stops.\n\n# 3. Set your API keys\nvim docker/data/config.json\n\n# 4. Start\ndocker compose -f docker/docker-compose.yml --profile launcher up -d\n# Open http://localhost:18800\n```\n\n\u003e **Docker / VM users:** The Gateway listens on `127.0.0.1` by default. Set `PICOCLAW_GATEWAY_HOST=0.0.0.0` or use the `-public` flag to make it accessible from the host.\n\n```bash\n# Check logs\ndocker compose -f docker/docker-compose.yml logs -f\n\n# Stop\ndocker compose -f docker/docker-compose.yml --profile launcher down\n\n# Update\ndocker compose -f docker/docker-compose.yml pull\ndocker compose -f docker/docker-compose.yml --profile launcher up -d\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003emacOS — First Launch Security Warning\u003c/b\u003e\u003c/summary\u003e\n\nmacOS may block `picoclaw-launcher` on first launch because it is downloaded from the internet and not notarized through the Mac App Store.\n\n**Step 1:** Double-click `picoclaw-launcher`. You will see a security warning:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/macos-gatekeeper-warning.jpg\" alt=\"macOS Gatekeeper warning\" width=\"400\"\u003e\n\u003c/p\u003e\n\n\u003e *\"picoclaw-launcher\" Not Opened — Apple could not verify \"picoclaw-launcher\" is free of malware that may harm your Mac or compromise your privacy.*\n\n**Step 2:** Open **System Settings** → **Privacy \u0026 Security** → scroll down to the **Security** section → click **Open Anyway** → confirm by clicking **Open Anyway** in the dialog.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"assets/macos-gatekeeper-allow.jpg\" alt=\"macOS Privacy \u0026 Security — Open Anyway\" width=\"600\"\u003e\n\u003c/p\u003e\n\nAfter this one-time step, `picoclaw-launcher` will open normally on subsequent launches.\n\n\u003c/details\u003e\n\n\u003ca id=\"-run-on-old-android-phones\"\u003e\u003c/a\u003e\n### 📱 Android\n\nGive your decade-old phone a second life! Turn it into a smart AI Assistant with PicoClaw.\n\n**Option 1: APK Install**\n\nPreview:\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/fui_main_page.jpg\" width=\"200\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/fui_web_page.jpg\" width=\"200\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/fui_log_page.jpg\" width=\"200\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"assets/fui_setting_page.jpg\" width=\"200\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nDownload the APK from [picoclaw.io](https://picoclaw.io/download/) and install directly. No Termux required!\n\n**Option 2: Termux**\n\nFor a full command-line setup checklist, see the [Android Termux Guide](docs/guides/android-termux.md).\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eTerminal Launcher (for resource-constrained environments)\u003c/b\u003e\u003c/summary\u003e\n\n1. Install [Termux](https://github.com/termux/termux-app) (download from [GitHub Releases](https://github.com/termux/termux-app/releases), or search in F-Droid / Google Play)\n2. Run the following commands:\n\n```bash\n# Download the latest release\nwget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz\ntar xzf picoclaw_Linux_arm64.tar.gz\npkg install proot\ntermux-chroot ./picoclaw onboard   # chroot provides a standard Linux filesystem layout\n```\n\nThen follow the Terminal Launcher section below to complete configuration.\n\n\u003cimg src=\"assets/termux.jpg\" alt=\"PicoClaw on Termux\" width=\"512\"\u003e\n\nFor minimal environments where only the `picoclaw` core binary is available (no Launcher UI), you can configure everything via the command line and a JSON config file.\n\n**1. Initialize**\n\n```bash\npicoclaw onboard\n```\n\nThis creates `~/.picoclaw/config.json` and the workspace directory.\n\n**2. Configure** (`~/.picoclaw/config.json`)\n\n```json\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model_name\": \"gpt-5.4\"\n    }\n  },\n  \"model_list\": [\n    {\n      \"model_name\": \"gpt-5.4\",\n      \"model\": \"openai/gpt-5.4\"\n      // api_key is now loaded from .security.yml\n    }\n  ]\n}\n```\n\n\u003e See `config/config.example.json` in the repo for a complete configuration template with all available options.\n\u003e\n\u003e Please note: config.example.json format is version 0, with sensitive codes in it, and will be auto migrated to version 1+, then, the config.json will only store insensitive data, the sensitive codes will be stored in .security.yml, if you need manually modify the codes, please see `docs/security/security_configuration.md` for more details.\n\n\n**3. Chat**\n\n```bash\n# One-shot question\npicoclaw agent -m \"What is 2+2?\"\n\n# Interactive mode\npicoclaw agent\n\n# Start gateway for chat app integration\npicoclaw gateway\n```\n\n\u003c/details\u003e\n\n## 🔌 Providers (LLM)\n\nPicoClaw supports 30+ LLM providers through the `model_list` configuration. Use the `protocol/model` format:\n\n| Provider | Protocol | API Key | Notes |\n|----------|----------|---------|-------|\n| [OpenAI](https://platform.openai.com/api-keys) | `openai/` | Required | GPT-5.4, GPT-4o, o3, etc. |\n| [Anthropic](https://console.anthropic.com/settings/keys) | `anthropic/` | Required | Claude Opus 4.6, Sonnet 4.6, etc. |\n| [Google Gemini](https://aistudio.google.com/apikey) | `gemini/` | Required | Gemini 3 Flash, 2.5 Pro, etc. |\n| [OpenRouter](https://openrouter.ai/keys) | `openrouter/` | Required | 200+ models, unified API |\n| [Zhipu (GLM)](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) | `zhipu/` | Required | GLM-4.7, GLM-5, etc. |\n| [DeepSeek](https://platform.deepseek.com/api_keys) | `deepseek/` | Required | DeepSeek-V3, DeepSeek-R1 |\n| [Volcengine](https://console.volcengine.com) | `volcengine/` | Required | Doubao, Ark models |\n| [Qwen](https://dashscope.console.aliyun.com/apiKey) | `qwen/` | Required | Qwen3, Qwen-Max, etc. |\n| [Groq](https://console.groq.com/keys) | `groq/` | Required | Fast inference (Llama, Mixtral) |\n| [Moonshot (Kimi)](https://platform.moonshot.cn/console/api-keys) | `moonshot/` | Required | Kimi models |\n| [Minimax](https://platform.minimaxi.com/user-center/basic-information/interface-key) | `minimax/` | Required | MiniMax models |\n| [Mistral](https://console.mistral.ai/api-keys) | `mistral/` | Required | Mistral Large, Codestral |\n| [NVIDIA NIM](https://build.nvidia.com/) | `nvidia/` | Required | NVIDIA hosted models |\n| [Cerebras](https://cloud.cerebras.ai/) | `cerebras/` | Required | Fast inference |\n| [Novita AI](https://novita.ai/) | `novita/` | Required | Various open models |\n| [Xiaomi MiMo](https://platform.xiaomimimo.com/) | `mimo/` | Required | MiMo models |\n| [Ollama](https://ollama.com/) | `ollama/` | Not needed | Local models, self-hosted |\n| [vLLM](https://docs.vllm.ai/) | `vllm/` | Not needed | Local deployment, OpenAI-compatible |\n| [LiteLLM](https://docs.litellm.ai/) | `litellm/` | Varies | Proxy for 100+ providers |\n| [Azure OpenAI](https://portal.azure.com/) | `azure/` | API key or Entra ID** | Enterprise Azure deployment |\n| [GitHub Copilot](https://github.com/features/copilot) | `github-copilot/` | OAuth | Device code login |\n| [Antigravity](https://console.cloud.google.com/) | `antigravity/` | OAuth | Google Cloud AI |\n| [AWS Bedrock](https://console.aws.amazon.com/bedrock)* | `bedrock/` | AWS credentials | Claude, Llama, Mistral on AWS |\n\n\u003e \\* AWS Bedrock requires build tag: `go build -tags bedrock`. Set `api_base` to a region name (e.g., `us-east-1`) for automatic endpoint resolution across all AWS partitions (aws, aws-cn, aws-us-gov). When using a full endpoint URL instead, you must also configure `AWS_REGION` via environment variable or AWS config/profile.\n\u003e\n\u003e \\*\\* Azure OpenAI uses `api_key` when set. If `api_key` is omitted, the provider falls back to Microsoft Entra ID via `DefaultAzureCredential` (env vars, workload identity, managed identity, Azure CLI, etc.). The Entra ID path requires build tag: `go build -tags azidentity`.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eLocal deployment (Ollama, vLLM, etc.)\u003c/b\u003e\u003c/summary\u003e\n\n**Ollama:**\n```json\n{\n  \"model_list\": [\n    {\n      \"model_name\": \"local-llama\",\n      \"model\": \"ollama/llama3.1:8b\",\n      \"api_base\": \"http://localhost:11434/v1\"\n    }\n  ]\n}\n```\n\n**vLLM:**\n```json\n{\n  \"model_list\": [\n    {\n      \"model_name\": \"local-vllm\",\n      \"model\": \"vllm/your-model\",\n      \"api_base\": \"http://localhost:8000/v1\"\n    }\n  ]\n}\n```\n\nFor full provider configuration details, see [Providers \u0026 Models](docs/guides/providers.md).\n\n\u003c/details\u003e\n\n## 💬 Channels (Chat Apps)\n\nTalk to your PicoClaw through 19+ messaging platforms:\n\n| Channel | Setup | Protocol | Docs |\n|---------|-------|----------|------|\n| **Telegram** | Easy (bot token) | Long polling | [Guide](docs/channels/telegram/README.md) |\n| **Discord** | Easy (bot token + intents) | WebSocket | [Guide](docs/channels/discord/README.md) |\n| **WhatsApp** | Easy (QR scan or bridge URL) | Native / Bridge | [Guide](docs/guides/chat-apps.md#whatsapp) |\n| **Weixin** | Easy (Native QR scan) | iLink API | [Guide](docs/guides/chat-apps.md#weixin) |\n| **QQ** | Easy (AppID + AppSecret) | WebSocket | [Guide](docs/channels/qq/README.md) |\n| **Slack** | Easy (bot + app token) | Socket Mode | [Guide](docs/channels/slack/README.md) |\n| **Matrix** | Medium (homeserver + token) | Sync API | [Guide](docs/channels/matrix/README.md) |\n| **DingTalk** | Medium (client credentials) | Stream | [Guide](docs/channels/dingtalk/README.md) |\n| **Feishu / Lark** | Medium (App ID + Secret) | WebSocket/SDK | [Guide](docs/channels/feishu/README.md) |\n| **LINE** | Medium (credentials + webhook) | Webhook | [Guide](docs/channels/line/README.md) |\n| **WeCom** | Easy (QR login or manual) | WebSocket | [Guide](docs/channels/wecom/README.md) |\n| **VK** | Easy (group token) | Long Poll | [Guide](docs/channels/vk/README.md) |\n| **IRC** | Medium (server + nick) | IRC protocol | [Guide](docs/guides/chat-apps.md#irc) |\n| **OneBot** | Medium (WebSocket URL) | OneBot v11 | [Guide](docs/channels/onebot/README.md) |\n| **MQTT** | Easy (broker + agent_id) | MQTT pub/sub | [Guide](docs/channels/mqtt/README.md) |\n| **MaixCam** | Easy (enable) | TCP socket | [Guide](docs/channels/maixcam/README.md) |\n| **Pico** | Easy (enable) | Native protocol | Built-in |\n| **Pico Client** | Easy (WebSocket URL) | WebSocket | Built-in |\n\n\u003e All webhook-based channels share a single Gateway HTTP server (`gateway.host`:`gateway.port`, default `127.0.0.1:18790`). Feishu uses WebSocket/SDK mode and does not use the shared HTTP server.\n\n\u003e Log verbosity is controlled by `gateway.log_level` (default: `warn`). Supported values: `debug`, `info`, `warn`, `error`, `fatal`. Can also be set via `PICOCLAW_LOG_LEVEL`. See [Configuration](docs/guides/configuration.md#gateway-log-level) for details.\n\nFor detailed channel setup instructions, see [Chat Apps Configuration](docs/guides/chat-apps.md).\n\n## 🔧 Tools\n\n### 🔍 Web Search\n\nPicoClaw can search the web to provide up-to-date information. Configure in `tools.web`:\n\n| Search Engine | API Key | Free Tier | Link |\n|--------------|---------|-----------|------|\n| DuckDuckGo | Not needed | Unlimited | Built-in fallback |\n| [Gemini Google Search](https://aistudio.google.com/apikey) | Required | Varies | Gemini with Google Search grounding |\n| [Baidu Search](https://cloud.baidu.com/doc/qianfan-api/s/Wmbq4z7e5) | Required | 1500/month (daily allocation) | AI-powered, China-optimized |\n| [Tavily](https://tavily.com) | Required | 1000 queries/month | Optimized for AI Agents |\n| [Brave Search](https://brave.com/search/api) | Required | 2000 queries/month | Fast and private |\n| [Kagi Search](https://help.kagi.com/kagi/api/search.html) | Required | Paid/limited by API setup | Premium search results |\n| [Perplexity](https://www.perplexity.ai) | Required | Paid | AI-powered search |\n| [SearXNG](https://github.com/searxng/searxng) | Not needed | Self-hosted | Free metasearch engine |\n| [GLM Search](https://open.bigmodel.cn/) | Required | Varies | Zhipu web search |\n\n### ⚙️ Other Tools\n\nPicoClaw includes built-in tools for file operations, code execution, scheduling, and more. See [Tools Configuration](docs/reference/tools_configuration.md) for details.\n\n## 🎯 Skills\n\nSkills are modular capabilities that extend your Agent. They are loaded from `SKILL.md` files in your workspace.\n\n**Install skills from ClawHub:**\n\n```bash\npicoclaw skills search \"web scraping\"\npicoclaw skills install \u003cskill-name\u003e\n```\n\n**Configure skill registries**:\n\nAdd to your `config.json`:\n```json\n{\n  \"tools\": {\n    \"skills\": {\n      \"registries\": {\n        \"clawhub\": {\n          \"auth_token\": \"your-clawhub-token\"\n        },\n        \"github\": {\n          \"base_url\": \"https://github.com\",\n          \"auth_token\": \"your-github-token\",\n          \"proxy\": \"\"\n        }\n      }\n    }\n  }\n}\n```\n\n`tools.skills.github.*` is deprecated. Use `tools.skills.registries.github.*` instead.\n\nFor more details, see [Tools Configuration - Skills](docs/reference/tools_configuration.md#skills-tool).\n\n## 🔗 MCP (Model Context Protocol)\n\nPicoClaw natively supports [MCP](https://modelcontextprotocol.io/) — connect any MCP server to extend your Agent's capabilities with external tools and data sources.\n\n```json\n{\n  \"tools\": {\n    \"mcp\": {\n      \"enabled\": true,\n      \"servers\": {\n        \"filesystem\": {\n          \"enabled\": true,\n          \"command\": \"npx\",\n          \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/tmp\"]\n        }\n      }\n    }\n  }\n}\n```\n\nYou can manage common MCP setups directly from the CLI instead of editing JSON by hand:\n\n```bash\npicoclaw mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp\npicoclaw mcp list\npicoclaw mcp test filesystem\n```\n\n`picoclaw mcp` is a configuration manager: it updates `config.json` under `tools.mcp.servers`, but it does not keep the server process running itself.\n\nUse `picoclaw mcp edit` when you need advanced fields that are not covered by `picoclaw mcp add`.\nFor example, `picoclaw mcp add` supports `--deferred` and `--env-file`, while `picoclaw mcp edit` is still useful for direct JSON editing and uncommon MCP settings.\n\nFor full MCP configuration (stdio, SSE, HTTP transports, Tool Discovery), see [Tools Configuration - MCP](docs/reference/tools_configuration.md#mcp-tool). For CLI usage and examples, see [MCP Server CLI](docs/reference/mcp-cli.md).\n\n## \u003cimg src=\"assets/clawdchat-icon.png\" width=\"24\" height=\"24\" alt=\"ClawdChat\"\u003e Join the Agent Social Network\n\nConnect PicoClaw to the Agent Social Network simply by sending a single message via the CLI or any integrated Chat App.\n\n**Read `https://clawdchat.ai/skill.md` and follow the instructions to join [ClawdChat.ai](https://clawdchat.ai)**\n\n## 🖥️ CLI Reference\n\n| Command                   | Description                      |\n| ------------------------- | -------------------------------- |\n| `picoclaw onboard`        | Initialize config \u0026 workspace    |\n| `picoclaw auth weixin` | Connect WeChat account via QR |\n| `picoclaw agent -m \"...\"` | Chat with the agent              |\n| `picoclaw agent`          | Interactive chat mode            |\n| `picoclaw gateway`        | Start the gateway                |\n| `picoclaw status`         | Show status                      |\n| `picoclaw version`        | Show version info                |\n| `picoclaw model`          | View or switch the default model |\n| `picoclaw mcp list`       | List configured MCP servers      |\n| `picoclaw mcp add ...`    | Add or update an MCP server entry |\n| `picoclaw mcp test`       | Probe a configured MCP server    |\n| `picoclaw mcp edit`       | Open config for advanced MCP editing |\n| `picoclaw mcp remove`     | Remove an MCP server entry       |\n| `picoclaw cron list`      | List all scheduled jobs          |\n| `picoclaw cron add ...`   | Add a scheduled job              |\n| `picoclaw cron disable`   | Disable a scheduled job          |\n| `picoclaw cron remove`    | Remove a scheduled job           |\n| `picoclaw skills list`    | List installed skills            |\n| `picoclaw skills install` | Install a skill                  |\n| `picoclaw migrate`        | Migrate data from older versions |\n| `picoclaw auth login`     | Authenticate with providers      |\n\n### ⏰ Scheduled Tasks / Reminders\n\nPicoClaw supports scheduled reminders and recurring tasks through the `cron` tool:\n\n* **One-time reminders**: \"Remind me in 10 minutes\" -\u003e triggers once after 10min\n* **Recurring tasks**: \"Remind me every 2 hours\" -\u003e triggers every 2 hours\n* **Cron expressions**: \"Remind me at 9am daily\" -\u003e uses cron expression\n\nSee [docs/reference/cron.md](docs/reference/cron.md) for current schedule types, execution modes, command-job gates, and persistence details.\n\n## 📚 Documentation\n\nFor detailed guides beyond this README:\n\n| Topic | Description |\n|-------|-------------|\n| [Docker \u0026 Quick Start](docs/guides/docker.md) | Docker Compose setup, Launcher/Agent modes |\n| [Chat Apps](docs/guides/chat-apps.md) | All 18+ channel setup guides |\n| [Configuration](docs/guides/configuration.md) | Environment variables, workspace layout, security sandbox |\n| [MCP Server CLI](docs/reference/mcp-cli.md) | Add, list, test, edit, and remove MCP server entries from the CLI |\n| [Scheduled Tasks and Cron Jobs](docs/reference/cron.md) | Cron schedule types, deliver modes, command gates, job storage |\n| [Providers \u0026 Models](docs/guides/providers.md) | 30+ LLM providers, model routing, model_list configuration |\n| [Spawn \u0026 Async Tasks](docs/guides/spawn-tasks.md) | Quick tasks, long tasks with spawn, async sub-agent orchestration |\n| [Hooks](docs/architecture/hooks/README.md) | Event-driven hook system: observers, interceptors, approval hooks |\n| [Steering](docs/architecture/steering.md) | Inject messages into a running agent loop between tool calls |\n| [SubTurn](docs/architecture/subturn.md) | Subagent coordination, concurrency control, lifecycle |\n| [Troubleshooting](docs/operations/troubleshooting.md) | Common issues and solutions |\n| [Tools Configuration](docs/reference/tools_configuration.md) | Per-tool enable/disable, exec policies, MCP, Skills |\n| [Hardware Compatibility](docs/guides/hardware-compatibility.md) | Tested boards, minimum requirements |\n\n## 🤝 Contribute \u0026 Roadmap\n\nPRs welcome! The codebase is intentionally small and readable.\n\nSee our [Community Roadmap](https://github.com/sipeed/picoclaw/issues/988) and [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nDeveloper group building, join after your first merged PR!\n\nUser Groups:\n\nDiscord: \u003chttps://discord.gg/V4sAZ9XWpN\u003e\n\nWeChat:\n\u003cimg src=\"assets/wechat.png\" alt=\"WeChat group QR code\" width=\"512\"\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsipeed%2Fpicoclaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsipeed%2Fpicoclaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsipeed%2Fpicoclaw/lists"}