项目简介
PicoClaw 是一款超轻量级的个人AI助手，灵感来源于 nanobot，通过自举过程使用Go语言从零重构。在此过程中，AI智能体本身驱动了整个架构迁移和代码优化。
可在10美元硬件上运行，内存占用低于10MB：相比OpenClaw内存占用减少99%，相比Mac mini成本降低98%！
特性
超轻量级: 内存占用低于10MB — 比Clawdbot核心功能小99%。
极低成本: 高效运行于10美元硬件 — 比Mac mini便宜98%。
极速启动: 启动速度提升400倍，即使在0.6GHz单核处理器上也能在1秒内启动。
真正便携: 单个独立二进制文件，支持RISC-V、ARM和x86架构，一键迁移至Go！
AI自举: 自主Go原生实现 — 95%的核心代码由智能体生成，人工参与优化完善。
|
|
|
|
PicoClaw |
|---|---|---|---|
| 编程语言 |
|
|
Go |
| 内存 |
|
|
< 10MB |
| 启动时间
|
|
|
<1秒 |
| 成本 |
|
约50美元 |
任意Linux开发板
低至10美元 |
演示
标准助手工作流
|
🧩 全栈工程师 |
🗂️ 日志与计划管理 |
🔎 网络搜索与学习 |
|---|---|---|
 |
 |
 |
