picoclaw-ai-assistant

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

PicoClaw AI Assistant

PicoClaw AI助手

Skill by ara.so — Daily 2026 Skills collection.

PicoClaw is an ultra-lightweight personal AI assistant written in Go. It runs on $10 hardware with under 10MB RAM and boots in under 1 second. It supports multiple LLM providers (OpenAI-compatible, Anthropic, Volcengine), optional web search tools, and deploys as a single self-contained binary on x86_64, ARM64, MIPS, and RISC-V Linux devices.

由ara.so开发的Skill——属于Daily 2026 Skills合集。

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

Installation

安装

Precompiled Binary

预编译二进制文件

Download from the releases page:

bash

undefined

从发布页面下载：

bash

undefined

Linux ARM64 (Raspberry Pi, LicheeRV-Nano, etc.)

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

undefined

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

undefined

Build from Source

从源码构建

bash

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

bash

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

Install dependencies

安装依赖

make deps

Build for current platform

为当前平台构建

make build

Build for all platforms

为所有平台构建

make build-all

Raspberry Pi Zero 2 W — 32-bit

树莓派Zero 2 W — 32位

make build-linux-arm # → build/picoclaw-linux-arm

Raspberry Pi Zero 2 W — 64-bit

树莓派Zero 2 W — 64位

make build-linux-arm64 # → build/picoclaw-linux-arm64

Build both Pi Zero variants

构建两种树莓派Zero版本

make build-pi-zero

Build and install to system PATH

构建并安装到系统PATH

make install

undefined

make install

undefined

Docker Compose

bash

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

bash

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

First run — generates docker/data/config.json then exits

首次运行 — 生成docker/data/config.json后退出

docker compose -f docker/docker-compose.yml --profile gateway up

Edit config

编辑配置

vim docker/data/config.json

Start in background

后台启动

docker compose -f docker/docker-compose.yml --profile gateway up -d

View logs

查看日志

docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway

Stop

停止服务

docker compose -f docker/docker-compose.yml --profile gateway down

undefined

docker compose -f docker/docker-compose.yml --profile gateway down

undefined

Docker: Web Console (Launcher Mode)

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

bash

docker compose -f docker/docker-compose.yml --profile launcher up -d

bash

docker compose -f docker/docker-compose.yml --profile launcher up -d

Open http://localhost:18800

打开 http://localhost:18800

undefined

undefined

Docker: One-shot Agent Mode

Docker：一次性Agent模式

bash

undefined

bash

undefined

Single question

单问题查询

docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "What is 2+2?"

Interactive session

交互式会话

docker compose -f docker/docker-compose.yml run --rm picoclaw-agent

undefined

docker compose -f docker/docker-compose.yml run --rm picoclaw-agent

undefined

Docker: Expose Gateway to Host

Docker：将网关暴露给主机

If the gateway needs to be reachable from the host, set:

bash

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

Or set

PICOCLAW_GATEWAY_HOST=0.0.0.0

docker/data/config.json

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

bash

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)

Termux（Android）

bash

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

bash

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

Quick Start

快速开始

1. Initialize

1. 初始化

bash

picoclaw onboard

This creates

~/.picoclaw/config.json

with a starter configuration.

bash

picoclaw onboard

此命令会创建

~/.picoclaw/config.json

并生成初始配置。

2. Configure

~/.picoclaw/config.json

2. 配置

~/.picoclaw/config.json

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"
      }
    }
  }
}

Never hard-code API keys. Reference environment variables using
$VAR_NAME
notation in config, or set them in your shell environment before launch.

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. Run

3. 运行

bash

undefined

bash

undefined

Interactive chat

交互式聊天

picoclaw

Single message

单消息查询

picoclaw -m "Summarize the latest Go release notes"

picoclaw -m "总结最新的Go版本发布说明"

Use a specific model

使用指定模型

picoclaw -model claude-sonnet -m "Refactor this function for clarity"

---

picoclaw -model claude-sonnet -m "重构此函数以提升可读性"

---

Key CLI Commands

关键CLI命令

Command	Description
`picoclaw onboard`	Initialize config and workspace
`picoclaw`	Start interactive chat session
`picoclaw -m "..."`	Send a single message and exit
`picoclaw -model <name>`	Override the default model
`picoclaw -config <path>`	Use a custom config file

命令	描述
`picoclaw onboard`	初始化配置和工作区
`picoclaw`	启动交互式聊天会话
`picoclaw -m "..."`	发送单条消息后退出
`picoclaw -model <name>`	覆盖默认模型
`picoclaw -config <path>`	使用自定义配置文件

Configuration Reference

配置参考

Model Entry Fields

模型条目字段

