picoclaw项目的目标是在低资源设备上运行个人 AI 助手。重点是低内存占用、快速启动、单二进制跨架构分发（x86_64 / ARM64 / RISC-V）。

它提供两种运行形态：agent（本地命令行）和 gateway（消息通道接入）。

如果你熟悉 OpenClaw，这个仓库还给了 OpenClaw / NanoBot / PicoClaw 的资源与启动对照，说明其可以“在更小硬件上跑起来”。

OpenClaw NanoBot PicoClaw
Language TypeScript Python Go
RAM >1GB >100MB < 10MB
Startup (0.8GHz core) >500s >30s <1s
Cost Mac Mini 599$ Most Linux SBC ~50$ Any Linux Board As low as 10$

核心能力

  • 支持多种安装路径：预编译二进制、源码构建、Docker Compose。
  • 配置文件路径固定：~/.picoclaw/config.json。
  • QQ249″>支持 agent 一次性调用与 gateway 常驻运行。
  • gateway 可接入 Telegram、Discord、QQ、钉钉、LINE。
  • README 提供了各通道配置示例与接入步骤。

安装与使用

环境要求

  • Go 1.21+
  • 多架构支持（x86_64 / ARM64 / RISC-V）
  • Docker / Node / Python 版本：项目未明确

方式一：预编译二进制

# 从 release 页面下载对应平台固件/二进制
# https://github.com/sipeed/picoclaw/releases

方式二：源码构建（开发常用）

# 拉代码
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 安装依赖并构建
make deps
make build

# 安装到系统
make install

快速初始化与本地对话

# 初始化（会生成/准备配置）
picoclaw onboard

# 一次性提问
picoclaw agent -m "What is 2+2?"

# 交互模式（README 提供）
picoclaw agent

网关模式（接聊天通道）

# 启动网关
picoclaw gateway

Docker Compose 启动

# 拉代码
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 复制配置并填写 token / API key
cp config/config.example.json config/config.json
vim config/config.json

# 启动 gateway profile
docker compose --profile gateway up -d

# 查看日志
docker compose logs -f picoclaw-gateway

# 停止
docker compose --profile gateway down

Docker 下 agent 模式（README 示例）

# 一次性提问
docker compose run --rm picoclaw-agent -m "What is 2+2?"

# 交互模式
docker compose run --rm picoclaw-agent

配置Tips

  • 默认配置文件：~/.picoclaw/config.json
  • Quick Start 示例里包含：agents.defaults、providers、tools.web。
  • Web 搜索可选 Brave，也可启用 duckduckgo（README 示例有开关字段）。
  • 聊天通道配置在 channels 下，不同平台填各自 token/凭据。

CLI Reference

命令 作用
picoclaw onboard 初始化配置与工作区
picoclaw agent -m “…” 一次性提问
picoclaw agent 交互式对话
picoclaw gateway 启动网关（接聊天通道）
picoclaw status 查看运行状态
picoclaw cron list 查看定时任务
picoclaw cron add … 新增定时任务

项目资源