picoclaw/PicoClaw 26M2W3 社区开发者会议.md
xiaoen 0c6eeec230 merge: resolve conflict with main in loop.go
Main reformatted the fallback.Execute call to multi-line (golines);
our branch renamed agent.Candidates → activeCandidates for routing.
Kept both: multi-line formatting + routing variable.
2026-03-03 12:22:45 +08:00

7.7 KiB
Raw Blame History

PicoClaw 26M2W3 社区开发者会议

PicoClaw的设计目标:轻量高效,任意部署;简单易用,普惠大众; 致PicoClaw开发者让我们携手加速AI奇点的到来共同创造并见证历史。


26M2W3 概况

成果

  • Github 表现Star 17K+Merge 100+ PRContributors 70+
  • 用户规模:微信群 1600+Discord 1300+
  • 开发者规模:微信群 ~50Discord ~40
  • 生态进展PicoClaw 进入 Homebrew
  • 工程进展Provider 完成重构
  • 特别鸣谢daming, lxowalle 在假期的努力!

暴露的问题

  • 第一次开展大规模社区协同开发,又是在假期期间,响应速度、社区协调、工程架构方面都暴露出了很多不足。
  • PicoClaw 早期 vibe-coding 的快速实现架构在蜂拥而至的 PR 面前会迅速变成“屎山”和冲突地狱。
  • 为尽快合并 PR未充分验证社区开发者的能力也没有提供合并指导规范过早给予 write 权限,在上面架构问题下更暴露出问题。
  • 忙于以上 PR 协调问题,拖后了文档和宣发进度。特别是宣发问题,被不放春节假的海外开发者项目 zeroclaw 趁虚而入。
  • ⚠️ 警惕币圈! 尤其是 pump.fun 空气币,不要认领参与!

会议核心任务:本次周会主要需要划分项目板块,认领板块负责人,制订下周计划。以下内容社区开发者可以继续添加遗漏的地方。


开发板块

仓库管理

  • 新建 dev 分支,main 分支推送严格化。
  • 完善 CONTRIBUTING.md
  • 时区审核分工
    • GMT+8 附近时区审核(中国)
    • GMT+0 附近时区审核(欧洲):Huaaudio
    • GMT-8 附近时区审核(美洲)
  • 仓库权限申请:联系 zepan 审核。
  • Readme 中公布本次会议的分工人员表格,方便开发者找寻对应人员审核。

Provider负责人daming

  • 进度:已重构完成。
  • 计划
    • 梳理支持和计划支持的 provider 协议列表及进度计划。
    • 插件系统探索go 原生插件?(参考 hashicorp/go-plugin)
    • 优化思路:现在各种系统的 LLM provider 都在重复造轮子,而且每新增一个 provider 都得再改代码、重新发版才能支持。应该把专业的事交给专业的组件来负责。我开了个新的开源项目——open-next-router,采用 nginx 原子化配置的思想,新增 provider 无需改代码,新增配置文件即可支持,提供了 go 的 sdk 包可快速接入项目。PicoClaw 接入后可更聚焦于 agent 的实现而不是各种上游 provider 的适配,就能快其它 claw 一步。

Channels负责人daming

  • 进度:正在重构。
  • 计划
    • 梳理支持和计划支持的 channel 协议列表及进度计划。
    • 附件支持讨论:音频、视频、文件。
      • 附件的生命周期应该由谁管理channel 应该只负责下载文件,然后交由 Agent 消费完成后管理生命周期?
      • 音频转文字是否要迁移到 agent 层?或者说附件应该在哪一层被处理?
      • 发送附件的方法如何拓展?添加新的方法?拓展原有 Message
    • 群友建议的 skill加channel(参考 nanoclaw skill)
    • 插件系统讨论
    • 架构优化
      • 抽离公共的 HTTP 服务器,采用 WebHook 通信的 channel 通过复用公共的服务器来节省资源和端口。
      • Websocket 支持。
      • 将路由相关字段(peer_kindpeer_id)从 metadata 中提升为 InboundMessage 的结构体字段。
    • 状态管理:聊天记录应该由 channel 管理还是 agent 管理?

