**PicoClaw** 是一个受 [NanoBot](https://github.com/HKUDS/nanobot) 启发的超轻量级个人 AI 助手。它通过“自举”过程在 **Go** 语言中从头重构 —— 由 AI Agent 自身驱动架构迁移和代码优化。 **在 $10 的硬件上运行，内存占用 <10MB** —— 比 OpenClaw 减少了 99% 的内存，比 Mac mini 便宜 98%！ ## 📢 新闻 2026-03-31 📱 **Android 支持！** PicoClaw 现可在 Android 上运行！在 [picoclaw.io](https://picoclaw.io/download) 下载 APK 2026-03-25 🚀 **v0.2.4 发布！** Agent 架构大改版（SubTurn, Hooks, Steering, EventBus），集成微信/企业微信，安全加固（.security.yml, 敏感数据过滤），新 Provider（AWS Bedrock, Azure, 小米 MiMo），以及 35 个错误修复。PicoClaw 已达到 **26K Stars**！ 2026-03-17 🚀 **v0.2.3 发布！** 系统托盘 UI（Windows & Linux），子 Agent 状态查询（`spawn_status`），实验性 Gateway 热重载，Cron 安全门控，以及 2 个安全修复。PicoClaw 已达到 **25K Stars**！ 2026-03-09 🎉 **v0.2.1 —— 迄今最大的更新！** MCP 协议支持，4 个新 Channel（Matrix/IRC/WeCom/Discord Proxy），3 个新 Provider（Kimi/Minimax/Avian），视觉 pipeline，JSONL 内存存储，模型路由。 2026-02-28 📦 **v0.2.0** 发布，支持 Docker Compose 和 Web UI 启动器。

更早的新闻...

2026-02-26 🎉 PicoClaw 仅用 17 天突破 **20K Stars**！Channel 自动编排和 Capabilities 接口已上线。 2026-02-16 🎉 PicoClaw 一周内突破 12K Stars！社区维护者角色和 [路线图](ROADMAP.md) 正式发布。 2026-02-13 🎉 PicoClaw 4 天内突破 5000 Stars！项目路线图和开发者群组筹备中。 2026-02-09 🎉 **PicoClaw 发布！** 1 天内构建完成，旨在将 AI Agent 带到 $10 硬件和 <10MB 内存环境。冲吧，PicoClaw！

## ✨ 特性 🪶 **超轻量**：核心内存占用 <10MB —— 比 OpenClaw 小 99%。* 💰 **极低成本**：高效到可在 $10 的硬件上运行 —— 比 Mac mini 便宜 98%。 ⚡️ **极速启动**：启动速度快 400 倍。即使在 0.6GHz 单核处理器上也能在 <1s 内启动。 🌍 **真正的可移植性**：跨 RISC-V、ARM、MIPS 和 x86 架构的单二进制文件。一次编译，到处运行！ 🤖 **AI 自举**：纯 Go 原生实现 —— 95% 的核心代码由 Agent 生成，并通过人在回路的审查进行微调。 🔌 **MCP 支持**：原生集成 [Model Context Protocol](https://modelcontextprotocol.io/) —— 连接任何 MCP server 以扩展 Agent 能力。 👁️ **视觉 Pipeline**：直接向 Agent 发送图片和文件 —— 自动进行 base64 编码，支持多模态 LLM。 🧠 **智能路由**：基于规则的模型路由 —— 简单查询分配给轻量模型，节省 API 成本。 _*近期构建可能占用 10-20MB，原因是快速合并 PR。资源优化已在计划中。启动速度对比基于 0.8GHz 单核基准测试（见下表）。_

## 🦾 演示 ### 🛠️ 标准助手工作流

Full-Stack Engineer Mode	Logging & Planning	Web Search & Learning
Develop · Deploy · Scale	Schedule · Automate · Remember	Discover · Insights · Trends

### 🐜 创新低资源部署 PicoClaw 几乎可以部署在任何 Linux 设备上！ - $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) E（以太网）或 W（WiFi6）版，作为极简家庭助手 - $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html)，或 $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html)，用于自动化服务器运维 - $50 [MaixCAM](https://www.aliexpress.com/item/1005008053333693.html) 或 $100 [MaixCAM2](https://www.kickstarter.com/projects/zepan/maixcam2-build-your-next-gen-4k-ai-camera)，用于智能监控 🌟 更多部署案例敬请期待！ ## 📦 安装 ### 从 picoclaw.io 下载（推荐） 访问 **[picoclaw.io](https://picoclaw.io)** —— 官网会自动检测您的平台并提供一键下载。无需手动选择架构。 ### 下载预编译二进制文件 或者，从 [GitHub Releases](https://github.com/sipeed/picoclaw/releases) 页面下载适用于您平台的二进制文件。 ### 从源码构建（用于开发） ``` git clone https://github.com/sipeed/picoclaw.git cd picoclaw make deps # 构建核心二进制文件 make build # 构建 Web UI Launcher (WebUI 模式必需) make build-launcher # 构建多平台版本 make build-all # 构建 for Raspberry Pi Zero 2 W (32-bit: make build-linux-arm; 64-bit: make build-linux-arm64) make build-pi-zero # 构建并安装 make install ``` **Raspberry Pi Zero 2 W：** 使用与您的操作系统匹配的二进制文件：32 位 Raspberry Pi OS -> `make build-linux-arm`；64 位 -> `make build-linux-arm64`。或运行 `make build-pi-zero` 同时构建两者。 ## 🚀 快速入门指南 ### 🌐 WebUI 启动器（桌面端推荐） WebUI 启动器提供基于浏览器的配置和聊天界面。这是最简单的上手方式 —— 无需命令行知识。 **方式 1：双击（桌面端）** 从 [picoclaw.io](https://picoclaw.io) 下载后，双击 `picoclaw-launcher`（Windows 上为 `picoclaw-launcher.exe`）。您的浏览器将自动打开 `http://localhost:18800`。 **方式 2：命令行** ``` picoclaw-launcher # 在浏览器中打开 http://localhost:18800 ```

**开始使用：** 打开 WebUI，然后：**1)** 配置 Provider（添加您的 LLM API 密钥） -> **2)** 配置 Channel（例如 Telegram） -> **3)** 启动 Gateway -> **4)** 开始聊天！ 详细的 WebUI 文档，请参阅 [docs.picoclaw.io](https://docs.picoclaw.io)。

Docker（备选）

``` # 1. Clone 这个 repo git clone https://github.com/sipeed/picoclaw.git cd picoclaw # 2. 首次运行 — 自动生成 docker/data/config.json 然后退出 # （仅在 config.json 和 workspace/ 均缺失时触发） docker compose -f docker/docker-compose.yml --profile launcher up # 容器打印 "First-run setup complete." 并停止。 # 3. 设置您的 API keys vim docker/data/config.json # 4. 启动 docker compose -f docker/docker-compose.yml --profile launcher up -d # 打开 http://localhost:18800 ``` ``` # 查看日志 docker compose -f docker/docker-compose.yml logs -f # 停止 docker compose -f docker/docker-compose.yml --profile launcher down # 更新 docker compose -f docker/docker-compose.yml pull docker compose -f docker/docker-compose.yml --profile launcher up -d ```

macOS —— 首次启动安全警告

macOS 可能会在首次启动时阻止 `picoclaw-launcher`，因为它是从互联网下载的，且未经过 Mac App Store 公证。 **步骤 1：** 双击 `picoclaw-launcher`。您将看到安全警告：

**步骤 2：** 打开 **系统设置** → **隐私与安全性** → 向下滚动到 **安全性** 部分 → 点击 **仍要打开** → 在对话框中点击 **打开** 以确认。

完成此一次性步骤后，`picoclaw-launcher` 在后续启动时将正常打开。

### 💻 TUI 启动器（无头模式 / SSH 推荐） TUI（终端 UI）启动器提供全功能的终端配置和管理界面。非常适合服务器、Raspberry Pi 和其他无头环境。 ``` picoclaw-launcher-tui ```

**开始使用：** 使用 TUI 菜单：**1)** 配置 Provider -> **2)** 配置 Channel -> **3)** 启动 Gateway -> **4)** 开始聊天！ 详细的 TUI 文档，请参阅 [docs.picoclaw.io](https://docs.picoclaw.io)。 ### 📱 Android 让您十年前的手机焕发新生！用 PicoClaw 将其变成智能 AI 助手。 **方式 1：APK 安装** 预览： 从 [picoclaw.io](https://picoclaw.io/download/) 下载 APK 并直接安装。无需 Termux！ **方式 2：Termux**

终端启动器（用于资源受限环境）

1. 安装 [Termux](https://github.com/termux/termux-app)（从 [GitHub Releases](https://github.com/termux/termux-app/releases) 下载，或在 F-Droid / Google Play 中搜索） 2. 运行以下命令： ``` # 下载最新 release wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz tar xzf picoclaw_Linux_arm64.tar.gz pkg install proot termux-chroot ./picoclaw onboard # chroot provides a standard Linux filesystem layout ``` 然后按照下方的终端启动器部分完成配置。 对于仅有 `picoclaw` 核心二进制文件（无启动器 UI）的极简环境，您可以通过命令行和 JSON 配置文件完成所有配置。 **1. 初始化** ``` picoclaw onboard ``` 这将创建 `~/.picoclaw/config.json` 和工作空间目录。 **2. 配置** (`~/.picoclaw/config.json`) ``` { "agents": { "defaults": { "model_name": "gpt-5.4" } }, "model_list": [ { "model_name": "gpt-5.4", "model": "openai/gpt-5.4" // api_key is now loaded from .security.yml } ] } ``` **3. 聊天** ``` # 单次提问 picoclaw agent -m "What is 2+2?" # 交互模式 picoclaw agent # 启动网关以进行聊天应用集成 picoclaw gateway ```

## 🔌 Providers (LLM) PicoClaw 通过 `model_list` 配置支持 30 多个 LLM provider。使用 `protocol/model` 格式： | Provider | Protocol | API Key | 备注 | |----------|----------|---------|-------| | [OpenAI](https://platform.openai.com/api-keys) | `openai/` | 必需 | GPT-5.4, GPT-4o, o3 等 | | [Anthropic](https://console.anthropic.com/settings/keys) | `anthropic/` | 必需 | Claude Opus 4.6, Sonnet 4.6 等 | | [Google Gemini](https://aistudio.google.com/apikey) | `gemini/` | 必需 | Gemini 3 Flash, 2.5 Pro 等 | | [OpenRouter](https://openrouter.ai/keys) | `openrouter/` | 必需 | 200+ 模型，统一 API | | [智谱 (GLM)](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) | `zhipu/` | 必需 | GLM-4.7, GLM-5 等 | | [DeepSeek](https://platform.deepseek.com/api_keys) | `deepseek/` | 必需 | DeepSeek-V3, DeepSeek-R1 | | [火山引擎](https://console.volcengine.com) | `volcengine/` | 必需 | 豆包, Ark 模型 | | [Qwen](https://dashscope.console.aliyun.com/apiKey) | `qwen/` | 必需 | Qwen3, Qwen-Max 等 | | [Groq](https://console.groq.com/keys) | `groq/` | 必需 | 快速推理 (Llama, Mixtral) | | [Moonshot (Kimi)](https://platform.moonshot.cn/console/api-keys) | `moonshot/` | 必需 | Kimi 模型 | | [Minimax](https://platform.minimaxi.com/user-center/basic-information/interface-key) | `minimax/` | 必需 | MiniMax 模型 | | [Mistral](https://console.mistral.ai/api-keys) | `mistral/` | 必需 | Mistral Large, Codestral | | [NVIDIA NIM](https://build.nvidia.com/) | `nvidia/` | 必需 | NVIDIA 托管模型 | | [Cerebras](https://cloud.cerebras.ai/) | `cerebras/` | 必需 | 快速推理 | | [Novita AI](https://novita.ai/) | `novita/` | 必需 | 各类开源模型 | | [小米 MiMo](https://platform.xiaomimimo.com/) | `mimo/` | 必需 | MiMo 模型 | | [Ollama](https://ollama.com/) | `ollama/` | 不需要 | 本地模型，自托管 | | [vLLM](https://docs.vllm.ai/) | `vllm/` | 不需要 |地部署，兼容 OpenAI | | [LiteLLM](https://docs.litellm.ai/) | `litellm/` | 视情况而定 | 100+ Provider 代理 | | [Azure OpenAI](https://portal.azure.com/) | `azure/` | 必需 | 企业级 Azure 部署 | | [GitHub Copilot](https://github.com/features/copilot) | `github-copilot/` | OAuth | 设备码登录 | | [Antigravity](https://console.cloud.google.com/) | `antigravity/` | OAuth | Google Cloud AI | | [AWS Bedrock](https://console.aws.amazon.com/bedrock)* | `bedrock/` | AWS 凭证 | AWS 上的 Claude, Llama, Mistral |

本地部署（Ollama, vLLM 等）

**Ollama:** ``` { "model_list": [ { "model_name": "local-llama", "model": "ollama/llama3.1:8b", "api_base": "http://localhost:11434/v1" } ] } ``` **vLLM:** ``` { "model_list": [ { "model_name": "local-vllm", "model": "vllm/your-model", "api_base": "http://localhost:8000/v1" } ] } ``` 完整的 Provider 配置详情，请参阅 [Providers & Models](docs/providers.md)。

## 💬 Channels（聊天应用） 通过 18+ 个聊天平台与您的 PicoClaw 对话： | Channel | 设置难度 | Protocol | 文档 | |---------|-------|----------|------| | **Telegram** | 简单（bot token） | Long polling | [指南](docs/channels/telegram/README.md) | | **Discord** | 简单（bot token + intents） | WebSocket | [指南](docs/channels/discord/README.md) | | **WhatsApp** | 简单（扫码或 bridge URL） | Native / Bridge | [指南](docs/chat-apps.md#whatsapp) | | **微信** | 简单（原生扫码） | iLink API | [指南](docs/chat-apps.md#weixin) | | **QQ** | 简单（AppID + AppSecret） | WebSocket | [指南](docs/channels/qq/README.md) | | **Slack** | 简单（bot + app token） | Socket Mode | [指南](docs/channels/slack/README.md) | | **Matrix** | 中等（homeserver + token） | Sync API | [指南](docs/channels/matrix/README.md) | | **钉钉** | 中等（client credentials） | Stream | [指南](docs/channels/dingtalk/README.md) | | **飞书 / Lark** | 中等（App ID + Secret） | WebSocket/SDK | [指南](docs/channels/feishu/README.md) | | **LINE** | 中等（credentials + webhook） | Webhook | [指南](docs/channels/line/README.md) | | **企业微信** | 简单（扫码登录或手动） | WebSocket | [指南](docs/channels/wecom/README.md) | | **VK** | 简单（group token） | Long Poll | [指南](docs/channels/vk/README.md) | | **IRC** | 中等（server + nick） | IRC protocol | [指南](docs/chat-apps.md#irc) | | **OneBot** | 中等（WebSocket URL） | OneBot v11 | [指南](docs/channels/onebot/README.md) | | **MaixCam** | 简单（启用） | TCP socket | [指南](docs/channels/maixcam/README.md) | | **Pico** | 简单（启用） | Native protocol | 内置 | | **Pico Client** | 简单（WebSocket URL） | WebSocket | 内置 | 详细的 Channel 设置说明，请参阅 [Chat Apps Configuration](docs/chat-apps.md)。 ## 🔧 工具 ### 🔍 网页搜索 PicoClaw 可以搜索网页以提供最新信息。在 `tools.web` 中配置： | 搜索引擎 | API Key | 免费额度 | 链接 | |--------------|---------|-----------|------| | DuckDuckGo | 不需要 | 无限 | 内置后备 | | [百度搜索](https://cloud.baidu.com/doc/qianfan-api/s/Wmbq4z7e5) | 必需 | 1000 次/天 | AI 驱动，中国优化 | | [Tavily](https://tavily.com) | 必需 | 1000 次/月 | 为 AI Agent 优化 | | [Brave Search](https://brave.com/search/api) | 必需 | 2000 次/月 | 快速且私密 | | [Perplexity](https://www.perplexity.ai) | 必需 | 付费 | AI 驱动搜索 | | [SearXNG](https://github.com/searxng/searxng) | 不需要 | 自托管 | 免费元搜索引擎 | | [GLM Search](https://open.bigmodel.cn/) | 必需 | 视情况而定 | 智谱网页搜索 | ### ⚙️ 其他工具 PicoClaw 包含用于文件操作、代码执行、调度等的内置工具。详情请参阅 [Tools Configuration](docs/tools_configuration.md)。 ## 🎯 Skills Skills 是扩展 Agent 能力的模块化功能。它们从您工作空间中的 `SKILL.md` 文件加载。 **从 ClawHub 安装 Skills：** ``` picoclaw skills search "web scraping" picoclaw skills install ``` **配置 ClawHub token**（可选，用于提高速率限制）： 添加到您的 `config.json`： ``` { "tools": { "skills": { "registries": { "clawhub": { "auth_token": "your-clawhub-token" } } } } } ``` 更多详情，请参阅 [Tools Configuration - Skills](docs/tools_configuration.md#skills-tool)。 ## 🔗 MCP (Model Context Protocol) PicoClaw 原生支持 [MCP](https://modelcontextprotocol.io/) —— 连接任何 MCP server，通过外部工具和数据源扩展您的 Agent 能力。 ``` { "tools": { "mcp": { "enabled": true, "servers": { "filesystem": { "enabled": true, "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"] } } } } } ``` 完整的 MCP 配置（stdio, SSE, HTTP 传输，Tool Discovery），请参阅 [Tools Configuration - MCP](docs/tools_configuration.md#mcp-tool)。 ## 加入 Agent 社交网络 只需通过 CLI 或任何集成的聊天应用发送一条消息，即可将 PicoClaw 连接到 Agent 社交网络。 **阅读 `https://clawdchat.ai/skill.md` 并按照说明加入 [ClawdChat.ai](https://clawdchat.ai)** ## 🖥️ CLI 参考 | 命令 | 描述 | | ------------------------- | -------------------------------- | | `picoclaw onboard` | 初始化配置 & 工作空间 | | `picoclaw auth weixin` | 通过二维码连接微信账号 | | `picoclaw agent -m "..."` | 与 agent 聊天 | | `picoclaw agent` | 交互式聊天模式 | | `picoclaw gateway` | 启动 gateway | | `picoclaw status` | 显示状态 | | `picoclaw version` | 显示版本信息 | | `picoclaw model` | 查看或切换默认模型 | | `picoclaw cron list` | 列出所有计划任务 | | `picoclaw cron add ...` | 添加计划任务 | | `picoclaw cron disable` | 禁用计划任务 | | `picoclaw cron remove` | 移除计划任务 | | `picoclaw skills list` | 列出已安装的 skills | | `picoclaw skills install` | 安装 skill | | `picoclaw migrate` | 从旧版本迁移数据 | | `picoclaw auth login` | 登录到 providers | ### ⏰ 计划任务 / 提醒 PicoClaw 通过 `cron` 工具支持计划提醒和循环任务： * **一次性提醒**：“10 分钟后提醒我” -> 10 分钟后触发一次 * **循环任务**：“每 2 小时提醒我” -> 每 2 小时触发一次 * **Cron 表达式**：“每天早上 9 点提醒我” -> 使用 cron 表达式 有关当前的计划类型、执行模式、命令-任务门控和持久化详情，请参阅 [docs/cron.md](docs/cron.md)。 ## 📚 文档 除了本 README 之外的详细指南： | 主题 | 描述 | |-------|-------------| | [Docker & 快速开始](docs/docker.md) | Docker Compose 设置，Launcher/Agent 模式 | | [聊天应用](docs/chat-apps.md) | 所有 17+ 个 Channel 设置指南 | | [配置](docs/configuration.md) | 环境变量，工作空间布局，安全沙箱 | | [计划任务和 Cron Jobs](docs/cron.md) | Cron 计划类型，交付模式，命令门控，任务存储 | | [Providers & Models](docs/providers.md) | 30+ LLM providers，模型路由，model_list 配置 | | [Spawn & 异步任务](docs/spawn-tasks.md) | 快速任务，带 spawn 的长任务，异步子 agent 编排 | | [Hooks](docs/hooks/README.md) | 事件驱动 hook 系统：observers, interceptors, approval hooks | | [Steering](docs/steering.md) | 在工具调用之间向运行中的 agent 循环注入消息 | | [SubTurn](docs/subturn.md) | 子 agent 协调，并发控制，生命周期 | | [故障排除](docs/troubleshooting.md) | 常见问题及解决方案 | | [Tools Configuration](docs/tools_configuration.md) | 逐个工具启用/禁用，执行策略，MCP，Skills | | [硬件兼容性](docs/hardware-compatibility.md) | 已测试开发板，最低要求 | ## 🤝 贡献 & 路线图 欢迎 PR！代码库刻意保持小巧和可读性。 请参阅我们的 [社区路线图](https://github.com/sipeed/picoclaw/issues/988) 和 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。 开发者群组建设中，首个 PR 合并后即可加入！ 用户群组： Discord: 微信：

标签：AI助手, EVTX分析, Go语言, LangChain, LoongArch, MIPS, PE 加载器, PicoClaw, RAG, RISC-V, Ruby, Sipeed, 个人助理, 人工智能, 低资源消耗, 大模型 Agent, 嵌入式AI, 开源, 日志审计, 本地部署, 物联网, 生产力工具, 用户模式Hook绕过, 知识库, 硬件加速, 离线运行, 程序破解, 网络调试, 自动化, 请求拦截, 轻量级, 边缘计算, 隐私计算