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 KeyOpenAI、DeepSeek、Kimi、MiniMax 等兼容标准 OpenAI 接口格式 这里我用MiniMax演示根据自身设备架构下载对应版本的 PicoClaw 安装包这里使用windows安装使用演示服务器/开发板有外网即可无需额外端口映射纯本地使用二、下载 PicoClaw 程序包1. 获取程序包官网下载地址https://picoclaw.io/download/官方下载对应架构的最新版本有一定技术基础的可以使用源代码编译二进制使用。 注意区分系统与硬件Windows选择windows-amd64版本macOS选择darwin-amd64 / darwin-arm64M系列芯片Linux PC/服务器linux-amd64树莓派、开发板linux-arm64 / linux-arm2. 文件说明下载后得到里面的可执行文件直接赋予权限即可运行全程无捆绑、无多余组件。三、分系统安装部署教程一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运行或在命令行执行picoclaw-launcher.exe程序启动后弹出命令行窗口保持窗口开启即可正常使用如需后台运行可配置 Windows 服务实现常驻或开启启动。根据提示设置密码输入设置好的密码进入主页配置模型key,PicoClaw 本地不运行大模型依靠调用云端 API 实现对话能力模型配置是使用的核心。选择模型提供商并启动服务就可以开始使用交流了三macOS 系统部署将picoclaw文件放置到自定义目录打开终端进入目录并赋予执行权限chmodx picoclaw首次运行如提示「无法验证开发者」前往系统设置-隐私与安全性拉到最下方允许运行该程序。启动命令./picoclaw二Linux 系统服务器/开发板/ WSL2 通用1. 上传/移动文件将下载好的picoclaw可执行文件上传至设备任意目录例如/home/user/。2. 赋予执行权限打开终端进入文件所在目录执行命令chmodx picoclaw3. 启动测试直接运行程序验证是否安装成功./picoclaw终端出现版本信息、启动日志代表基础部署完成按下CtrlC可临时停止程序。4. 后台常驻运行推荐关闭终端也能持续运行搭配日志文件输出nohup./picoclawpicoclaw.log21查看运行日志tail-fpicoclaw.log四、多平台QQ/飞书 接入PicoClaw 延续系列产品的网关能力支持快速接入主流社交/办公软件实现在线机器人对话。接入也很简单在页面上配置下就可以快速接入。根据需求选择QQ/飞书等平台按照指引录入平台密钥、账号信息QQ填写机器人 BotID、AppSecretQQ开放平台获取飞书填写应用 AppID、AppSecret、权限五、常用管理命令汇总日常运维、重启、重置配置可直接使用以下指令全平台通用查看版本./picoclaw version重启服务先结束进程再重新启动# 查找进程ps-ef|greppicoclaw# 结束进程kill-9进程ID# 重新启动./picoclaw完全卸载直接删除程序文件、日志文件、配置文件即可无残留。六、适用场景总结嵌入式/边缘设备部署在树莓派、RISC-V开发板打造7×24小时常驻AI助手低配置主机老旧电脑、迷你主机使用不占用系统资源个人机器人对接QQ、飞书实现日常问答、消息提醒、自动化交互开发测试轻量化调试AI网关、模型对接流程替代重型Agent方案。七、最后PicoClaw 凭借10MB 内存占用、零依赖、跨架构的优势大幅降低了 AI Agent 的部署门槛。不管是专业开发者做边缘AI开发还是普通用户搭建个人机器人它都是轻量化场景下的优质选择。欢迎关注后面持续更新AI智能体工具。