🚀 快速安装

复制以下命令并运行，立即安装此 Skill：

npx skills add https://skills.sh/aradotso/trending-skills/picoclaw-ai-assistant

💡 提示：需要 Node.js 和 NPM

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 命令

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

配置参考

模型条目字段

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

支持的提供商前缀

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

代理默认值

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

配置文件位置

默认：~/.picoclaw/config.json

运行时覆盖：

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

依赖项更改后重新构建

cd picoclaw
make deps
make build

硬件目标快速参考

设备	价格	二进制文件
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`
通过 Termux 的 Android	—	`picoclaw-linux-arm64`
标准 Linux x86_64	—	`picoclaw-linux-amd64`

📄 原始文档

完整文档（英文）：

https://skills.sh/aradotso/trending-skills/picoclaw-ai-assistant

💡 提示：点击上方链接查看 skills.sh 原始英文文档，方便对照翻译。

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。

PicoClaw AI Assistant

🚀 快速安装

PicoClaw AI 助手

安装

预编译二进制文件

从源码构建

Docker Compose

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

Docker: 单次代理模式

Docker: 向主机暴露网关

Termux (Android)

快速开始

1. 初始化

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

3. 运行

主要 CLI 命令

配置参考

模型条目字段

支持的提供商前缀

代理默认值

网络搜索工具

常见模式

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

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

模式：带环境变量的 Docker

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

故障排除

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

Termux 上出现“权限被拒绝”

API 密钥无法识别

Docker 网关无法从主机访问

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

配置文件位置

依赖项更改后重新构建

硬件目标快速参考

📄 原始文档

评论(0)

提示：请文明发言取消回复

PicoClaw AI Assistant

🚀 快速安装

PicoClaw AI 助手

安装

预编译二进制文件

从源码构建

Docker Compose

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

Docker: 单次代理模式

Docker: 向主机暴露网关

Termux (Android)

快速开始

1. 初始化

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

3. 运行

主要 CLI 命令

配置参考

模型条目字段

支持的提供商前缀

代理默认值

网络搜索工具

常见模式

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

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

模式：带环境变量的 Docker

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

故障排除

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

Termux 上出现“权限被拒绝”

API 密钥无法识别

Docker 网关无法从主机访问

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

配置文件位置

依赖项更改后重新构建

硬件目标快速参考

📄 原始文档

评论(0)

提示：请文明发言 取消回复

相关文章

uniapp-project – 汇易宝

nelson – 汇易宝

AI Agent Email Inbox

tomtat-video-jaskies – 汇易宝

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

提示：请文明发言取消回复