PicoClaw（皮皮虾）超轻量AI智能体安装&使用教程

前言

PicoClaw 代号皮皮虾 ，是一款主打极致轻量化的开源 AI Agent，运行内存低于10MB，无需 Python、Node.js 等重型运行环境，单二进制文件即可运行。它兼容 x86、ARM、RISC-V 等主流架构，百元级开发板、老旧设备都能流畅部署，同时支持对接主流大模型、QQ/飞书等多平台网关，是边缘设备、低配置主机搭建本地AI助手的首选方案。

本文从零讲解 环境准备、对应系统安装、基础配置、网关启用、日常使用 全流程，Windows、Linux、macOS、嵌入式开发板均可参考，新手也能一键上手。

一、前置说明与环境要求

1. 核心特点回顾

资源占用：运行内存＜10MB，磁盘占用极小
部署形式：独立可执行文件，无复杂依赖
支持架构：x86_64、ARM32/ARM64、RISC-V
网络要求：能正常访问大模型API接口
运行系统：Windows、Linux、macOS、嵌入式Linux（开发板）

2. 准备工作

提前准备好可用的大模型 API Key（OpenAI、DeepSeek、Kimi、MiniMax 等，兼容标准 OpenAI 接口格式）这里我用MiniMax演示
根据自身设备架构，下载对应版本的 PicoClaw 安装包（这里使用windows安装使用演示）
服务器/开发板有外网即可，无需额外端口映射（纯本地使用）

二、下载 PicoClaw 程序包

1. 获取程序包

官网下载地址：https://picoclaw.io/download/

官方下载对应架构的最新版本，有一定技术基础的可以使用源代码编译二进制使用。注意区分系统与硬件：

Windows：选择 windows-amd64 版本
macOS：选择 darwin-amd64 / darwin-arm64（M系列芯片）
Linux PC/服务器：linux-amd64
树莓派、开发板：linux-arm64 / linux-arm

2. 文件说明

下载后得到里面的 可执行文件，直接赋予权限即可运行，全程无捆绑、无多余组件。

三、分系统安装部署教程

（一）Windows 系统部署

以windows-amd64为示例。

官方下载后得到一个zip包，picoclaw_Windows_x86_64.zip，解压下载的zip包，得到里面的 可执行文件 ，直接赋予权限即可运行，全程无捆绑、无多余组件。

下载解压：picoclaw_Windows_x86_64.zip
进入文件夹，里面有可执行文件picoclaw-launcher.exe 这个是picoclaw启动引导程序，会打开web浏览器：http://localhost:18800/launcher-setup 要你设置密码登录。
直接双击 picoclaw-launcher.exe 运行，或在命令行执行：

cmd 复制代码

picoclaw-launcher.exe

程序启动后弹出命令行窗口，保持窗口开启即可正常使用；如需后台运行，可配置 Windows 服务实现常驻，或开启启动。
根据提示设置密码
输入设置好的密码进入主页
配置模型key,PicoClaw 本地不运行大模型，依靠调用云端 API 实现对话能力，模型配置是使用的核心 。
选择模型提供商并启动服务，就可以开始使用交流了

（三）macOS 系统部署

将 picoclaw 文件放置到自定义目录
打开终端，进入目录并赋予执行权限：

bash 复制代码

chmod +x picoclaw

首次运行如提示「无法验证开发者」，前往 系统设置-隐私与安全性，拉到最下方允许运行该程序。
启动命令：

bash 复制代码

./picoclaw

（二）Linux 系统（服务器/开发板/ WSL2 通用）

1. 上传/移动文件

将下载好的 picoclaw 可执行文件上传至设备任意目录，例如 /home/user/。

2. 赋予执行权限

打开终端，进入文件所在目录，执行命令：

bash 复制代码

chmod +x picoclaw

3. 启动测试

直接运行程序，验证是否安装成功：

bash 复制代码

./picoclaw

终端出现版本信息、启动日志，代表基础部署完成，按下 Ctrl+C 可临时停止程序。

4. 后台常驻运行（推荐）

关闭终端也能持续运行，搭配日志文件输出：

bash 复制代码

nohup ./picoclaw > picoclaw.log 2>&1 &

查看运行日志：

bash 复制代码

tail -f picoclaw.log

四、多平台（QQ/飞书接入）

PicoClaw 延续系列产品的网关能力，支持快速接入主流社交/办公软件，实现在线机器人对话。接入也很简单，在页面上配置下就可以快速接入。

根据需求选择 QQ / 飞书 等平台，按照指引录入平台密钥、账号信息：

QQ：填写机器人 BotID、AppSecret（QQ开放平台获取）
飞书：填写应用 AppID、AppSecret、权限

五、常用管理命令汇总

日常运维、重启、重置配置可直接使用以下指令，全平台通用：

查看版本

bash 复制代码

./picoclaw version

重启服务
先结束进程，再重新启动：

bash 复制代码

# 查找进程
ps -ef | grep picoclaw
# 结束进程
kill -9 进程ID
# 重新启动
./picoclaw

完全卸载
直接删除程序文件、日志文件、配置文件即可，无残留。

六、适用场景总结

嵌入式/边缘设备：部署在树莓派、RISC-V开发板，打造7×24小时常驻AI助手；
低配置主机：老旧电脑、迷你主机使用，不占用系统资源；
个人机器人：对接QQ、飞书，实现日常问答、消息提醒、自动化交互；
开发测试：轻量化调试AI网关、模型对接流程，替代重型Agent方案。

七、最后

PicoClaw 凭借 <10MB 内存占用、零依赖、跨架构 的优势，大幅降低了 AI Agent 的部署门槛。不管是专业开发者做边缘AI开发，还是普通用户搭建个人机器人，它都是轻量化场景下的优质选择。

欢迎关注，后面持续更新AI智能体工具。

PicoClaw（皮皮虾）超轻量AI智能体 安装&使用教程