PicoClaw 是一个超轻量级的个人 AI 助手，可以用在从嵌入式开发板到普通电脑的各类设备上。它最吸引人的特点就是极低的资源占用和飞快的启动速度。下面我来为你详细介绍它的安装和使用方法。
📖 PicoClaw 简介
PicoClaw 由矽速科技（Sipeed）开发，使用 Go 语言编写。它的核心优势在于，通过将计算密集的大模型推理任务交给云端 API，本地只负责轻量的协调工作，从而实现了惊人的轻量化。
| 编程语言 | 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
# 编辑 config.json 文件，填入你的 LLM API Key 等信息
vim config/config.json# 3. 使用 Docker Compose 启动网关服务
docker compose –profile gateway up -d
⚙️ 配置 PicoClaw
安装完成后，需要进行初始化和配置。
初始化：运行以下命令，它会在你的用户目录下创建 ~/.picoclaw/ 文件夹和默认配置文件。
picoclaw onboard
配置文件：编辑 ~/.picoclaw/config.json 文件，这是核心步骤。你需要至少配置一个 LLM 提供商（如智谱、OpenRouter）的 API Key。
- 获取 API Key：可以从 智谱 AI、OpenRouter 等平台获取。
- （可选）配置网络搜索：如果想让它能联网查资料，可以获取一个免费的 Brave Search 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"
}
}
}
🚀 使用场景
配置好之后，你就可以用多种方式和你的 AI 助手交互了。
-
💬 本地命令行对话
- 一次性提问：适合快速查询。picoclaw agent -m "介绍一下皮皮虾的特点"
- 交互式对话：进入连续的聊天模式。picoclaw agent
-
🤖 接入聊天平台（网关模式） 这是 PicoClaw 最实用的功能之一，可以让你通过 Telegram、Discord 等日常 App 与 AI 助手聊天。
- 在 ~/.picoclaw/config.json 文件中，找到 channels 部分，填入你创建的 Telegram Bot Token 和你的用户 ID。{
"channels": {
"telegram": {
"enabled": true,
"token": "你的Telegram Bot Token",
"allowFrom": ["你的Telegram用户ID"]
}
}
} - 启动网关服务：picoclaw gateway
如果是 Docker 安装，网关通常已经后台运行了。之后，你就可以在手机上随时随地和你的 AI 助手对话了。 -
⏰ 高级功能：定时任务与个性化
- 定时任务（cron）：你可以设置让助手定时执行任务，比如每天早上9点提醒你今天的日程。picoclaw cron add –message "提醒我今天的重要会议" –cron "0 9 * * 1-5"
- 自定义人格：通过修改 ~/.picoclaw/workspace/ 下的 AGENTS.md 或 SOUL.md 文件，可以用自然语言定义助手的性格、技能和行为准则，无需编写代码。
希望这份指南能帮你顺利上手 PicoClaw。
AI agent : picoclaw 在 Win 10 上如何编译?
我查阅了相关资料，目前还没有找到关于在 Windows 10 上从源码编译 PicoClaw 的官方指南。
不过，PicoClaw 是一个用 Go 语言编写的项目，它会编译成一个单一的可执行文件 。因此，你可以通过以下两种方式在 Windows 10 上获得它：
🛠️ 方法一：从源码自行编译（通用方法）
如果你的目标确实是自行编译，可以尝试标准的 Go 语言编译流程。由于 PicoClaw 的项目结构包含 go.mod 文件，编译过程应该比较直接。
你可以打开命令提示符或 PowerShell，执行以下步骤：
cd picoclaw
⚡ 方法二：直接下载预编译版本（推荐）
如果你主要是想使用 PicoClaw 而非参与源码开发，更简单的方法是直接下载官方提供的 Windows 预编译版本。根据相关资料，PicoClaw 提供了 Windows 的二进制文件 。
💡 建议
如果你在编译过程中遇到任何问题，或者想了解更详细的配置方法（比如如何接入 Telegram 或配置本地 Ollama），可以查阅我找到的这份完整指南 。另外，建议去 PicoClaw 的官方 GitHub 仓库看看，通常 README.md 或 CONTRIBUTING.md 文件里会包含最权威的编译说明。
你是想参与开发所以需要编译，还是主要为了使用它？如果是后者，直接下载编译好的版本会省事很多。
我的实践经验
先下载 go1.25.x.windows-amd64.msi , 然后安装。 where go D:\\Go\\bin\\go.exe where gmake D:\\Strawberry\\c\\bin\\gmake.exe D: cd D:\\AI\\picoclaw-main D:\\AI\\picoclaw-main> gmake deps all modules verified D:\\AI\\picoclaw-main> gmake build Run generate… Run generate complete Building picoclaw for MSYS_NT-10.0/x86_64… … github.com/sipeed/picoclaw/pkg/tools github.com/sipeed/picoclaw/pkg/heartbeat github.com/sipeed/picoclaw/pkg/agent github.com/sipeed/picoclaw/cmd/picoclaw Build complete: build/picoclaw-MSYS_NT-10.0-x86_64
D:\\AI\\picoclaw-main> cd build D:\\AI\\picoclaw-main\\build> dir 2026/02/20 00:11 17,773,056 picoclaw 2026/02/20 00:11 17,773,056 picoclaw-MSYS_NT-10.0-x86_64 rename picoclaw picoclaw.exe
D:\\AI\\picoclaw-main\\build> picoclaw onboard 🦞 picoclaw is ready!
Next steps:
