跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Go / GolangAI

PicoClaw 轻量级 AI 助手安装与使用指南

综述由AI生成PicoClaw 是一款基于 Go 语言开发的超轻量级个人 AI 助手,主打低资源占用和快速启动。支持预编译二进制、Docker 及源码编译等多种部署方式。配置时需填入 LLM API Key,可通过命令行对话、网关模式接入 Telegram/Discord 或设置定时任务。本文涵盖从环境准备、配置文件编写到实际交互的完整流程,特别补充了 Windows 下的编译注意事项。

随缘发布于 2026/4/8更新于 2026/5/2212 浏览

PicoClaw 简介

PicoClaw 是矽速科技(Sipeed)推出的一款超轻量级个人 AI 助手,支持从嵌入式开发板到普通电脑的各类设备。它的核心优势在于极低的资源占用和飞快的启动速度,通过将计算密集的大模型推理任务交给云端 API,本地只负责轻量的协调工作。

特性OpenClawNanoBotPicoClaw
编程语言TypeScriptPythonGo
内存占用>1GB>100MB< 10MB
启动时间 (0.8GHz 核心)>500 秒>30 秒<1 秒
硬件成本参考Mac Mini (约$599)多数 Linux 开发板 (~$50)任意 Linux 板 (最低$10)

安装指南

你可以根据实际需求选择以下任意一种方式安装。

方式一:预编译二进制(最简单)

直接从项目的 Releases 页面下载对应操作系统和架构的文件,重命名为 picoclaw(或 picoclaw.exe),并放到系统 PATH 路径下即可。

方式二:从源码编译(适合开发者)

如果你想要体验最新特性,或者你的设备架构特殊,可以自行编译。由于它是 Go 语言编写的项目,编译过程相对直接。

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
make build
make install

注意:在 Windows 环境下编译时,如果直接使用标准 Go 环境,执行 go build -o picoclaw.exe 通常也能生成可执行文件。若遇到依赖问题,建议检查是否安装了 gmake 等构建工具,并确保 Go 版本在 1.16 及以上。

方式三:使用 Docker(环境隔离,快速体验)

这是最干净、依赖最少的方法,非常适合快速上手。

# 1. 克隆仓库
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. 复制并编辑配置文件(填入你的 API Key)
cp config/config.example.json config/config.json
vim config/config.json

# 3. 使用 Docker Compose 启动网关服务
docker compose --profile gateway up -d

配置 PicoClaw

安装完成后,需要进行初始化和配置。

首先获取 API Key,可以从智谱 AI、OpenRouter 等平台获取。如果想让它能联网查资料,还可以获取一个免费的 Brave Search API Key 并填入配置。

配置文件位于 ~/.picoclaw/config.json,这是核心步骤。你需要至少配置一个 LLM 提供商的 API Key。一个最小化的配置示例如下(以智谱 AI 为例):

{
  "agents": {
    "defaults": {
      "model": "glm-5",
      "max_tokens": 8192
    }
  },
  "providers": {
    "zhipu": {
      "api_key": "你的智谱 API Key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  }
}

初始化运行以下命令,它会在你的用户目录下创建 .picoclaw/ 文件夹和默认配置文件:

picoclaw onboard

使用场景

配置好之后,你就可以用多种方式和你的 AI 助手交互了。

本地命令行对话

进入连续的聊天模式:

picoclaw agent

一次性提问,适合快速查询:

picoclaw agent -m "介绍一下皮皮虾的特点"

接入聊天平台(网关模式)

这是 PicoClaw 最实用的功能之一,可以让你通过 Telegram、Discord 等日常 App 与 AI 助手聊天。

启动网关服务:

picoclaw gateway

如果是 Docker 安装,网关通常已经后台运行了。之后,你就可以在手机上随时随地和你的 AI 助手对话了。

在 ~/.picoclaw/config.json 文件中,找到 channels 部分,填入你创建的 Telegram Bot Token 和你的用户 ID:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "你的 Telegram Bot Token",
      "allowFrom": ["你的 Telegram 用户 ID"]
    }
  }
}

高级功能:定时任务与个性化

你可以设置让助手定时执行任务,比如每天早上 9 点提醒你今天的日程。

picoclaw cron add --message "提醒我今天的重要会议" --cron "0 9 * * 1-5"

此外,通过修改 ~/.picoclaw/workspace/ 下的 AGENTS.md 或 SOUL.md 文件,可以用自然语言定义助手的性格、技能和行为准则,无需编写代码。

目录

  1. PicoClaw 简介
  2. 安装指南
  3. 方式一:预编译二进制(最简单)
  4. 方式二:从源码编译(适合开发者)
  5. 方式三:使用 Docker(环境隔离,快速体验)
  6. 1. 克隆仓库
  7. 2. 复制并编辑配置文件(填入你的 API Key)
  8. 3. 使用 Docker Compose 启动网关服务
  9. 配置 PicoClaw
  10. 使用场景
  11. 本地命令行对话
  12. 接入聊天平台(网关模式)
  13. 高级功能:定时任务与个性化
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 基于 Spring Boot 与微信小程序的 4S 店服务预约系统设计
  • SketchUp STL 插件安装与使用指南
  • Hashcat 实战指南:从安装到高级密码恢复
  • MySQL 性能优化:索引优化与查询优化
  • Flutter 使用 React 风格库在 OpenHarmony 上的适配与实践
  • Java 随机数实战:从范围字符串解析到动态区间生成
  • JavaScript 响应对象 Response 详解
  • Java 抽象类与接口的区别与应用
  • 5 款好用的免费在线代码编辑器
  • AKSHARE 结合 AI 技术进行金融数据爬取与分析实战
  • Flutter 使用 langchain_google 接入 Google Gemini 的适配指南
  • 基于 SpringBoot2 与 Vue3 的旅游网站系统设计与实现
  • Win10 升级后 Copilot 弹窗如何彻底关闭与禁用
  • Webots 导入 STL 模型及尺寸颜色调整指南
  • Java Web 开发环境搭建:IDEA 与 Tomcat 安装部署指南
  • Llama-2-7b 在昇腾 NPU 上的六大核心场景性能基准
  • C++ 继承机制详解:原理、规则与实战
  • C++11 核心特性详解:初始化、移动语义与 Lambda 表达式
  • Python Web 框架深度解析:Django、Flask 与 FastAPI 选型指南
  • 计算机科学与技术专业核心技能学习与就业指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online