PicoClaw安装教程与使用说明详解

首页/AI教程/文章详情

PicoClaw安装教程与使用说明详解

时间：2026-08-17 10:48

PicoClaw是矽速科技用Go开发的超轻量AI助手，内存占用低于10MB，启动快速。它将大模型推理任务交由云端API处理，本地仅负责轻量级协调，可在嵌入式设备及普通电脑上运行。安装需编译后添加API密钥即可使用。

PicoClaw：一个超轻量级AI助手的安装与使用指南

PicoClaw 是一个超轻量级的个人 AI 助手，几乎能在任何设备上跑起来——从嵌入式开发板到普通电脑都行。它最抓人眼球的地方就是资源占用低得惊人，启动速度快得像闪电。下面就来详细拆解它的安装和使用方法。

? PicoClaw 简介

PicoClaw 由矽速科技（Sipeed）开发，用 Go 语言编写。它的核心思路是：把所有计算密集的大模型推理任务都甩给云端 API，本地只负责轻量级的协调工作。这样一来，资源占用自然就降下来了。

特性	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
# 编辑 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 这类平台搞到。
- （可选）想让它能联网查资料？再弄个免费的 Bra ve 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 助手聊天。
1. 在 ~/.picoclaw/config.json 中找到 channels 部分，填上你的 Telegram Bot Token 和用户 ID。
```
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "你的Telegram Bot Token",
      "allowFrom": ["你的Telegram用户ID"]
    }
  }
}
```
2. 启动网关服务：
```
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，按下面步骤来：

安装 Go 环境：确保系统已安装 Go（推荐 1.16 及以上版本）。

获取源码：

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

编译项目：在项目根目录下执行 go build，Go 会自动下载依赖并生成可执行文件。
```
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 就能开干了。

? 建议

如果编译时遇到问题，或者想了解更详细的配置（比如接入 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: