什么是 PicoClaw？

PicoClaw 是一个超轻量级的个人 AI 助手，用 Go 语言编写，灵感来源于 nanobot。它专为在资源受限的硬件上运行而设计，让你能在 $10 的开发板或内存小于 10MB 的设备上体验 AI 的强大功能。

核心特点

PicoClaw 能做什么？

1. 智能对话

• 自然语言交互，理解上下文
• 支持多种大语言模型
• 记住重要的对话内容

2. 网络功能

• 🌐 网页搜索和信息获取
• 📰 抓取网页内容并总结
• 🌤️ 天气查询

3. 文件与系统操作

• 📁 文件读写、编辑、管理
• ⚡ 执行 shell 命令
• 📝 代码编辑和项目管理

4. 消息与通知

• 📨 多平台消息发送
• ⏰ 定时提醒和任务调度
• 📎 文件传输

5. 技能扩展

• 🔌 可安装各种技能插件
• 🛠️ 支持自定义技能开发
• 📚 已有技能：GitHub 操作、图像生成、硬件控制等

硬件要求

PicoClaw 的硬件要求极低，几乎任何设备都能运行：

支持的设备示例：

• 🔶 Sipeed 系列：LicheeRV Nano、MaixCAM、NanoKVM
• 🍓 Raspberry Pi Zero/Zero 2 W
• 💻 任何 Linux 服务器/VPS
• 🖥️ Windows/Mac 开发环境

快速部署指南

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

1. 下载 PicoClaw

# 从 GitHub 下载最新版本
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-amd64

# 赋予执行权限
chmod +x picoclaw-linux-amd64

# 移动到系统目录（可选）
sudo mv picoclaw-linux-amd64 /usr/local/bin/picoclaw

2. 创建工作目录

# 创建工作目录
mkdir -p ~/.picoclaw/workspace
cd ~/.picoclaw/workspace

# 创建配置文件目录
mkdir -p memory skills

3. 创建配置文件

创建 config.yaml：

# 服务配置
server:
  host: "0.0.0.0"
  port: 8080

# 日志配置
log:
  level: "info"  # debug, info, warn, error

# LLM 配置 - 支持多种提供商
llm:
  # 使用 OpenAI
  provider: "openai"
  api_key: "your-openai-api-key"
  model: "gpt-4o-mini"
  base_url: "https://api.openai.com/v1"

  # 或使用 Anthropic Claude
  # provider: "anthropic"
  # api_key: "your-anthropic-api-key"
  # model: "claude-3-5-sonnet"

  # 或使用 Zhipu AI（国内）
  # provider: "zhipu"
  # api_key: "your-zhipu-api-key"
  # model: "glm-4-flash"

# 消息通道配置（可选）
channels:
  telegram:
    enabled: true
    bot_token: "your-telegram-bot-token"

# 技能配置
skills:
  directory: "./skills"

4. 启动 PicoClaw

picoclaw -c config.yaml

看到以下输出表示启动成功：

🦞 PicoClaw v0.2.3 started!
Server running on http://0.0.0.0:8080

方式二：从源码编译

如果你希望自定义功能或贡献代码：

1. 安装依赖

# 安装 Go 1.22+
# 访问 https://go.dev/dl/ 下载适合你系统的版本

# 验证安装
go version

2. 克隆仓库

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

3. 编译

# 编译当前平台
make build

# 或交叉编译其他平台
make build-linux-arm64
make build-windows

4. 运行

./picoclaw -c config.yaml

方式三：Docker 部署

# 拉取镜像
docker pull sipeed/picoclaw:latest

# 运行容器
docker run -d \
  --name picoclaw \
  -p 8080:8080 \
  -v $(pwd)/config.yaml:/app/config.yaml \
  -v $(pwd)/workspace:/app/workspace \
  sipeed/picoclaw:latest

使用技巧

1. 安装技能

PicoClaw 支持通过技能扩展功能：

# 查找可用技能
# 在对话中输入：帮我查找天气相关的技能

# 安装技能后可以使用：
# "北京今天天气怎么样？"
# "帮我总结这篇文章 https://example.com/article"

2. 定时任务

# 设置提醒
"10分钟后提醒我喝水"

# 定时任务
"每天早上9点发送天气给我"

3. 文件操作

# 读取文件
"读取 /path/to/file.txt 的内容"

# 编辑文件
"在 config.yaml 中添加 debug 模式"

4. 系统管理

# 执行命令
"查看当前磁盘使用情况"

# 监控系统
"监控 CPU 和内存使用率"

进阶配置

添加自定义技能

1. 在 skills/ 目录下创建技能文件夹
2. 编写 SKILL.md 描述技能功能
3. 添加必要的脚本和配置文件

多 LLM 配置

llm:
  # 主模型
  provider: "openai"
  api_key: "${OPENAI_API_KEY}"

  # 备用模型（主模型失败时自动切换）
  fallback:
    provider: "zhipu"
    api_key: "${ZHIPU_API_KEY}"

内存优化

对于极低配设备：

llm:
  max_context: 2000      # 限制上下文长度
  max_tokens: 500        # 限制输出长度

log:
  level: "warn"          # 减少日志输出

常见问题

Q: 启动时报错 "API key not found"？
A: 检查 config.yaml 中的 api_key 是否正确配置，或设置对应的环境变量。

Q: 如何更新 PicoClaw？
A: 下载新版本二进制文件替换旧版本即可，配置文件通常兼容。

Q: 支持哪些操作系统？
A: Linux、macOS、Windows 都支持，ARM 和 x86 架构均可。

Q: 内存占用真的那么低吗？
A: 是的，核心服务内存占用约 5-10MB，实际占用取决于加载的技能和并发量。

社区与支持

• 📖 文档: https://github.com/sipeed/picoclaw/wiki
• 🐛 Issues: https://github.com/sipeed/picoclaw/issues
• 💬 Discussions: https://github.com/sipeed/picoclaw/discussions
• 🌟 Star: 如果对你有帮助，请给项目点个 Star！

结语

PicoClaw 证明了 AI 助手不需要昂贵的硬件和复杂的配置。每一个比特都很重要，每一个比特都有价值。

无论你是想在 $10 的开发板上运行 AI，还是寻找一个轻量级的个人助手，PicoClaw 都是一个值得尝试的选择。

现在就动手部署属于你的 PicoClaw 吧！🦞

PicoClaw - 轻量、快速、你的个人 AI 助手

"Every bit helps, every bit matters."