PicoClaw在树莓派上安装和使用

PicoClaw 是一个超轻量级的个人 AI 助手，使用 Go 语言编写，可以在极低资源的硬件上运行。它占用不到 10MB 的内存，可以在 10 美元的树莓派或其他经济实惠的设备上运行。本文将介绍如何在树莓派上安装和使用 PicoClaw。

官方资源： - PicoClaw GitHub - PicoClaw 官网 - PicoClaw 教程

什么是 PicoClaw？

PicoClaw 是一个超轻量级的个人 AI 助手，具有以下特点：

• 极低资源占用 - 内存占用不到 10MB
• 快速启动 - 启动时间不到 1 秒
• 跨平台支持 - 支持 Linux、macOS、Windows
• 开源免费 - 100% 免费和开源
• 多 LLM 支持 - 支持 OpenRouter、Anthropic、OpenAI、Gemini、DeepSeek 等
• 消息平台集成 - 支持 Telegram、Discord、QQ 等
• 内置任务调度 - 支持 cron 定时任务

系统要求

PicoClaw 对硬件要求极低，非常适合树莓派：

• 最低内存：64MB（推荐 512MB）
• CPU：单核 0.6GHz 即可
• 支持型号：树莓派 Zero 及更新型号
• 架构：ARM64（树莓派 3B+ 及以上）

安装方法

方法一：使用预编译二进制文件（推荐）⭐

这是最简单快速的安装方式。

步骤 1：下载二进制文件

访问 PicoClaw GitHub Releases 页面，下载适合树莓派的版本：

• 树莓派 3B+ 及以上（ARM64）：picoclaw-linux-arm64
• 树莓派 Zero/Zero W（ARMv6）：picoclaw-linux-armv6（如果可用）

使用 wget 下载：

# 树莓派 3B+ 及以上
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-arm64

# 或者树莓派 Zero
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-armv6

步骤 2：赋予执行权限

chmod +x picoclaw-linux-arm64

步骤 3：移动到系统路径（可选）

sudo mv picoclaw-linux-arm64 /usr/local/bin/picoclaw

或者保留在当前目录，使用完整路径运行：

./picoclaw-linux-arm64

步骤 4：验证安装

picoclaw --version
# 或
./picoclaw-linux-arm64 --version

方法二：从源码编译安装

如果你需要自定义编译选项或想要最新版本，可以从源码编译：

步骤 1：安装 Go 语言环境

# 更新系统
sudo apt update
sudo apt upgrade -y

# 安装 Go（如果未安装）
sudo apt install golang-go -y

# 验证 Go 安装
go version

步骤 2：克隆仓库

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

步骤 3：编译

# 编译 ARM64 版本（树莓派 3B+ 及以上）
GOARCH=arm64 GOOS=linux go build -o picoclaw

# 或编译 ARMv6 版本（树莓派 Zero）
GOARCH=arm GOOS=linux go build -o picoclaw

步骤 4：安装

sudo cp picoclaw /usr/local/bin/
sudo chmod +x /usr/local/bin/picoclaw

初始化配置

安装完成后，需要初始化配置：

步骤 1：运行初始化命令

picoclaw onboard
# 或
picoclaw init

这会创建以下目录和文件：

• ~/.picoclaw/config.json - 主配置文件
• ~/.picoclaw/workspace/ - 工作目录

步骤 2：配置 LLM 提供商

编辑配置文件 ~/.picoclaw/config.json：

nano ~/.picoclaw/config.json

配置示例：

{
  "llm": {
    "provider": "openrouter",
    "api_key": "your-api-key-here",
    "model": "anthropic/claude-3-haiku",
    "base_url": "https://openrouter.ai/api/v1"
  },
  "workspace": {
    "path": "~/.picoclaw/workspace"
  }
}

支持的 LLM 提供商：

• OpenRouter - 支持多个模型，推荐
• Anthropic - Claude 系列
• OpenAI - GPT 系列
• Google Gemini - Gemini 系列
• DeepSeek - DeepSeek 系列

配置示例（不同提供商）：

// Anthropic
{
  "llm": {
    "provider": "anthropic",
    "api_key": "sk-ant-...",
    "model": "claude-3-haiku-20240307"
  }
}

// OpenAI
{
  "llm": {
    "provider": "openai",
    "api_key": "sk-...",
    "model": "gpt-4o-mini"
  }
}

// DeepSeek
{
  "llm": {
    "provider": "deepseek",
    "api_key": "sk-...",
    "model": "deepseek-chat",
    "base_url": "https://api.deepseek.com/v1"
  }
}

基本使用

交互式对话

启动交互式对话模式：

picoclaw agent

这会启动一个交互式会话，你可以直接与 AI 对话。

单次查询

发送单条消息：

picoclaw agent -m "你好，介绍一下你自己"

查看帮助

picoclaw --help
picoclaw agent --help

高级功能

1. 消息平台集成

PicoClaw 支持集成多个消息平台：

Telegram 集成：

1. 创建 Telegram Bot：

   • 与 @BotFather 对话
   • 发送 /newbot 创建新机器人
   • 获取 Bot Token

2. 配置 PicoClaw：

编辑 ~/.picoclaw/config.json：

{
  "integrations": {
    "telegram": {
      "enabled": true,
      "bot_token": "your-bot-token",
      "chat_id": "your-chat-id"
    }
  }
}

1. 启动 Telegram 集成：

picoclaw telegram

Discord 集成：