|
|
|
|
创新的低资源部署
PicoClaw 几乎可以在任何 Linux 设备上部署！
-
9.9美元 LicheeRV-Nano 以太网或WiFi6版本，用于极简家庭助手 -
30-50美元 NanoKVM，或100美元 NanoKVM-Pro 用于自动化服务器维护 -
50美元 MaixCAM 或100美元 MaixCAM2 用于智能监控
安装
使用预编译二进制文件安装
从发布页面下载适用于您平台的固件。
从源代码安装（最新特性，推荐开发使用）
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
# 构建，无需安装
make build
# 为多平台构建
make build-all
# 构建并安装
make install
快速开始
[!TIP] 在
~/.picoclaw/config.json中设置您的API密钥。 获取API密钥：OpenRouter (LLM) · 智谱 (LLM) 网络搜索是可选的 – 获取免费的 Brave Search API（每月2000次免费查询）
1. 初始化
picoclaw onboard
2. 配置 (~/.picoclaw/config.json)
{
"Agents": {
"defaults": {
"workspace": "~/.picoclaw/workspace",
"model": "glm-4.7",
"max_tokens": 8192,
"temperature": 0.7,
"max_tool_iterations": 20
}
},
"providers": {
"openrouter": {
"api_key": "xxx",
"api_base": "https://openrouter.ai/api/v1"
}
},
"tools": {
"web": {
"search": {
"api_key": "YOUR_BRAVE_API_KEY",
"max_results": 5
}
}
}
}
3. 获取API密钥
-
LLM提供商: OpenRouter · 智谱 · Anthropic · OpenAI · Gemini -
网络搜索 (可选): Brave Search – 提供免费套餐（每月2000次请求）
注意: 查看
config.example.json获取完整的配置模板。
4. 聊天
picoclaw agent -m "2+2等于几？"
就这样！您在2分钟内就有了一个可用的AI助手。
聊天应用
通过 Telegram、Discord 或钉钉与您的 PicoClaw 对话
|
|
|
|---|---|
| Telegram |
|
| Discord |
|
|
|
|
| 钉钉 |
|
Telegram（推荐）
1. 创建机器人
-
打开 Telegram，搜索 @BotFather -
发送 /newbot，按照提示操作 -
复制令牌
2. 配置
{
"channels": {
"telegram": {
"enabled": true,
"token": "YOUR_BOT_TOKEN",
"allowFrom": ["YOUR_USER_ID"]
}
}
}
从 Telegram 上的
@userinfobot获取您的用户ID。
3. 运行
picoclaw gateway
Discord
1. 创建机器人
-
访问 https://discord.com/developers/applications -
创建应用 → 机器人 → 添加机器人 -
复制机器人令牌
2. 启用意图
-
在机器人设置中，启用消息内容意图 -
（可选）如果您计划使用基于成员数据的允许列表，启用服务器成员意图
3. 获取您的用户ID
-
Discord 设置 → 高级 → 启用开发者模式 -
右键点击您的头像 → 复制用户ID
4. 配置
{
"channels": {
"discord": {
"enabled": true,
"token": "YOUR_BOT_TOKEN",
"allowFrom": ["YOUR_USER_ID"]
}
}
}
5. 邀请机器人
-
OAuth2 → URL生成器 -
范围: bot -
机器人权限: 发送消息,读取消息历史 -
打开生成的邀请URL并将机器人添加到您的服务器
6. 运行
picoclaw gateway
1. 创建机器人
-
访问 QQ互联开放平台 -
创建应用 → 获取 AppID 和 AppSecret
2. 配置
{
"channels": {
"qq": {
"enabled": true,
"app_id": "YOUR_APP_ID",
"app_secret": "YOUR_APP_SECRET",
"allow_from": []
}
}
}
将
allow_from设为空以允许所有用户，或指定QQ号限制访问。
3. 运行
picoclaw gateway
钉钉
1. 创建机器人
-
访问 开放平台 -
创建内部应用 -
复制 Client ID 和 Client Secret
2. 配置
{
"channels": {
"dingtalk": {
"enabled": true,
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"allow_from": []
}
}
}
将
allow_from设为空以允许所有用户，或指定QQ号限制访问。
3. 运行
picoclaw gateway
配置
配置文件：~/.picoclaw/config.json
工作区结构
PicoClaw 在您配置的工作区中存储数据（默认：~/.picoclaw/workspace）：
~/.picoclaw/workspace/
├── sessions/ # 对话会话和历史记录
├── memory/ # 长期记忆 (MEMORY.md)
├── cron/ # 定时任务数据库
├── skills/ # 自定义技能
├── AGENTS.md # 智能体行为指南
├── IDENTITY.md # 智能体身份
├── SOUL.md # 智能体灵魂
├── TOOLS.md # 工具描述
└── USER.md # 用户偏好
服务提供商
[!NOTE] Groq 通过 Whisper 提供免费语音转录。如果配置了，Telegram 语音消息将自动转录。
|
|
|
|
|---|---|---|
gemini |
|
|
zhipu |
|
|
openrouter(待测试) |
|
|
anthropic(待测试) |
|
|
openai(待测试) |
|
|
DeepSeek(待测试) |
|
|
groq |
|
|
智谱
1. 获取API密钥和基础URL
-
获取 API密钥
2. 配置
{
"agents": {
"defaults": {
"workspace": "~/.picoclaw/workspace",
"model": "glm-4.7",
"max_tokens": 8192,
"temperature": 0.7,
"max_tool_iterations": 20
}
},
"providers": {
"zhipu": {
"api_key": "您的API密钥",
"api_base": "https://open.bigmodel.cn/api/paas/v4"
},
},
}
3. 运行
picoclaw agent -m "你好"
完整配置示例
{
"agents": {
"defaults": {
"model": "anthropic/claude-opus-4-5"
}
},
"providers": {
"openrouter": {
"api_key": "sk-or-v1-xxx"
},
"groq": {
"api_key": "gsk_xxx"
}
},
"channels": {
"telegram": {
"enabled": true,
"token": "123456:ABC...",
"allow_from": ["123456789"]
},
"discord": {
"enabled": true,
"token": "",
"allow_from": [""]
},
"whatsapp": {
"enabled": false
},
"feishu": {
"enabled": false,
"app_id": "cli_xxx",
"app_secret": "xxx",
"encrypt_key": "",
"verification_token": "",
"allow_from": []
},
"qq": {
"enabled": false,
"app_id": "",
"app_secret": "",
"allow_from": []
}
},
"tools": {
"web": {
"search": {
"api_key": "BSA..."
}
}
}
}
命令行参考
|
|
|
|---|---|
picoclaw onboard |
|
picoclaw agent -m "..." |
|
picoclaw agent |
|
picoclaw gateway |
|
picoclaw status |
|
picoclaw cron list |
|
picoclaw cron add ... |
|
定时任务 / 提醒
PicoClaw 通过 cron 工具支持定时提醒和重复任务：
-
一次性提醒："10分钟后提醒我" → 10分钟后触发一次 -
重复任务："每2小时提醒我" → 每2小时触发一次 -
Cron表达式："每天早上9点提醒我" → 使用cron表达式
任务存储在 ~/.picoclaw/workspace/cron/ 中并自动处理
