PicoClaw 是一款超轻量级的个人 AI 助手，支持从嵌入式开发板到普通电脑的各类设备。其核心优势在于极低的资源占用和飞快的启动速度，通过将计算密集的大模型推理任务交给云端 API，本地仅负责轻量的协调工作。
PicoClaw 简介
PicoClaw 由矽速科技（Sipeed）开发，使用 Go 语言编写。
| 特性 | OpenClaw | NanoBot | PicoClaw |
|---|---|---|---|
| 编程语言 | TypeScript | Python | Go |
| 内存占用 | >1GB | >100MB | < 10MB |
| 启动时间 (0.8GHz 核心) | >500 秒 | >30 秒 | <1 秒 |
| 硬件成本参考 | Mac Mini (~$599) | 多数 Linux 开发板 (~$50) | 任意 Linux 板 (最低$10) |
安装指南
方式一：预编译二进制（推荐）
直接从项目 Releases 页面下载对应操作系统和架构的文件，重命名为 picoclaw（或 picoclaw.exe），并放入系统 PATH 路径下即可。
- GitHub Releases: https://github.com/sipeed/picoclaw/releases
方式二：源码编译
适合开发者或特殊架构设备。
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
make build
make install
Windows 环境编译说明：
在 Windows 10 上建议使用 MSYS2 或 WSL 环境配合 gmake。
- 安装 Go 环境（推荐 1.16+）。
- 安装构建工具（如 gmake）。
- 执行以下命令：
gmake deps
gmake build
# 编译完成后，将生成的可执行文件重命名为 picoclaw.exe
rename picoclaw picoclaw.exe
方式三：Docker 部署
最干净、依赖最少的方法。
# 1. 克隆仓库
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. 复制并编辑配置文件
cp config/config.example.json config/config.json
vim config/config.json
# 3. 使用 Docker Compose 启动网关服务
docker compose --profile gateway up -d
配置 PicoClaw
安装完成后，需进行初始化和配置。
- 获取 API Key：可从智谱 AI、OpenRouter 等平台获取。
- 网络搜索（可选）：如需联网查资料，可获取 Brave Search API Key。
- 编辑配置文件：编辑
~/.picoclaw/config.json。
最小化配置示例（以智谱 AI 为例）：
{
"agents": {
"defaults": {
"model": "glm-5",
"max_tokens": 8192
}
},
"providers": {
"zhipu": {
"api_key": "你的智谱 API Key",
"api_base": "https://open.bigmodel.cn/api/paas/v4"
}
}
}
- 初始化：运行以下命令创建默认配置。
picoclaw onboard
使用场景
1. 本地命令行对话
- 交互式对话：进入连续聊天模式。
picoclaw agent - 一次性提问：适合快速查询。
picoclaw agent -m "介绍一下皮皮虾的特点"
2. 接入聊天平台（网关模式）
通过 Telegram、Discord 等日常 App 与 AI 助手聊天。
- 启动网关服务：
picoclaw gateway - 配置渠道：在
config.json的channels部分填入 Bot Token 和用户 ID。{ "channels": { "telegram": { "enabled": true, "token": "你的 Telegram Bot Token", "allowFrom": ["你的 Telegram 用户 ID"] } } }
3. 高级功能
- 自定义人格：修改
~/.picoclaw/workspace/下的AGENTS.md或SOUL.md文件，用自然语言定义助手的性格和技能。 - 定时任务（cron）：
picoclaw cron add --message "提醒我今天的重要会议" --cron "0 9 * * 1-5"