json

{
  "model_name": "my-model",        // Alias used in -model flag and agent defaults
  "model": "provider/model-id",    // Provider-prefixed model identifier
  "api_key": "$ENV_VAR",           // API key — use env var reference
  "api_base": "https://...",       // Optional: override base URL (for self-hosted or regional endpoints)
  "request_timeout": 300           // Optional: seconds before timeout
}

json

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

Supported Provider Prefixes

支持的提供商前缀

Prefix	Provider
`openai/`	OpenAI and OpenAI-compatible APIs
`anthropic/`	Anthropic Claude
`volcengine/`	Volcengine (Ark)

前缀	提供商
`openai/`	OpenAI及兼容OpenAI的API
`anthropic/`	Anthropic Claude
`volcengine/`	火山引擎（Ark）

Agent Defaults

Agent默认配置

json

"agents": {
  "defaults": {
    "workspace": "~/.picoclaw/workspace",  // Working directory for file operations
    "model_name": "gpt-4o",                // Default model alias
    "max_tokens": 8192,                    // Max response tokens
    "temperature": 0.7,                    // Sampling temperature
    "max_tool_iterations": 20              // Max agentic tool-call loop iterations
  }
}

json

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

Web Search Tools

网页搜索工具

Get free API keys:

Tavily: https://tavily.com — 1,000 free queries/month
Brave Search: https://brave.com/search/api — 2,000 free queries/month

json

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

Only enable one search provider at a time unless you want fallback behavior.

获取免费API密钥：

Tavily: https://tavily.com — 每月1000次免费查询
Brave Search: https://brave.com/search/api — 每月2000次免费查询

json

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

除非需要 fallback 机制，否则一次仅启用一个搜索提供商。

Common Patterns

常见使用场景

Pattern: Minimal $10 Device Setup

场景：低成本10美元设备部署

For a LicheeRV-Nano or similar ultra-low-resource board:

bash

undefined

针对LicheeRV-Nano或类似超低资源板卡：

bash

undefined

Download the RISC-V or ARM binary from releases

从发布页面下载RISC-V或ARM版本的二进制文件

wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-riscv64 chmod +x picoclaw-linux-riscv64

Initialize

初始化

./picoclaw-linux-riscv64 onboard

Edit config — use a lightweight model, low max_tokens

编辑配置 — 使用轻量模型，设置较低的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

undefined

./picoclaw-linux-riscv64

undefined

Pattern: Full-Stack Dev Assistant with Web Search

场景：带网页搜索的全栈开发助手

json

{
  "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"
      }
    }
  }
}

json

{
  "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"
      }
    }
  }
}

Pattern: Docker with Environment Variables

场景：使用环境变量的Docker部署

yaml

undefined

yaml

undefined

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


```bash
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

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


```bash
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

Pattern: Build for a Specific Target in Go

场景：为特定目标构建Go版本

bash

undefined

bash

undefined

Cross-compile for MIPS (OpenWRT routers)

交叉编译为MIPS架构（OpenWRT路由器）

GOOS=linux GOARCH=mips GOMIPS=softfloat go build -o build/picoclaw-linux-mips ./cmd/picoclaw

Cross-compile for 32-bit ARM (older Raspberry Pi)

交叉编译为32位ARM（旧款树莓派）

GOOS=linux GOARCH=arm GOARM=7 go build -o build/picoclaw-linux-arm ./cmd/picoclaw

Cross-compile for RISC-V 64-bit

交叉编译为64位RISC-V

GOOS=linux GOARCH=riscv64 go build -o build/picoclaw-linux-riscv64 ./cmd/picoclaw

---

GOOS=linux GOARCH=riscv64 go build -o build/picoclaw-linux-riscv64 ./cmd/picoclaw

---

Troubleshooting

故障排除

Binary won't execute on device

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

bash

undefined

bash

undefined

Verify the binary matches the device architecture

验证二进制文件与设备架构匹配

file picoclaw-linux-arm64 uname -m # Should match: aarch64 = arm64, x86_64 = amd64

file picoclaw-linux-arm64 uname -m # 应匹配：aarch64 = arm64, x86_64 = amd64

Ensure executable permission

确保有可执行权限

chmod +x picoclaw-linux-arm64

undefined

chmod +x picoclaw-linux-arm64

undefined

"Permission denied" on Termux

Termux中出现“Permission denied”

Termux requires

proot

for some system calls:

bash

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

Termux的某些系统调用需要

proot

：

bash

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

API key not recognized

API密钥未被识别

Do not use
```
"api_key": "sk-..."
```
literals in config — set env vars and reference them as
```
"$OPENAI_API_KEY"
```
.
Verify the env var is exported in your current shell:
```
echo $OPENAI_API_KEY
```
.

