首页/资讯中心/详情

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

PicoClaw（皮皮虾）超轻量AI智能体 安装使用教程
📅 发布时间：2026/7/19 7:11:17

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. 准备工作

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

二、下载 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包，得到里面的可执行文件，直接赋予权限即可运行，全程无捆绑、无多余组件。

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

  1. 程序启动后弹出命令行窗口，保持窗口开启即可正常使用；如需后台运行，可配置 Windows 服务实现常驻，或开启启动。

  2. 根据提示设置密码

  3. 输入设置好的密码进入主页

  4. 配置模型key,PicoClaw 本地不运行大模型，依靠调用云端 API 实现对话能力，模型配置是使用的核心。

  5. 选择模型提供商并启动服务，就可以开始使用交流了


（三）macOS 系统部署

  1. 将picoclaw文件放置到自定义目录
  2. 打开终端，进入目录并赋予执行权限：
chmod+x picoclaw
  1. 首次运行如提示「无法验证开发者」，前往系统设置-隐私与安全性，拉到最下方允许运行该程序。
  2. 启动命令：
./picoclaw

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

1. 上传/移动文件

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

2. 赋予执行权限

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

chmod+x picoclaw
3. 启动测试

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

./picoclaw

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

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

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

nohup./picoclaw>picoclaw.log2>&1&

查看运行日志：

tail-fpicoclaw.log

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

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

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

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

五、常用管理命令汇总

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

  1. 查看版本
./picoclaw version
  1. 重启服务
    先结束进程，再重新启动：
# 查找进程ps-ef|greppicoclaw# 结束进程kill-9进程ID# 重新启动./picoclaw
  1. 完全卸载
    直接删除程序文件、日志文件、配置文件即可，无残留。

六、适用场景总结

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

七、最后

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

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