opencode/picoclaw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
picoclaw/.specstory/history/2026-02-25_09-23Z-current-branch-status.md

11 KiB
Raw Blame History

Current branch status (2026-02-25 09:23Z)

User (2026-02-25 09:23Z)

查看当前分支情况

Agent (model claude-4.5-sonnet-thinking, mode Agent)

Thought Process 用户要查看当前分支情况。我需要运行 git 命令来查看当前分支状态。最常用的命令是：

  • git branch - 查看本地分支
  • git status - 查看当前分支和状态
  • git branch -a - 查看所有分支（包括远程）

让我先运行 git status 和 git branch 来查看当前分支情况。

我来帮你查看当前的分支情况。

Tool use: **run_terminal_cmd** • Run command: cd /home/0668001505/Desktop/picoclaw/picoclaw && git branch -a 
cd /home/0668001505/Desktop/picoclaw/picoclaw && git branch -a

* main
  remotes/origin/HEAD -> origin/main
  remotes/origin/feat/agent-browser-tool
  remotes/origin/feat/mcp-context7-integration-cleanup
  remotes/origin/main
  remotes/origin/refactor/channel-system
Tool use: **run_terminal_cmd** • Run command: cd /home/0668001505/Desktop/picoclaw/picoclaw && git status 
cd /home/0668001505/Desktop/picoclaw/picoclaw && git status

位于分支 main
您的分支与上游分支 'origin/main' 一致。

未跟踪的文件:
  （使用 "git add <文件>..." 以包含要提交的内容）
	.cursorindexingignore
	.specstory/

提交为空，但是存在尚未跟踪的文件（使用 "git add" 建立跟踪）

Thought Process 好的，我已经获取了分支信息。让我总结一下：

  1. 当前在 main 分支上
  2. 本地分支只有 main
  3. 远程分支有：
    • origin/main
    • origin/feat/agent-browser-tool
    • origin/feat/mcp-context7-integration-cleanup
    • origin/refactor/channel-system
  4. 当前分支与上游分支 origin/main 一致
  5. 有一些未跟踪的文件（.cursorindexingignore 和 .specstory/）

现在我用中文总结给用户。

根据查看结果，当前分支情况如下：

📍 当前分支

  • 当前所在分支: main
  • 状态: 与上游分支 origin/main 一致

📋 本地分支

  • main (当前分支)

🌐 远程分支

  • origin/main
  • origin/feat/agent-browser-tool
  • origin/feat/mcp-context7-integration-cleanup
  • origin/refactor/channel-system

📝 工作区状态

  • 工作区干净，没有待提交的更改
  • 有未跟踪的文件：
    • .cursorindexingignore
    • .specstory/

你目前在主分支上，且与远程保持同步。有几个特性分支在远程仓库中，如果需要切换到其他分支进行开发，可以使用 git checkout 命令。

User (2026-02-25 09:23Z)

ZeroClaw 是一个高性能、低资源占用、可组合的自主智能体运行时。ZeroClaw 是面向智能代理工作流的运行时操作系统，通常被视为 OpenClaw 的 Rust 重写版本。 它抽象了模型、工具、记忆和执行层，使代理可以一次构建、随处运行，它通过 Trait 驱动架构实现了模型、通信渠道、工具、记忆系统等组件的可插拔替换，旨在提供一个安全、快速且资源友好的自主智能体运行环境。 核心定位：定位为生产级“Agent 操作系统”（Agent OS），适用于边缘设备、高并发 Agent 集群、自动化运维等场景。

技术栈：采用 Rust 编写，单二进制部署，跨 ARM / x86 / RISC-V，单文件体积极小（3.4MB 或 8.8MB 版本），内存占用极低（低于 5MB），启动速度极快（启动时间可低至毫秒级）。

安全设计：内置安全沙箱、配对鉴权（pairing authentication）和显式 allowlist，默认安全性高。

特性：支持 17+ 多种通信渠道（Telegram、Discord、Slack 等），支持 22+ AI 提供商（OpenAI、Claude、Ollama 等），支持本地模型运行

参考上面zeroclaw ，给出本项目的描述

Agent (model claude-4.5-sonnet-thinking, mode Agent)

Thought Process 用户希望我参考 ZeroClaw 的描述风格，给出当前项目 picoclaw 的描述。我需要先了解一下 picoclaw 项目的实际情况，然后基于项目的真实特性，仿照 ZeroClaw 的描述风格来撰写。

让我先查看一下项目的基本信息，比如 README、package.json 或其他配置文件。

我来帮你了解项目并给出描述。首先让我查看一下项目的基本信息。

Tool use: **read_file** • Read file: /home/0668001505/Desktop/picoclaw/picoclaw/README.md

Could not find file '/home/0668001505/Desktop/picoclaw/picoclaw/package.json' in the workspace.

Tool use: **list_dir** • Listed directory, 0 results

No results found

Thought Process 好的，现在我了解了 picoclaw 项目的情况。这是一个用 Go 语言编写的超轻量级 AI 助手，与 ZeroClaw（Rust 编写）的定位类似，但更注重极致的资源效率。

让我根据 README 的内容，参考 ZeroClaw 的描述风格，给出 picoclaw 的项目描述。

