🌟什么是 PicoClaw？

PicoClaw 是由 Sipeed（硅递科技） 官方开发的一款 超轻量级个人 AI 助手，灵感源自 nanobot 的极简哲学。它采用 Go 语言从零构建，通过自举（self-bootstrapping）机制完成代码重构与性能优化，AI 代理自行驱动了架构演进、任务执行与部署流程。

✅ 核心特点：

特性 说明
🐚 极致轻量 单个二进制文件 <15MB，启动时间 <50ms，无外部依赖
🔁 自举重构（Self-Bootstrapping） 由 AI 代理自身完成代码迁移、优化与部署验证
🤖 Agent + Gateway 双模式 支持一次性任务（agent）与长期运行机器人（gateway）
🌐 多服务集成 内建支持：Tavily（搜索）、GitHub（代码）、钉钉（通知）、本地 API 等
📦 Docker 一键部署 原生支持 Docker，快速接入生产环境

⚠️ 官方镜像的重大缺陷：缺少基础工具，导致任务无法执行

虽然官方镜像设计简洁，但其基于 Alpine Linux 的最小化系统存在致命短板：

问题 影响
❌ 无 python3 / pip 无法运行 Python 脚本或调用本地分析工具；(AI自动创建的新技能会依赖python的能力)
❌ 无 nodejs / npm 无法使用 @steipete/summarize 自动摘要网页内容；(自带summarize技能依赖@steipete/summarize)
❌ 无 curl / tmux / gh 无法访问外部服务或管理 GitHub；(自带的天气技能依赖curl，自带的github技能依赖gh)

✅ 正确姿势：构建增强型 Docker 镜像，补全工具链

我们基于官方镜像构建一个 “真实可用”的 PicoClaw 开发环境，自动安装以下核心工具：

  1. ✅ python3 + pip：用于本地脚本、模型调用、API 测试
  2. ✅ nodejs + npm：支持 @steipete/summarize 自动摘要网页内容
  3. ✅ curl / tmux / gh ：调试利器，支持复杂任务排查
  4. ✅ 国内 npm 镜像加速：https://registry.npmmirror.com，避免连接超时

📦 1. Dockerfile：增强版镜像

# 国内加速镜像地址(官网镜像：docker.io/sipeed/picoclaw:latest)
FROM registry.cn-hangzhou.aliyuncs.com/jermey/picoclaw:latest

# 更新包管理器，安装常用工具
RUN apk add --no-cache \
    python3 \
    py3-pip \
    nodejs \
    npm \
    curl \
    github-cli \
    tmux \
    ca-certificates

# 安装内容摘要工具（支持国内镜像加速）
RUN npm i -g @steipete/summarize --registry=https://registry.npmmirror.com/

🐳 2. docker-compose.yml：完整部署配置

services:
  # ─────────────────────────────────────────────
  # PicoClaw Agent (one-shot query)
  #   docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "Hello"
  # ─────────────────────────────────────────────
  picoclaw-agent:
    build: 
      context: .
      dockerfile: 
    container_name: picoclaw-agent
    profiles:
      - agent
    # Uncomment to access host network; leave commented unless needed.
    #extra_hosts:
    #  - "host.docker.internal:host-gateway"
    volumes:
      - ./data:/root/.picoclaw
    entrypoint: ["picoclaw", "agent"]
    stdin_open: true
    tty: true

  # ─────────────────────────────────────────────
  # PicoClaw Gateway (Long-running Bot)
  #   docker compose -f docker/docker-compose.yml up picoclaw-gateway
  # ─────────────────────────────────────────────
  picoclaw-gateway:
    build: 
      context: .
      dockerfile: Dockerfile
    container_name: picoclaw-gateway
    restart: on-failure
    profiles:
      - gateway
    # Uncomment to access host network; leave commented unless needed.
    #extra_hosts:
    #  - "host.docker.internal:host-gateway"
    volumes:
      - ./data:/root/.picoclaw

⚙️ 快速部署指南（5 分钟搭建 AI 助手）

✅ 第一步：首次运行 —— 自动生成配置

docker compose  up picoclaw-gateway

✅ 第二步：填写 API 密钥（关键步骤）

编辑 ./data/config.json 填写模型信息，apikey

✨ 推荐资源（国内可用）：

服务 地址 免费额度
Tavily https://app.tavily.com 每月 1000 次搜索
iFlow 平台 https://platform.iflow.cn 免费调用 Qwen3、GLM 等顶级模型
钉钉开放平台 https://open.dingtalk.com 创建应用；添加机器人；获取 client_id / client_secret

✅ 第三步：启动长期运行的 Gateway

docker compose up -d picoclaw-gateway

🛠️ 实用技巧 & 高级玩法

💡 1. 创建专属技能

在钉钉里面发起对话：创建一个查询股票最新信息的技能。（通常会自动编写一个python程序）

💡 2. 创建定时任务

在钉钉里面发起对话：创建一个交易日每小时查询圆通速递信息的任务

💡 3. 自我检查

在钉钉里面发起对话：查询我有那些技能

在钉钉里面发起对话：查询我有那些定时任务

在钉钉里面发起对话：测试某技能是否正常运行

在钉钉里面发起对话：检查某定时任务