README.Zh

<a href="https://picoclaw.io"></a>
<a href="https://docs.picoclaw.io/"></a>
<a href="https://deepwiki.com/sipeed/picoclaw"></a>


<a href="https://x.com/SipeedIO"></a>
<a href="../../assets/wechat.png"></a>
<a href="https://discord.gg/V4sAZ9XWpN"></a>

中文 | 日本語 | 한국어 | Português | Tiếng Việt | Français | Italiano | Bahasa Indonesia | Malay | English

PicoClaw 是由 矽速科技 (Sipeed) 发起的独立开源项目，完全使用 Go 语言从零编写——不是 OpenClaw、NanoBot 或其他项目的分支。

🦐 PicoClaw 是一个受 NanoBot 启发的超轻量级个人 AI 助手。它采用 Go 语言 从零重构，经历了一个"自举"过程——即由 AI Agent 自身驱动了整个架构迁移和代码优化。

⚡️ 极致轻量：可在 10 美元 的硬件上运行，内存占用 <10MB。这意味着比 OpenClaw 节省 99% 的内存，比 Mac mini 便宜 98%！

[!CAUTION] 🚨 安全声明

• 无加密货币 (NO CRYPTO): PicoClaw 没有 发行任何官方代币、Token 或虚拟货币。所有在 pump.fun 或其他交易平台上的相关声称均为 诈骗。
• 官方域名: 唯一的官方网站是 picoclaw.io，公司官网是 sipeed.com。
• 警惕: 许多 .ai/.org/.com/.net/... 后缀的域名被第三方抢注，请勿轻信。
• 注意: PicoClaw 正在初期的快速功能开发阶段，可能有尚未修复的网络安全问题，在 1.0 正式版发布前，请不要将其部署到生产环境中。
• 注意: PicoClaw 最近合并了大量 PR，近期版本可能内存占用较大 (10~20MB)，我们将在功能较为收敛后进行资源占用优化。

📢 新闻

2026-03-31 📱 Android 支持！ PicoClaw 现可在 Android 上运行！APK 下载地址：picoclaw.io

2026-03-25 🚀 v0.2.4 发布！ Agent 架构全面重构（SubTurn、Hook、Steering、EventBus）、微信/企业微信深度集成、安全体系升级（.security.yml、敏感数据过滤）、新增 Provider（AWS Bedrock、Azure、小米 MiMo），以及 35 项 Bug 修复。PicoClaw 已达 26K ⭐！

2026-03-17 🚀 v0.2.3 发布！ 系统托盘 UI（Windows & Linux）、子 Agent 状态查询 (spawn_status)、实验性 Gateway 热重载、Cron 安全门控，以及 2 项安全修复。PicoClaw 已达 25K ⭐！

2026-03-09 🎉 v0.2.1 — 史上最大更新！ MCP 协议支持、4 个新频道 (Matrix/IRC/WeCom/Discord Proxy)、3 个新 Provider (Kimi/Minimax/Avian)、视觉管线、JSONL 记忆存储、模型路由。

2026-02-28 📦 v0.2.0 发布，支持 Docker Compose 和 Web UI 启动器。

2026-02-26 🎉 PicoClaw 仅 17 天突破 20K Stars！频道自动编排和能力接口上线。

2026-02-16 🎉 PicoClaw 一周内突破 12K Stars！社区维护者角色和 路线图 正式发布。

2026-02-13 🎉 PicoClaw 4 天内突破 5000 Stars！项目路线图和开发者群组筹建中。

2026-02-09 🎉 PicoClaw 正式发布！ 仅用 1 天构建，将 AI Agent 带入 $10 硬件与 <10MB 内存的世界。🦐 皮皮虾，我们走！

✨ 特性

🪶 超轻量级: 核心功能内存占用 <10MB — 比 OpenClaw 小 99%。*

💰 极低成本: 高效到足以在 $10 的硬件上运行 — 比 Mac mini 便宜 98%。

⚡️ 闪电启动: 启动速度快 400 倍，即使在 0.6GHz 单核处理器上也能在 1 秒内启动。

🌍 真正可移植: 跨 RISC-V、ARM、MIPS 和 x86 架构的单二进制文件，一键运行！

