PicoClaw AI 助手

技能来自 ara.so — 每日 2026 技能合集。

PicoClaw 是一个用 Go 编写的超轻量级个人 AI 助手。它可以在 10 美元硬件上运行，内存占用低于 10MB，启动时间不到 1 秒。它支持多个 LLM 提供商（兼容 OpenAI 的接口、Anthropic、火山引擎），可选的网络搜索工具，并可作为单个独立二进制文件部署在 x86_64、ARM64、MIPS 和 RISC-V Linux 设备上。

安装

预编译二进制文件

从 发布页面 下载：

# Linux ARM64 (树莓派、LicheeRV-Nano 等)
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
./picoclaw-linux-arm64 onboard

从源码构建

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

# 安装依赖
make deps

# 为当前平台构建
make build

# 为所有平台构建
make build-all

# 树莓派 Zero 2 W — 32 位
make build-linux-arm      # → build/picoclaw-linux-arm

# 树莓派 Zero 2 W — 64 位
make build-linux-arm64    # → build/picoclaw-linux-arm64

# 构建两种 Pi Zero 变体
make build-pi-zero

# 构建并安装到系统 PATH
make install

Docker Compose

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

# 首次运行 — 生成 docker/data/config.json 然后退出
docker compose -f docker/docker-compose.yml --profile gateway up

# 编辑配置
vim docker/data/config.json

# 后台启动
docker compose -f docker/docker-compose.yml --profile gateway up -d

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

# 停止
docker compose -f docker/docker-compose.yml --profile gateway down

Docker: Web 控制台（启动器模式）

docker compose -f docker/docker-compose.yml --profile launcher up -d
# 打开 http://localhost:18800

Docker: 单次代理模式

# 单次提问
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "What is 2+2?"

# 交互式会话
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent

Docker: 向主机暴露网关

如果网关需要从主机访问，设置：

PICOCLAW_GATEWAY_HOST=0.0.0.0 docker compose -f docker/docker-compose.yml --profile gateway up -d

或在 docker/data/config.json 中设置 PICOCLAW_GATEWAY_HOST=0.0.0.0。

Termux (Android)

pkg install wget proot
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
termux-chroot ./picoclaw-linux-arm64 onboard

快速开始

1. 初始化

picoclaw onboard

这会在 ~/.picoclaw/config.json 中创建一个初始配置。

2. 配置 ~/.picoclaw/config.json

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt-4o",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "model_list": [
    {
      "model_name": "gpt-4o",
      "model": "openai/gpt-4o",
      "api_key": "$OPENAI_API_KEY",
      "request_timeout": 300
    },
    {
      "model_name": "claude-sonnet",
      "model": "anthropic/claude-sonnet-4-5",
      "api_key": "$ANTHROPIC_API_KEY"
    },
    {
      "model_name": "ark-code",
      "model": "volcengine/ark-code-latest",
      "api_key": "$VOLCENGINE_API_KEY",
      "api_base": "https://ark.cn-beijing.volces.com/api/coding/v3"
    }
  ],
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "$BRAVE_API_KEY"
      },
      "tavily": {
        "enabled": false,
        "api_key": "$TAVILY_API_KEY"
      }
    }
  }
}

切勿硬编码 API 密钥。在配置中使用 $VAR_NAME 符号引用环境变量，或在启动前在 shell 环境中设置它们。

3. 运行

# 交互式聊天
picoclaw

# 单条消息
picoclaw -m "Summarize the latest Go release notes"

# 使用特定模型
picoclaw -model claude-sonnet -m "Refactor this function for clarity"

主要 CLI 命令

配置参考

模型条目字段

{
  "model_name": "my-model",        // 在 -model 标志和代理默认值中使用的别名
  "model": "provider/model-id",    // 带提供商前缀的模型标识符
  "api_key": "$ENV_VAR",           // API 密钥 — 使用环境变量引用
  "api_base": "https://...",       // 可选：覆盖基础 URL（用于自托管或区域端点）
  "request_timeout": 300           // 可选：超时前的秒数
}

支持的提供商前缀

代理默认值

"agents": {
  "defaults": {
    "workspace": "~/.picoclaw/workspace",  // 文件操作的工作目录
    "model_name": "gpt-4o",                // 默认模型别名
    "max_tokens": 8192,                    // 最大响应令牌数
    "temperature": 0.7,                    // 采样温度
    "max_tool_iterations": 20              // 最大代理工具调用循环迭代次数
  }
}

