PicoClaw 简介
PicoClaw 是一个超轻量级的个人 AI 助手，可以用在从嵌入式开发板到普通电脑的各类设备上。它最吸引人的特点是极低的资源占用和飞快的启动速度。下面详细介绍它的安装和使用方法。
特性对比
| 特性 | OpenClaw | NanoBot | PicoClaw |
|---|---|---|---|
| 编程语言 | TypeScript | Python | Go |
| 内存占用 | >1GB | >100MB | < 10MB |
| 启动时间 (0.8GHz 核心) | >500 秒 | >30 秒 | <1 秒 |
| 硬件成本参考 | Mac Mini (约$599) | 多数 Linux 开发板 (~$50) | 任意 Linux 板 (最低$10) |
安装指南
你可以根据自己的需求和环境，选择以下任意一种方式安装。
方式一：预编译二进制（最简单）
直接从项目的 Releases 页面 下载对应你操作系统和架构（如 linux-arm64, windows-amd64）的文件，重命名为 picoclaw（或 picoclaw.exe），并放到系统 PATH 路径下即可。
方式二：从源码编译（适合开发者）
如果你想要体验最新特性，或者你的设备架构特殊，可以自行编译：
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
make build
make install
方式三：使用 Docker（环境隔离，快速体验）
这是最干净、依赖最少的方法，非常适合快速上手。
# 1. 克隆仓库
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. 复制并编辑配置文件（填入你的 API Key）
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 文件，这是核心步骤。你需要至少配置一个 LLM 提供商（如智谱、OpenRouter）的 API Key。一个最小化的配置示例如下（以智谱 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/ 文件夹和默认配置文件。
picoclaw onboard
使用场景
配置好之后，你就可以用多种方式和你的 AI 助手交互了。
- 本地命令行对话
- 接入聊天平台（网关模式） 这是 PicoClaw 最实用的功能之一，可以让你通过 Telegram、Discord 等日常 App 与 AI 助手聊天。
- 高级功能：定时任务与个性化
- 自定义人格：通过修改
~/.picoclaw/workspace/下的AGENTS.md或SOUL.md文件，可以用自然语言定义助手的性格、技能和行为准则，无需编写代码。 - 定时任务（cron）：你可以设置让助手定时执行任务，比如每天早上 9 点提醒你今天的日程。
picoclaw cron add --message "提醒我今天的重要会议" --cron "0 9 * * 1-5" - 自定义人格：通过修改
启动网关服务：
picoclaw gateway
如果是 Docker 安装，网关通常已经后台运行了。之后，你就可以在手机上随时随地和你的 AI 助手对话了。
在 ~/.picoclaw/config.json 文件中，找到 channels 部分，填入你创建的 Telegram Bot Token 和你的用户 ID。
{
"channels": {
"telegram": {
"enabled": true,
"token": "你的 Telegram Bot Token",
"allowFrom": ["你的 Telegram 用户 ID"]
}
}
}
交互式对话：进入连续的聊天模式。
picoclaw agent
一次性提问：适合快速查询。
picoclaw agent -m "介绍一下皮皮虾的特点"
Windows 编译说明
目前官方未提供详细的 Windows 源码编译指南，但 PicoClaw 是 Go 语言项目，可通过以下方式在 Windows 10 上获得：
方法一：从源码自行编译
确保你的 Windows 10 系统已安装 Go（推荐 1.16 及以上版本）。在项目根目录下执行 go build 命令，Go 会自动下载依赖并生成可执行文件。
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
go build -o picoclaw.exe
方法二：直接下载预编译版本（推荐）
如果主要是想使用 PicoClaw 而非参与源码开发，更简单的方法是直接下载官方提供的 Windows 预编译版本。
- 下载文件：从 PicoClaw 的 GitHub Releases 页面下载
picoclaw-windows-amd64.exe。 - 放置与重命名：将下载的文件放到一个方便的目录，例如
C:\picoclaw，并将其重命名为picoclaw.exe。 - 初始化工作区：在
picoclaw.exe所在目录打开命令提示符，运行picoclaw init命令生成配置文件和工作区。 - 配置 API 密钥：编辑生成的配置文件（默认路径为
C:\Users\你的用户名\.picoclaw\workspace\config.json），填入你的 LLM API 密钥（如 OpenAI、DeepSeek 或本地 Ollama）。 - 运行：最后，执行
picoclaw run即可开始使用。
实践参考
若使用 MSYS 环境编译，流程如下：
cd D:\AI\picoclaw-main
gmake deps
gmake build
rename picoclaw picoclaw.exe
picoclaw onboard
注意：具体路径请根据实际环境调整。