Agent负责人学欧

  • Agent Loop 机制优化。
  • 记忆系统:引入 SQLite。
  • Multi-Agent / Swarm 支持。
  • 模型能力回退链:在主模型不支持多模态时,使用多模态模型进行辅助。

Tools负责人学欧

  • 整理规范。
  • 插件系统探索。

Heartbeat / Status / Log 等负责人daming

  • 完善心跳、状态和日志监控。

Skill

  • 搜索 skill 的 skill已合并 PRPR #332
  • 安全与维护:探讨 skill 的维护和安全性问题,防范目前常见的投毒现象。

MCP负责人evo

  • 功能实现:已有 PR #376#282
  • 安卓手机操作支持。
  • 浏览器操作 (webmcp? action book?):已有相关 PR (agent-browser-tool)。

占用/效率优化(负责人:学欧)

  • 目标:优化内存占用与执行效率,希望控制在 20M 以内
  • 分析:分析各个版本之间的内存占用变化,分析各个模块的内存占用情况。
  • 裁剪:裁剪出最小版本,用于宣发。

Security

  • 响应并修复安全机构发送的漏洞警示。
  • 参考 openclaw 等现有仓库的安全措施,加固 PicoClaw。

AI CI负责人政宇

  • 完善仓库的 CI 流程。
  • 加入 AI review 等自动化流程。
  • 完善发布流程、测试项目、release note、breaking change 记录。
  • 根目录加上 CLAUDE.md
  • 增加 loongarch & deb/rpm 支持。

UX Testing

  • 对 release 版进行一般性测试。
  • 站在小白用户角度对使用交互提出意见建议,比如完善 PicoClaw onboard 流程。
  • 展示性优化:比如启动时刷屏 ascii-art 的 PicoClaw 标识,增加用户拍摄视频时的辨识度。

文档工作

  • 仓库 Readme 美化,仓库文档整理、规范。
  • 整理所有 Channel、Provider 的实现支持列表。
  • 针对小白用户的各个 Provider、Channel 详细手把手教程文档。
  • 建设 Wiki 页面deepwiki?)。

Release 待办事项 (Checklist)

  • Provider
  • Channel
  • Agent
  • Swarm
  • Security
  • MCP浏览器
  • 文档
  • Logo
  • Metadata 问题解决

关于插件系统测试方案(补充记录)

测试了以下几种方案:

  1. 内置的 plugin 模块:不考虑。不支持 Windows 等平台 (plugin)。
  2. hashicorp/go-plugin:不考虑。占用资源过大,固件都增加了 2030M。
  3. net/rpcclient-server 模式):
    • 优点:支持热加载,插件可以保存运行状态。
    • 缺点:资源消耗较多(内存约增加 5M+,每个插件大小 10+M每个插件占用一个端口不太优雅。
  4. encoding/gob(编译为可执行程序,由主程序调用并获取返回值):
    • 优点:支持热加载,消耗资源相对较少(测试固件大小增加了 376KB内存消耗增加了 640KB
    • 缺点:无法保存运行状态(应该可以用 socket 等方法来优化支持)。

宣发板块

社区运营

  • 宣发物料/策划:负责人 zepan,再寻求 1~2 位有网感的社区成员。
    • 制作标准 Logo, Slogan。
    • 制作具有传播性的图文/视频等。
    • 策划互动性、传播性强的用户活动,产生用户内容。
    • KOL 建联等其它宣发手段。
  • 微信群运营:负责人 zepan
  • 推特运营:负责人 zepan
  • Discord运营:负责人 OsmiumOP;需要再找一个国内开发者盯一下,会给予 admin 权限。
  • 其他渠道开拓小红书、知乎、Reddit
  • Go社区联络大使:负责人

中期 TODO

  • 桌面应用 / 安卓 APP
    • 架构讨论C/S 还是单程序?接口文档规范?
  • 配套硬件