1. 创建 Discord Bot：

   • 访问 Discord Developer Portal
   • 创建新应用和机器人
   • 获取 Bot Token

2. 配置：

{
  "integrations": {
    "discord": {
      "enabled": true,
      "bot_token": "your-discord-bot-token"
    }
  }
}

1. 启动：

picoclaw discord

2. 定时任务（Cron）

PicoClaw 内置了 cron 支持，可以定时执行任务：

创建定时任务：

编辑 ~/.picoclaw/crontab：

# 每天上午 9 点发送天气信息
0 9 * * * picoclaw agent -m "今天天气怎么样？"

启动 cron 服务：

picoclaw cron

3. 本地 AI 模型支持（Ollama）

如果你想使用本地 AI 模型而不依赖付费 API，可以结合 Ollama：

步骤 1：安装 Ollama

curl -fsSL https://ollama.com/install.sh | sh

步骤 2：下载模型

# 下载一个轻量级模型
ollama pull llama3.2:1b

步骤 3：配置 PicoClaw

编辑 ~/.picoclaw/config.json：

{
  "llm": {
    "provider": "openai",
    "api_key": "ollama",
    "model": "llama3.2:1b",
    "base_url": "http://localhost:11434/v1"
  }
}

步骤 4：使用

picoclaw agent -m "你好"

系统服务配置（可选）

如果你想让 PicoClaw 在系统启动时自动运行，可以配置为 systemd 服务：

步骤 1：创建服务文件

sudo nano /etc/systemd/system/picoclaw.service

步骤 2：添加服务配置

[Unit]
Description=PicoClaw AI Assistant
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi
ExecStart=/usr/local/bin/picoclaw agent
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

步骤 3：启用并启动服务

sudo systemctl daemon-reload
sudo systemctl enable picoclaw
sudo systemctl start picoclaw

步骤 4：查看服务状态

sudo systemctl status picoclaw

性能优化

1. 使用轻量级模型

对于树莓派，推荐使用轻量级模型：

• Claude Haiku - 快速且成本低
• GPT-4o-mini - OpenAI 的轻量级模型
• DeepSeek Chat - 性价比高
• 本地模型 - 使用 Ollama 运行本地模型

2. 限制并发请求

编辑配置文件，限制并发：

{
  "llm": {
    "max_concurrent_requests": 1,
    "timeout": 30
  }
}

3. 监控资源使用

# 查看内存使用
free -h

# 查看 CPU 使用
top

# 查看进程
ps aux | grep picoclaw

常见问题

Q: 启动时提示找不到命令？

A: 确保已将二进制文件移动到系统路径，或使用完整路径运行：

# 检查是否在 PATH 中
which picoclaw

# 如果不在，添加到 PATH
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc
source ~/.bashrc

Q: API 调用失败？

A: 检查以下几点：

1. API 密钥是否正确
2. 网络连接是否正常
3. API 提供商是否可访问（可能需要代理）
4. 配置文件格式是否正确

# 测试网络连接
curl https://api.openrouter.ai/api/v1/models

# 检查配置文件
cat ~/.picoclaw/config.json | python3 -m json.tool

Q: 内存不足？

A: PicoClaw 本身占用很少内存，但如果使用本地模型（Ollama），可能需要更多内存：

1. 使用更小的模型
2. 增加交换空间（swap）
3. 关闭不必要的服务

# 增加交换空间
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# 修改 CONF_SWAPSIZE=2048
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

Q: 如何更新 PicoClaw？

A:

# 如果使用二进制文件
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
sudo mv picoclaw-linux-arm64 /usr/local/bin/picoclaw

# 如果从源码编译
cd picoclaw
git pull
go build -o picoclaw
sudo cp picoclaw /usr/local/bin/

实际应用示例

示例 1：简单的问答助手

# 启动交互式对话
picoclaw agent

# 或单次查询
picoclaw agent -m "帮我写一个 Python 函数来计算斐波那契数列"

示例 2：定时任务

创建定时任务文件 ~/.picoclaw/crontab：

# 每天早上 8 点获取新闻摘要
0 8 * * * picoclaw agent -m "给我总结一下今天的科技新闻"

启动 cron：

picoclaw cron

示例 3：Telegram 机器人

配置 Telegram 集成后：

# 启动 Telegram 机器人
picoclaw telegram

然后可以通过 Telegram 与 AI 对话。

总结

PicoClaw 是一个非常适合树莓派的超轻量级 AI 助手，具有以下优势：

• 极低资源占用 - 不到 10MB 内存
• 快速启动 - 不到 1 秒
• 易于安装 - 简单的二进制文件或源码编译
• 功能丰富 - 支持多种 LLM、消息平台集成、定时任务
• 开源免费 - 完全开源

关键要点： 1. 下载适合树莓派架构的二进制文件 2. 运行 picoclaw onboard 初始化配置 3. 配置 LLM 提供商的 API 密钥 4. 使用 picoclaw agent 开始对话 5. 可选配置消息平台集成和定时任务

相关资源： - PicoClaw GitHub：https://github.com/sipeed/picoclaw - PicoClaw 官网：https://picoclaw.net/ - PicoClaw 教程：https://picoclaw.online/guide/introduction.html - Ollama：https://ollama.com/（用于本地 AI 模型）

---

注意：PicoClaw 是一个活跃开发的项目，功能和 API 可能会随时间变化。建议关注 GitHub 仓库以了解最新更新。