系统要求
PicoClaw 的硬件门槛非常低：
- 操作系统：Linux / macOS / Windows (WSL2)
- 架构支持：x86_64 / ARM64 / RISC-V
- 最低内存：64MB（推荐 512MB 以上）
- 依赖：LLM API Key（不配置则无法使用 AI 对话）
支持平台：macOS、Linux、Windows (WSL2)、树莓派、Docker
第一步：克隆代码仓库
打开终端，执行以下命令：
git clone https://github.com/sipeed/picoclaw.git克隆完成后，进入项目目录：
cd picoclaw第二步：初始化配置
运行 onboard 命令进行初始化：
picoclaw onboard按照提示完成配置：
- LLM API Key：输入你的 LLM 服务商 API Key
- 模型偏好设置：选择默认使用的 AI 模型
- 消息平台 Token（可选）：如需启用 Telegram、Discord、QQ 或钉钉集成，分别输入对应的 Bot Token
配置文件保存在本地，所有数据均在用户设备上，不会上传到云端。
第三步：启动对话
配置完成后，开始与 AI 对话。
交互模式
picoclaw agent启动交互式对话界面，可连续发送消息并获取回复。
单次查询模式
picoclaw agent -m "你好，请介绍一下你自己"发送单条消息并获取回复后退出，适合在脚本中使用。
启动网关服务
如需在 Telegram、QQ 等消息平台上使用：
picoclaw gateway启动后通过各平台 Bot 即可与 PicoClaw 交互。
多平台 Bot 配置
Telegram Bot
在 Telegram 中找到 @BotFather，发送 /newbot 创建 Bot 获取 Token，将 Token 填入配置文件，启动 picoclaw gateway。
Discord Bot
在 Discord Developer Portal 创建应用，在 Bot 设置中获取 Token，将 Bot 邀请到服务器，将 Token 填入配置。
QQ Bot
参考 QQ 开放平台文档注册 Bot，获取 AppID 和 Token，填入配置文件。
钉钉 Bot
在钉钉开放平台创建机器人应用，获取 Webhook URL 和密钥，填入配置文件。
Docker 部署
PicoClaw 支持 Docker 部署，适合服务器或无桌面环境：
docker pull ghcr.io/sipeed/picoclaw:latestdocker run -d --name picoclaw -v /path/to/config:/config -e PICOCLAW_API_KEY=your_key ghcr.io/sipeed/picoclaw:latest定时任务配置
PicoClaw 内置 cron 支持，通过配置文件管理。
一次性提醒
tasks: - type: reminder time: "1h" message: "会议提醒：团队周会"周期性任务
tasks: - type: cron schedule: "0 8 * * *" message: "生成今日工作总结"常见问题
PicoClaw 需要联网吗？
PicoClaw 本身可以离线运行，但调用 LLM API 和消息平台集成需要互联网连接。
支持哪些 LLM 服务商？
支持 OpenRouter、智谱 AI、Anthropic、OpenAI、DeepSeek、Groq 等，可通过配置文件自由切换。
如何更新 PicoClaw？
进入项目目录后执行 git pull 拉取最新代码，然后重新编译即可。
数据存储在哪里？
所有对话记录和配置数据均存储在本地文件系统，完全由用户掌控。
Docker 镜像有多大？
PicoClaw 的 Docker 镜像约 15MB，远小于竞品的 350MB+。
可以在树莓派上运行吗？
可以，PicoClaw 支持 ARM64 架构，树莓派 4（4GB+）即可流畅运行。
如何配置多个 Bot 同时使用？
在配置文件中分别添加各平台的 Token 和配置项，启动 picoclaw gateway 即可同时激活所有 Bot。