请勿在配置中使用
```
"api_key": "sk-..."
```
这类硬编码值 — 请设置环境变量并以
```
"$OPENAI_API_KEY"
```
格式引用。
验证当前Shell中是否已导出环境变量：
```
echo $OPENAI_API_KEY
```
。

Docker gateway not reachable from host

Docker网关无法从主机访问

Set

PICOCLAW_GATEWAY_HOST=0.0.0.0

in the environment or in

config.json

before starting the container.

在环境变量或

config.json

中设置

PICOCLAW_GATEWAY_HOST=0.0.0.0

后再启动容器。

High memory usage in recent versions

新版本内存占用过高

The project notes that recent PRs may push RAM usage to 10–20MB. If this is a concern on ultra-low-memory devices, pin to an earlier release tag:

bash

git checkout v0.1.1
make build

项目说明提到近期PR可能会将内存占用推高至10–20MB。如果在超低内存设备上运行有问题，请固定到早期发布版本：

bash

git checkout v0.1.1
make build

Config file location

配置文件位置

Default:

~/.picoclaw/config.json

Override at runtime:

bash

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

默认位置：

~/.picoclaw/config.json

运行时可覆盖：

bash

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

Rebuild after dependency changes

依赖变更后重新构建

bash

cd picoclaw
make deps
make build

bash

cd picoclaw
make deps
make build

Hardware Targets Quick Reference

硬件目标快速参考

Device	Price	Binary
LicheeRV-Nano (E/W)	~$10	`picoclaw-linux-riscv64`
NanoKVM	~$30–50	`picoclaw-linux-riscv64`
MaixCAM / MaixCAM2	~$50–100	`picoclaw-linux-arm64`
Raspberry Pi Zero 2 W (32-bit OS)	~$15	`picoclaw-linux-arm`
Raspberry Pi Zero 2 W (64-bit OS)	~$15	`picoclaw-linux-arm64`
Android via Termux	—	`picoclaw-linux-arm64`
Standard Linux x86_64	—	`picoclaw-linux-amd64`

设备	价格	二进制文件
LicheeRV-Nano (E/W)	~10美元	`picoclaw-linux-riscv64`
NanoKVM	~30–50美元	`picoclaw-linux-riscv64`
MaixCAM / MaixCAM2	~50–100美元	`picoclaw-linux-arm64`
树莓派Zero 2 W（32位系统）	~15美元	`picoclaw-linux-arm`
树莓派Zero 2 W（64位系统）	~15美元	`picoclaw-linux-arm64`
Android（通过Termux）	—	`picoclaw-linux-arm64`
标准Linux x86_64	—	`picoclaw-linux-amd64`

picoclaw-ai-assistant

Original

Translation

PicoClaw AI Assistant

PicoClaw AI助手

Installation

安装

Precompiled Binary

预编译二进制文件

Linux ARM64 (Raspberry Pi, LicheeRV-Nano, etc.)

Linux ARM64（树莓派、LicheeRV-Nano等）

Build from Source

从源码构建

Install dependencies

安装依赖

Build for current platform

为当前平台构建

Build for all platforms

为所有平台构建

Raspberry Pi Zero 2 W — 32-bit

树莓派Zero 2 W — 32位

Raspberry Pi Zero 2 W — 64-bit

树莓派Zero 2 W — 64位

Build both Pi Zero variants

构建两种树莓派Zero版本

Build and install to system PATH

构建并安装到系统PATH

Docker Compose

Docker Compose

First run — generates docker/data/config.json then exits

首次运行 — 生成docker/data/config.json后退出

Edit config

编辑配置

Start in background

后台启动

View logs

查看日志

Stop

停止服务

Docker: Web Console (Launcher Mode)

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

Open http://localhost:18800

打开 http://localhost:18800

Docker: One-shot Agent Mode

Docker：一次性Agent模式

Single question

单问题查询

Interactive session

交互式会话

Docker: Expose Gateway to Host

Docker：将网关暴露给主机

Termux (Android)

Termux（Android）

Quick Start

快速开始

1. Initialize

1. 初始化

2. Configure ~/.picoclaw/config.json

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

3. Run

3. 运行

Interactive chat

交互式聊天

Single message

单消息查询

Use a specific model

使用指定模型

Key CLI Commands

关键CLI命令

Configuration Reference

配置参考

Model Entry Fields

模型条目字段

Supported Provider Prefixes

支持的提供商前缀

Agent Defaults

Agent默认配置

Web Search Tools

网页搜索工具

Common Patterns

2. Configure
`~/.picoclaw/config.json`

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