根据项目信息，我为你撰写了 PicoClaw 的描述，参考了 ZeroClaw 的风格：

PicoClaw 项目描述

PicoClaw 是一个超轻量、极低资源占用的个人 AI 助手运行时。 PicoClaw 受 nanobot 启发，从 TypeScript 完全重写为 Go 语言，通过 AI 自举过程（self-bootstrapping）完成架构迁移和代码优化，是 OpenClaw 的极致精简版本。它抽象了模型、工具、通信渠道和记忆系统，使智能代理可以一次构建、随处运行，旨在将 AI 助手带入 $10 硬件和 <10MB 内存的极限环境。

核心定位

定位为超轻量级"个人 AI 助手操作系统"（Personal AI Assistant OS），适用于边缘设备、低功耗硬件（RISC-V单板机）、旧手机复活、智能家居、服务器自动化运维等场景，让 AI 智能体能够在资源受限的环境中高效运行。

技术栈

  • 开发语言：采用 Go 编写，单二进制部署，无任何外部依赖
  • 跨平台支持：原生支持 x86_64、ARM64、RISC-V 架构
  • 极致轻量：
    • 内存占用：<10MB（比 OpenClaw 减少 99%，比 NanoBot 减少 90%）
    • 启动速度：<1秒（即使在 0.6GHz 单核处理器上，比 OpenClaw 快 400 倍）
    • 单文件体积：约 10MB 左右
  • 成本优势：可运行在 $10 硬件上（比 Mac mini 便宜 98%）

安全设计

  • 内置安全沙箱：默认限制文件和命令访问范围（restrict_to_workspace）
  • 白名单机制：通过 allow_from 配置显式授权用户访问
  • 危险命令拦截：自动阻止 rm -rf、format、shutdown 等危险操作
  • 一致性安全边界：主 Agent、子 Agent、定时任务共享相同安全限制

核心特性

🌐 多通道支持（7+ 通信平台）

  • 即时通讯：Telegram、Discord、QQ、钉钉、LINE、企业微信（WeCom）
  • 灵活接入：通过配置文件即可启用/禁用任意通道

🤖 多模型支持（15+ AI 提供商）

  • 主流大模型：OpenAI、Anthropic (Claude)、Google Gemini、智谱 AI (GLM)、通义千问 (Qwen)、DeepSeek、Moonshot、Groq、Cerebras、NVIDIA
  • 聚合服务：OpenRouter（访问所有主流模型）
  • 本地模型：Ollama、vLLM、GitHub Copilot
  • 零代码扩展：通过 vendor/model 格式（如 zhipu/glm-4.7）即可添加新提供商

🛠️ 丰富工具生态

  • 文件操作：读写、编辑、列目录（沙箱保护）
  • 命令执行：系统命令执行（危险命令拦截）
  • 网络搜索：Brave Search、Tavily、DuckDuckGo（自动降级）
  • 定时任务：支持一次性提醒和周期性任务（Cron 表达式）
  • 技能系统：支持自定义技能扩展（Skills）
  • 子 Agent 生成：spawn 工具创建独立子智能体

💾 记忆与上下文管理

  • 会话历史：自动保存对话上下文（sessions/）
  • 长期记忆：持久化记忆系统（MEMORY.md）
  • Agent 人格：可配置的身份（IDENTITY.md）和灵魂（SOUL.md）
  • 用户偏好：记录用户习惯和偏好（USER.md）

⏰ 心跳机制（Heartbeat）

  • 周期性任务：每 30 分钟自动执行 HEARTBEAT.md 中的任务
  • 异步子 Agent：长时间任务通过 spawn 创建独立子智能体，不阻塞主流程
  • 主动通知：子 Agent 可通过 message 工具主动向用户推送结果

🐳 部署方式多样

  • 预编译二进制：直接下载运行
  • 源码编译：支持 make build 和 make build-all（多平台）
  • Docker Compose：容器化部署，支持 Gateway 和 Agent 模式
  • 终端模式：交互式命令行聊天

创新应用场景

  • 旧手机复活：在 Termux 中运行，让十年前的 Android 手机变身 AI 助手
  • 极低成本部署：$9.9 的 LicheeRV-Nano（RISC-V）可运行完整 AI 助手
  • 服务器运维：NanoKVM 上实现自动化服务器维护
  • 智能监控：MaixCAM 上构建智能摄像头

架构设计

  • 模块化架构：Agent、Provider、Channel、Tool、Session 完全解耦
  • 可插拔组件：通过接口（Interface）实现组件替换
  • 消息总线：基于 Event Bus 的消息路由系统
  • 会话管理：支持多用户、多通道的会话隔离
  • 负载均衡：同一 model_name 配置多个端点自动轮询

与同类项目对比

OpenClaw NanoBot PicoClaw
语言 TypeScript Python Go
内存占用 >1GB >100MB <10MB
启动时间（0.8GHz） >500s >30s <1s
硬件成本 Mac Mini $599 SBC ~$50 最低 $10

核心理念：让 AI 助手回归本质 —— 在任何设备上都能快速、安全、高效地运行，无需昂贵硬件，无需复杂配置。PicoClaw 证明了即使在最受限的环境中，也能构建功能完整的自主智能体系统。