🤖 AI 自举: 纯 Go 语言原生实现 — 95% 的核心代码由 Agent 生成，并经由"人机回环"微调。

🔌 MCP 支持: 原生 Model Context Protocol 集成 — 连接任意 MCP 服务器扩展 Agent 能力。

👁️ 视觉管线: 直接向 Agent 发送图片和文件 — 自动 base64 编码对接多模态 LLM。

🧠 智能路由: 基于规则的模型路由 — 简单查询走轻量模型，节省 API 成本。

*近期版本因快速合并 PR 可能占用 10–20MB，资源优化已列入计划。启动速度对比基于 0.8GHz 单核实测（见下方对比表）。

📋 硬件兼容列表 — 查看所有已测试的板卡，从 $5 RISC-V 到树莓派到安卓手机。你的板卡没在列表中？欢迎提交 PR！

🦾 演示

🛠️ 标准助手工作流

🐜 创新的低占用部署

PicoClaw 几乎可以部署在任何 Linux 设备上！

• $9.9 LicheeRV-Nano E(网口) 或 W(WiFi6) 版本，用于极简家庭助手
• $30~50 NanoKVM，或 $100 NanoKVM-Pro，用于自动化服务器运维
• $50 MaixCAM 或 $100 MaixCAM2，用于智能监控

https://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4

🌟 更多部署案例敬请期待！

📦 安装

从 picoclaw.io 下载（推荐）

访问 picoclaw.io — 官网自动检测你的平台，提供一键下载，无需手动选择架构。

下载预编译二进制文件

也可以从 GitHub Releases 页面手动下载对应平台的二进制文件。

从源码构建（开发用）

前置要求：

• Go 1.25+
• Node.js 22+ 和 pnpm 10.33.0+（用于 Web UI / launcher 构建）

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

cd picoclaw
make deps

# 安装前端依赖
(cd web/frontend && pnpm install --frozen-lockfile)

# 构建核心二进制文件
make build

# 构建 Web UI Launcher（WebUI 模式必需）
make build-launcher

# 为 Makefile 管理的所有平台构建核心二进制文件
make build-all

# 为 Raspberry Pi Zero 2 W 构建（32位: make build-linux-arm; 64位: 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 Launcher（推荐桌面用户）

WebUI Launcher 提供基于浏览器的配置与聊天界面，是最简单的上手方式——无需命令行知识。

方式一：双击启动（桌面）

从 picoclaw.io 下载后，双击 picoclaw-launcher（Windows 上为 picoclaw-launcher.exe），浏览器将自动打开 http://localhost:18800。

方式二：命令行

picoclaw-launcher
# 在浏览器中打开 http://localhost:18800

[!TIP] 远程访问 / Docker / 虚拟机： 添加 -public 参数以监听所有网络接口：

bashCopy

picoclaw-launcher -public

开始使用：

打开 WebUI，然后：1) 配置 Provider（填入 LLM API Key）-> 2) 配置 Channel（如 Telegram）-> 3) 启动 Gateway -> 4) 开始聊天！

详细 WebUI 文档请参阅 docs.picoclaw.io。

# 1. 克隆本仓库
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 Key
vim docker/data/config.json

# 4. 启动
docker compose -f docker/docker-compose.yml --profile launcher up -d
# 打开 http://localhost:18800

Docker / 虚拟机用户： Gateway 默认监听 127.0.0.1。设置 PICOCLAW_GATEWAY_HOST=0.0.0.0 或使用 -public 参数以允许从宿主机访问。

# 查看日志
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 可能会在首次启动时拦截 picoclaw-launcher，因为它从互联网下载，未经 Mac App Store 公证。

第一步： 双击 picoclaw-launcher，会出现安全警告：

"picoclaw-launcher" 无法打开 — Apple 无法验证 "picoclaw-launcher" 不含可能损害 Mac 或危及隐私的恶意软件。

第二步： 打开系统设置 → 隐私与安全性 → 向下滚动找到安全性部分 → 点击仍要打开 → 在弹窗中再次点击打开。

完成这一次操作后，后续启动 picoclaw-launcher 将不再弹出警告。