网络搜索工具

获取免费 API 密钥：

• Tavily: https://tavily.com — 每月 1,000 次免费查询
• Brave Search: https://brave.com/search/api — 每月 2,000 次免费查询

"tools": {
  "web": {
    "tavily": {
      "enabled": true,
      "api_key": "$TAVILY_API_KEY"
    },
    "brave": {
      "enabled": false,
      "api_key": "$BRAVE_API_KEY"
    }
  }
}

一次只启用一个搜索提供商，除非你想要回退行为。

常见模式

模式：10 美元设备的最小设置

对于 LicheeRV-Nano 或类似的超低资源板：

# 从发布页面下载 RISC-V 或 ARM 二进制文件
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-riscv64
chmod +x picoclaw-linux-riscv64

# 初始化
./picoclaw-linux-riscv64 onboard

# 编辑配置 — 使用轻量级模型，较低的 max_tokens
cat > ~/.picoclaw/config.json << 'EOF'
{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt-4o-mini",
      "max_tokens": 2048,
      "temperature": 0.5,
      "max_tool_iterations": 10
    }
  },
  "model_list": [
    {
      "model_name": "gpt-4o-mini",
      "model": "openai/gpt-4o-mini",
      "api_key": "$OPENAI_API_KEY",
      "request_timeout": 120
    }
  ]
}
EOF

./picoclaw-linux-riscv64

模式：带网络搜索的全栈开发助手

{
  "agents": {
    "defaults": {
      "workspace": "~/projects",
      "model_name": "claude-sonnet",
      "max_tokens": 8192,
      "temperature": 0.3,
      "max_tool_iterations": 30
    }
  },
  "model_list": [
    {
      "model_name": "claude-sonnet",
      "model": "anthropic/claude-sonnet-4-5",
      "api_key": "$ANTHROPIC_API_KEY",
      "request_timeout": 600
    }
  ],
  "tools": {
    "web": {
      "tavily": {
        "enabled": true,
        "api_key": "$TAVILY_API_KEY"
      }
    }
  }
}

模式：带环境变量的 Docker

# docker/docker-compose.override.yml
services:
  picoclaw-gateway:
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - TAVILY_API_KEY=${TAVILY_API_KEY}
      - PICOCLAW_GATEWAY_HOST=0.0.0.0

export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
docker compose -f docker/docker-compose.yml -f docker/docker-compose.override.yml --profile gateway up -d

模式：为 Go 中的特定目标构建

# 为 MIPS 交叉编译 (OpenWRT 路由器)
GOOS=linux GOARCH=mips GOMIPS=softfloat go build -o build/picoclaw-linux-mips ./cmd/picoclaw

# 为 32 位 ARM 交叉编译 (旧版树莓派)
GOOS=linux GOARCH=arm GOARM=7 go build -o build/picoclaw-linux-arm ./cmd/picoclaw

# 为 RISC-V 64 位交叉编译
GOOS=linux GOARCH=riscv64 go build -o build/picoclaw-linux-riscv64 ./cmd/picoclaw

故障排除

二进制文件无法在设备上执行

# 验证二进制文件与设备架构匹配
file picoclaw-linux-arm64
uname -m   # 应匹配: aarch64 = arm64, x86_64 = amd64

# 确保可执行权限
chmod +x picoclaw-linux-arm64

Termux 上出现“权限被拒绝”

Termux 需要 proot 来执行某些系统调用：

pkg install proot
termux-chroot ./picoclaw-linux-arm64 onboard

API 密钥无法识别

• 不要在配置中使用 "api_key": "sk-..." 字面量 — 设置环境变量并在配置中引用为 "$OPENAI_API_KEY"。
• 验证环境变量已在当前 shell 中导出：echo $OPENAI_API_KEY。

Docker 网关无法从主机访问

在启动容器之前，在环境或 config.json 中设置 PICOCLAW_GATEWAY_HOST=0.0.0.0。

最新版本中内存使用量较高

项目说明最近的 PR 可能将 RAM 使用量推高到 10–20MB。如果这在超低内存设备上是个问题，请固定到较早的发布标签：

git checkout v0.1.1
make build

配置文件位置

默认：~/.picoclaw/config.json

运行时覆盖：

picoclaw -config /path/to/custom-config.json

依赖项更改后重新构建

cd picoclaw
make deps
make build

硬件目标快速参考