<a id="-run-on-old-android-phones"></a>

📱 Android

让你十年前的旧手机焕发新生！将它变成你的 AI 助手。

方式一：APK 安装

预览：

从 picoclaw.io 下载 APK 并直接安装，无需 Termux！

方式二：Termux

1. 安装 Termux（可从 GitHub 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 提供标准 Linux 文件系统布局

然后跟随下面的"Terminal Launcher"章节继续配置。

对于只有 picoclaw 核心二进制文件的极简环境（无 Launcher 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": "sk-your-api-key"
    }
  ]
}

完整配置模板请参阅仓库中的 config/config.example.json。

3. 开始聊天

# 单次提问
picoclaw agent -m "What is 2+2?"

# 交互式对话模式
picoclaw agent

# 启动 Gateway 以接入聊天应用
picoclaw gateway

🔌 Providers (LLM)

PicoClaw 通过 model_list 配置支持 30+ LLM Provider，使用 协议/模型 格式：

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。

💬 Channels（聊天应用）

通过 18+ 消息平台与你的 PicoClaw 对话：

所有基于 Webhook 的 Channel 共用同一个 Gateway HTTP 服务器（gateway.host:gateway.port，默认 127.0.0.1:18790）。飞书使用 WebSocket/SDK 模式，不使用共享 HTTP 服务器。

日志详细程度通过 gateway.log_level 控制（默认：warn）。支持的值：debug、info、warn、error、fatal。也可通过 PICOCLAW_LOG_LEVEL 环境变量设置。详见配置指南。

详细 Channel 配置说明请参阅 聊天应用配置。

🔧 Tools

🔍 网络搜索

PicoClaw 可以搜索网络以提供最新信息。在 tools.web 中配置：

⚙️ 其他工具

PicoClaw 内置文件操作、代码执行、定时任务等工具。详情请参阅 工具配置。

🎯 Skills

Skills 是扩展 Agent 能力的模块化插件，从工作区的 SKILL.md 文件加载。

从 ClawHub 安装 Skills：

picoclaw skills search "web scraping"
picoclaw skills install <skill-name>

配置 Skills 仓库源：

在 config.json 中添加：

{
  "tools": {
    "skills": {
      "registries": {
        "clawhub": {
          "auth_token": "your-clawhub-token"
        },
        "github": {
          "base_url": "https://github.com",
          "auth_token": "your-github-token",
          "proxy": ""
        }
      }
    }
  }
}

tools.skills.github.* 已废弃，请改用 tools.skills.registries.github.*。

更多详情请参阅 工具配置 - Skills。

🔗 MCP (Model Context Protocol)

PicoClaw 原生支持 MCP — 连接任意 MCP 服务器，通过外部工具和数据源扩展 Agent 能力。

{
  "tools": {
    "mcp": {
      "enabled": true,
      "servers": {
        "filesystem": {
          "enabled": true,
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
        }
      }
    }
  }
}

完整 MCP 配置（stdio、SSE、HTTP 传输、Tool Discovery）请参阅 工具配置 - MCP。

加入 Agent 社交网络

通过 CLI 或任何已集成的聊天应用发送一条消息，即可将 PicoClaw 连接到 Agent 社交网络。

阅读 https://clawdchat.ai/skill.md 并按照说明加入 ClawdChat.ai

🖥️ CLI 命令行参考

⏰ 定时任务 / 提醒

PicoClaw 通过 cron 工具支持定时提醒和重复任务：

• 一次性提醒: "10分钟后提醒我" → 10分钟后触发一次
• 重复任务: "每2小时提醒我" → 每2小时触发
• Cron 表达式: "每天上午9点提醒我" → 使用 cron 表达式

📚 文档

详细指南请参阅以下文档，README 仅涵盖快速入门。

🤝 贡献与路线图

欢迎提交 PR！代码库刻意保持小巧和可读。🤗

查看完整的 社区路线图 和 CONTRIBUTING.md。

开发者群组正在组建中，入群门槛：至少合并过 1 个 PR。

用户群组：

Discord: https://discord.gg/V4sAZ9XWpN

WeChat: