elizaOS 多智能体架构设计分析

📋 概述

elizaOS 是一个开源的多智能体 AI 开发框架,用于构建、部署和管理自主 AI 智能体。采用现代化、可扩展的全功能平台设计。

核心特性

  • 🔌 丰富的连接器:内置 Discord、Telegram、Farcaster 等支持
  • 🧠 模型无关:支持 OpenAI、Gemini、Anthropic、Llama、Grok 等主流模型
  • 🖥️ 现代 Web UI:专业仪表板,实时管理智能体、群组和对话
  • 🤖 多智能体架构:从底层设计支持创建和编排专业智能体组
  • 📄 文档摄取:轻松摄取文档,支持 RAG 检索和问答
  • 🛠️ 高度可扩展:强大的插件系统构建自定义功能
  • 📦 开箱即用:无缝的设置和开发体验

🏗️ 系统架构概览

项目结构

需求即代码:ZeroAI 让开发触手可及

ZeroAI 是一个通用的 AI 驱动软件开发助手,能够按照标准化的五步流程开发任意软件应用。从需求理解到代码生成,让 AI 帮你完成整个软件开发周期。

特性

  • 🚀 五步开发流程:需求分析 → 接口设计 → 数据库设计 → 业务逻辑设计 → 代码生成
  • 💾 版本管理:完整的项目版本控制,支持创建、查看和加载历史版本
  • 📝 Word 导出:一键导出项目文档到 Word 格式
  • 🎯 交互式审查:每一步生成结果都可查看、审批或重新生成
  • 📊 实时日志:完整记录 AI 开发过程中的所有操作和输出
  • 🔄 数据持久化:使用 SQLite 数据库存储项目数据

技术栈

核心依赖

  • 框架: Next.js 16 (App Router)
  • 语言: TypeScript
  • 样式: Tailwind CSS 4
  • 数据库: Better-SQLite3
  • AI: OpenAI API (兼容 LongCat 等第三方 API)
  • 文档导出: docx

测试依赖

  • 测试框架: Vitest
  • 测试 UI: Vitest UI
  • React 测试: @testing-library/react
  • DOM 断言: @testing-library/jest-dom
  • 用户事件: @testing-library/user-event
  • 浏览器环境: jsdom

快速开始

环境配置

  1. 复制环境变量模板:
cp .env.example .env

Cline 技术架构深度分析

Cline 是一个企业级 AI 编程助手,作为 VS Code 扩展运行。它代表了当前 AI 智能体开发的最高水平之一,具有以下核心特点:

特性 描述
🤖 自主智能体 能够独立规划和执行复杂开发任务
🔧 多工具集成 文件编辑、终端执行、浏览器自动化、MCP 协议
👥 人机回环 每一步操作都需要用户确认,安全可控
🌐 多模型支持 Anthropic、OpenAI、Google、AWS Bedrock 等
💾 检查点系统 可随时回滚到任意工作状态
🏗️ 跨平台架构 VS Code、CLI、JetBrains 多宿主支持

本报告将从架构师和开发专家的角度,深入剖析 Cline 的技术实现。

目录

  1. 整体架构设计
  2. 核心模块详解
  3. Agent 任务循环机制
  4. 提示词系统架构
  5. 工具执行系统
  6. 上下文管理策略
  7. 多宿主架构
  8. 安全与权限控制
  9. 关键技术选型
  10. 架构亮点与总结

整体架构设计

1.1 分层架构

Cline 采用清晰的分层架构,从上到下依次为:

基于 OpenClaw 开发AI助手ZeroAI:五步流程,帮你完成软件开发全流程

ZeroAI 一个通用的 AI 开发助手,能够按照五步流程开发任意软件应用。从需求理解到代码生成,让 AI 帮你开发软件!

😀

一、理解需求

  1. 需要游戏房间创建功能,支持生成唯一的游戏会话标识,用于管理单局游戏的生命周期
  2. 需要玩家状态初始化功能,支持在游戏开始时设定玩家的初始生命值为3、初始分数为0及初始坦克属性
  3. 需要玩家坦克移动逻辑处理功能,支持根据移动指令计算坦克下一帧坐标,并校验与砖墙、钢墙、水域、边界等地图元素的碰撞情况以阻断非法移动
  4. 需要玩家坦克射击逻辑处理功能,支持根据射击指令生成子弹对象,判定子弹飞行轨迹与地图障碍物、敌方坦克及基地的碰撞结果
  5. 需要地图数据加载功能,支持根据关卡ID获取对应的地图布局数据,包含砖墙、钢墙、水域、树林、基地等元素的位置坐标信息
  6. 需要敌方坦克AI控制功能,支持自动控制敌方坦克进行移动路径规划、转向逻辑及自动射击,并实现随关卡递增的难度参数调整
  7. 需要子弹碰撞判定功能,支持区分子弹击中不同目标(砖墙、钢墙、坦克、基地)后的处理逻辑,包括销毁子弹、扣除目标生命值或销毁目标
  8. 需要基地保护判定功能,支持监测基地是否被敌方子弹或玩家误伤击中,一旦击中立即触发游戏失败结算流程
  9. 需要地图元素破坏机制功能,支持普通子弹破坏砖墙、增强子弹破坏钢墙的逻辑,并同步更新地图障碍物状态
  10. 需要道具生成与掉落功能,支持在特定条件触发下(如消灭敌方坦克)随机生成速度提升、火力提升、护盾、生命、炸弹、冻结等道具实体
  11. 需要道具拾取生效功能,支持玩家坦克拾取道具后触发对应效果,包括移动速度增益、射击属性增强、无敌状态、生命值增加、全屏敌人清除及敌人冻结状态
  12. 需要道具效果时效管理功能,支持对速度提升、火力提升、护盾、冻结等具有持续时间的道具效果进行倒计时管理及状态自动清除
  13. 需要分数结算功能,支持根据消灭敌方坦克的类型、数量及通关奖励计算并累加玩家当前得分
  14. 需要生命值管理功能,支持玩家坦克被击毁时扣除生命值,并在生命值归零时触发游戏结束流程
  15. 需要关卡进度管理功能,支持在消灭当前关卡所有敌人后判定通关,并自动切换至下一关卡或触发游戏胜利结算
  16. 需要游戏状态流转控制功能,支持管理游戏从准备开始、进行中、暂停、结束等状态的切换逻辑
  17. 需要游戏音效开关控制功能,支持接收客户端音效设置指令,维护当前游戏会话的音效开启或关闭状态
  18. 需要游戏结算功能,支持在游戏结束或通关时生成包含最终得分、存活状态、通关关卡数等数据的结算报告

飞算 JavaAI:五步智能引导构建坦克大战游戏

创建项目

# 🎮 坦克大战 - Tank Battle

一个经典坦克游戏克隆,致敬任天堂的《坦克大战》(Battle City)。

## ✨ 功能特性

### 核心玩法
- **玩家坦克** - 使用 WASD 或方向键控制移动,空格键射击
- **AI 敌方坦克** - 自动移动和射击,难度随关卡递增
- **基地保护** - 保护你的金色基地不被敌人摧毁
- **关卡系统** - 通关后自动进入下一关,敌人越来越强

### 地图元素
- **🧱 砖墙** - 可被子弹破坏,提供战术掩护
- **🔩 钢墙** - 不可破坏的坚固障碍物(增强子弹可以破坏)
// ...

一、理解需求

  1. 需要游戏房间创建功能,支持生成唯一的游戏会话标识,用于管理单局游戏的生命周期
  2. 需要玩家状态初始化功能,支持在游戏开始时设定玩家的初始生命值为3、初始分数为0及初始坦克属性
  3. 需要玩家坦克移动逻辑处理功能,支持根据移动指令计算坦克下一帧坐标,并校验与砖墙、钢墙、水域、边界等地图元素的碰撞情况以阻断非法移动
  4. 需要玩家坦克射击逻辑处理功能,支持根据射击指令生成子弹对象,判定子弹飞行轨迹与地图障碍物、敌方坦克及基地的碰撞结果
  5. 需要地图数据加载功能,支持根据关卡ID获取对应的地图布局数据,包含砖墙、钢墙、水域、树林、基地等元素的位置坐标信息
  6. 需要敌方坦克AI控制功能,支持自动控制敌方坦克进行移动路径规划、转向逻辑及自动射击,并实现随关卡递增的难度参数调整
  7. 需要子弹碰撞判定功能,支持区分子弹击中不同目标(砖墙、钢墙、坦克、基地)后的处理逻辑,包括销毁子弹、扣除目标生命值或销毁目标
  8. 需要基地保护判定功能,支持监测基地是否被敌方子弹或玩家误伤击中,一旦击中立即触发游戏失败结算流程
  9. 需要地图元素破坏机制功能,支持普通子弹破坏砖墙、增强子弹破坏钢墙的逻辑,并同步更新地图障碍物状态
  10. 需要道具生成与掉落功能,支持在特定条件触发下(如消灭敌方坦克)随机生成速度提升、火力提升、护盾、生命、炸弹、冻结等道具实体
  11. 需要道具拾取生效功能,支持玩家坦克拾取道具后触发对应效果,包括移动速度增益、射击属性增强、无敌状态、生命值增加、全屏敌人清除及敌人冻结状态
  12. 需要道具效果时效管理功能,支持对速度提升、火力提升、护盾、冻结等具有持续时间的道具效果进行倒计时管理及状态自动清除
  13. 需要分数结算功能,支持根据消灭敌方坦克的类型、数量及通关奖励计算并累加玩家当前得分
  14. 需要生命值管理功能,支持玩家坦克被击毁时扣除生命值,并在生命值归零时触发游戏结束流程
  15. 需要关卡进度管理功能,支持在消灭当前关卡所有敌人后判定通关,并自动切换至下一关卡或触发游戏胜利结算
  16. 需要游戏状态流转控制功能,支持管理游戏从准备开始、进行中、暂停、结束等状态的切换逻辑
  17. 需要游戏音效开关控制功能,支持接收客户端音效设置指令,维护当前游戏会话的音效开启或关闭状态
  18. 需要游戏结算功能,支持在游戏结束或通关时生成包含最终得分、存活状态、通关关卡数等数据的结算报告

Claude 代码安全审查 (Claude Code Security Review)

Claude 代码安全审查 (Claude Code Security Review) 是一个基于 AI 的 GitHub Action 安全审查工具,利用 Claude 分析代码变更中的安全漏洞。包含了我个人的二次开发成果(Web 界面、全库扫描、可视化报告)。

Claude 代码安全审查器 (Claude Code Security Reviewer)

这是一个基于 AI 驱动的 GitHub Action 安全审查工具,利用 Claude 分析代码变更中的安全漏洞。该 Action 使用 Anthropic 的 Claude Code 工具进行深度语义安全分析,为 Pull Request (PR) 提供智能且具备上下文感知能力的安全评估。

功能特性

  • AI 驱动分析:利用 Claude 先进的推理能力,通过深度语义理解来检测安全漏洞。
  • 差异感知扫描:针对 PR,仅分析发生变更的文件。
  • PR 自动评论:自动在 PR 中针对发现的安全问题发布评论。
  • 上下文理解:超越简单的模式匹配,深入理解代码的语义逻辑。
  • 语言无关性:支持任何编程语言。
  • 误报过滤:通过高级过滤功能减少干扰,专注于真正的安全漏洞。

快速入门

将以下内容添加到您仓库的 .github/workflows/security.yml 文件中:

Peter Steinberger 开发 OpenClaw 的工作流程及 Agent 编码秘诀分析

通过 2026 年 git 提交历史记录,分析 Peter Steinberger (steipete) 开发 OpenClaw 的工作流程及 Agent 编码秘诀。

关键洞察总结

AI 是放大器,不是替代品

AI 的作用:

  • ✅ 做人类不想做的重复工作(去重、重构)
  • ✅ 快速覆盖大量代码(3天1400次提交)
  • ✅ 标准化和系统化(按模板提交)

人类的作用:

  • ✅ 创造性工作(新功能)
  • ✅ 质量把关(代码审查)
  • ✅ 决策和发布(版本管理)

可借鉴的经验

经验 说明
人机分工 人类做 creative,AI 做 repetitive
明确周期 人类开发期 → AI 重构期 → 人类收尾期
标准化 AI 喜欢模板,建立标准流程
小步快跑 每个阶段有明确目标,快速迭代

一、提交统计概览

总提交数: 8443 次提交在两个月内

峰值日产量:

  • 2026-02-22: 578 次提交
  • 2026-02-15: 478 次提交
  • 2026-02-16: 472 次提交

提交类型分布:

fix:     1557 (26%)
test:     815 (14%)
docs:     857 (14%)
refactor: 308 (5%)
feat:     363 (6%)
chore:    352 (6%)
style:    134 (2%)
build:     21 (0.3%)

二、工作流程核心模式

1️⃣ "Land #PR" 工作流

面向 AI 编码智能体的 Redis 设计模式与文档

Redis Patterns and Documentation for AI Coding Agents

Comprehensive Redis design patterns, best practices, and command references for LLM coding agents.(面向大语言模型(LLM)编码智能体的Redis 综合设计模式、最佳实践与命令参考。)

重要提示

Redis 特定文档:这些文档专门针对 Redis (https://redis.io),可能不适用于共享部分代码库的其他系统,如 Valkey、KeyDB、Dragonfly 或其他 Redis 兼容数据库。在使用这些分支或替代方案时,请验证兼容性,因为具体实现可能存在差异。

官方源码:官方 Redis 源代码可在 https://github.com/redis/redis 获取。

官方文档:有关权威的命令文档,请参阅官方文档库 https://github.com/redis/docs,其镜像站点为 https://redis.io/docs/

命令参考

官方 Redis 文档已在本地镜像:

  • 命令索引:按类别组织的各种命令的自动生成索引。
  • 命令文档:单个命令文件(例如 set.mdhset.mdzadd.md)。
  • 完整文档:包含开发 (develop/)、集成 (integrate/)、运维 (operate/) 指南。

三款顶级 AI 智能体架构深度拆解:从 Rust 原生高性能到 Python 极简主义

ZeroClaw:极致性能的 Rust 原生运行时。 凭借 <10ms 冷启动与 <5MB 内存占用,它证明了智能体可以像嵌入式插件一样轻盈。通过 Landlock 内核级沙箱与 Trait 驱动的模块化设计,ZeroClaw 定义了高并发、资源受限环境下的工业级标准。

IronClaw:坚不可摧的安全防御系统。 针对企业级痛点,它构建了包含隐私泄露检测、Docker 容器化隔离与任务状态机的深度防御体系,确保智能体在拥有自主权的同时,不逾越安全红线。

nanobot:大道至简的 Python 扩展框架。 仅用 4000 行代码便实现了基于 Markdown 的“人类可读”记忆系统。它通过 MCP 协议与插件化技能包,展现了极简主义架构下惊人的生态连接力。

ZeroClaw 项目架构设计分析

项目概述

ZeroClaw 是一个Rust 优先的高性能自主智能体运行时,专注于提供安全、高效、可扩展的智能体执行环境。它采用严格的架构设计原则,实现了在资源受限设备上的高性能运行,同时保持了强大的扩展能力。

核心架构特点

Agent 代码安全扫描、修复与渗透测试工具推荐

LLM/Agent 代码安全扫描 + 自动修复(扫描代码安全、修复)

这些项目用 LLM 驱动 Agent 动态运行/分析代码,找出真实漏洞并生成修复方案(远超传统静态扫描)。

首推:Strix(⭐ 20.6k)

  • 链接https://github.com/usestrix/strix
  • 核心功能:自主 AI “黑客” Agent,动态运行你的代码/应用 → 发现 IDOR、注入、XSS、权限绕过、业务逻辑漏洞等 → 自动生成 PoC 验证 → 一键输出可合并的 PR 修复补丁。
  • 支持 GitHub repo / 本地目录 / 线上 URL 扫描,多 Agent 协作、浏览器自动化、完整工具链。
  • 支持 OpenAI、Claude、Gemini、本地 LLM(LiteLLM)。
  • 安装一行命令:curl -sSL https://strix.ai/install | bash
  • 非常适合 CI/CD 集成,已有 GitHub Actions 示例。
  • 强烈推荐,目前最成熟的“找漏洞+自动修复”方案。

LLM/Agent 模拟渗透测试(自主黑盒/白盒渗透)

这些项目让 LLM Agent 像真实渗透测试员一样:规划 → 执行工具 → 分析结果 → 迭代攻击。

首推:PentestGPT(⭐ 11.8k) 链接:https://github.

Claude Cowork 知识工作插件(Knowledge Work Plugins)

知识工作插件(Knowledge Work Plugins)能将 Claude 打造为适配你岗位、团队与公司的专业助手。专为 Claude Cowork 打造,同时兼容 Claude Code

为何使用插件

Cowork 让你设定目标,Claude 即可输出完整、专业的成果。而插件能进一步赋能:你可以告诉 Claude 你的工作偏好、需要调用的工具与数据、关键工作流的处理方式,以及开放哪些斜杠命令——让团队获得更优质、更统一的结果。

每个插件都为特定职能打包了专业能力、工具连接器、斜杠命令和子智能体。开箱即用,就能让 Claude 快速上手协助对应岗位人员。真正的强大之处在于为你的公司定制化——适配你的工具、术语与流程,让 Claude 仿佛为你的团队量身定制。

插件市场

我们开源了 11 个基于实际工作打造与启发的插件:

OpenClaw Voice Call 插件使用方法和工作流程详解

一、插件概述

Voice Call 是 OpenClaw 的一个核心插件,允许用户通过 AI 助手发起和接收语音通话。它支持多种电话服务提供商(Twilio、Telnyx、Plivo),并提供两种主要通话模式:通知模式(Notify)和对话模式(Conversation)。

二、插件安装和配置

1. 安装方式

# 从 npm 安装(推荐)
openclaw plugins install @openclaw/voice-call

# 从本地开发(开发模式)
openclaw plugins install ./extensions/voice-call
cd ./extensions/voice-call && pnpm install

安装后需要重启 Gateway 网关。

2. 配置

~/.openclaw/config.json 文件中配置插件:

很难说清楚在过去两个月里,人工智能让编程发生了多大的变化:它不是以「往常一样逐步进展」的方式渐进发生的,而是就在去年十二月突然发生的。他指出,由于更高质量模型具备了「长期连贯性和执着性」,编程智能体「在十二月之前基本还不好用,但从那之后基本就能用了」。来源: Simon Willison 的网络日志

Andrej Karpathy

OpenClaw 智能体引擎工作流程及实现代码分析

1. 智能体引擎概述

OpenClaw 智能体引擎是基于 @mariozechner/pi-agent-core 构建的完整 AI 智能体执行系统,提供从简单的单智能体执行到复杂的多智能体协作的完整功能。它支持多种工具类型、安全沙箱执行、详细的会话管理和高度可扩展的架构。

2. 核心架构组件

2.1 主要入口文件

文件 功能
pi-embedded-runner.ts 智能体引擎主入口,导出所有核心功能
pi-embedded-runner/run.ts 核心执行逻辑,处理智能体运行流程
pi-embedded.ts 整合所有智能体相关功能的统一入口
agent-scope.ts 智能体配置解析和管理
workspace.ts 智能体工作区管理

2.2 核心执行流程

// 主执行函数
runEmbeddedPiAgent()
  → buildEmbeddedRunPayloads()  // 构建运行 payload
  → runEmbeddedAttempt()        // 执行单次尝试
    → resolveModel()            // 解析模型配置
    → 工具调用和交互
    → 结果处理和清理

3. 智能体引擎工作流程详解

3.1 初始化阶段

/llms.txt 文件

关于标准化使用 /llms.txt 文件以提供信息,帮助大语言模型(LLM)在推理阶段使用网站内容的提案。

Jeremy Howard 2024-09-03

背景

大型语言模型(LLM)越来越依赖网站信息,但面临一个关键限制:上下文窗口(Context Windows)太小,无法处理大多数完整的网站内容。将包含导航、广告和 JavaScript 的复杂 HTML 页面转换为 LLM 友好的纯文本内容既困难又不精确。

虽然网站同时服务于人类读者和 LLM,但 LLM 受益于在单一可访问位置收集的更简洁、专业级别的信息。这在开发环境等用例中尤为重要,LLM 需要快速访问编程文档和 API。

提案

llms.txt logo

我们建议在网站上添加一个 /llms.txt Markdown 文件,以提供 LLM 友好的内容。该文件提供简要的背景信息、指导和指向详细 Markdown 文件的链接。

llms.txt Markdown 既可以被人类阅读,也可以被 LLM 读取,同时具有精确的格式,允许使用固定的处理方法(即经典的编程技术,如解析器和正则表达式)。

我们进一步建议,网站上可能对 LLM 有价值的信息页面应提供该页面的干净 Markdown 版本,URL 与原始页面相同,但附加 .md 扩展名。(没有文件名的 URL 应附加 index.html.md 代替。)

大模型应用开发范式的演变

这四个术语是当前大模型应用开发的核心范式,从指令设计、信息管理、生成式编程到自主智能体构建,层层递进,共同构成了 AI 应用开发的技术栈。

以下是通俗易懂的拆解:

1. Prompt Engineering (提示工程)

这是最基础的技能,重点在于指令的质量。 如果把 AI 比作一个极其博学但有时听不懂人话的实习生,Prompt Engineering 就是学习如何写出完美的“任务说明书”。

  • 核心逻辑:通过调整输入的文字(提示词),引导模型输出更高质量的结果。
  • 常用技巧:给 AI 设定角色(“你是一个资深翻译”)、提供示例(Few-shot)、要求逻辑推演(Chain of Thought)。
  • 比喻:就像是在搜索引擎里输入更精准的关键词,或者给厨师下达非常具体的菜谱要求。

2. Context Engineering (上下文工程)

随着模型处理能力增强,大家发现“怎么说”固然重要,但 “给它看什么资料” 更重要。这就是上下文工程。

  • 核心逻辑:管理和优化输入给模型的信息流。AI 的记忆(上下文窗口)是有限的,你需要精准地挑选出最相关的背景知识喂给它。
  • 典型应用RAG (检索增强生成)。当你问关于公司手册的问题时,系统先去数据库里搜出相关的几段话,塞进对话框里,AI 才能据此回答。
  • 比喻:开卷考试。Prompt 是考题,Context 就是那本允许你带进考场的、划满了重点的参考书。

NanoClaw 完整文档(含使用、架构、安全与开发)

NanoClaw 是您的专属 AI 助手,可安全运行在容器中轻量设计易于理解,还能根据您的需求自由定制。 与复杂的 OpenClaw 不同,NanoClaw 坚持“小巧易懂”的哲学,仅由单一 Node.js 进程和少量源文件组成,无微服务或复杂配置。其核心安全机制在于利用 Linux 容器(macOS 上支持 Apple Container 或 Docker)进行操作系统级别的隔离,确保智能体只能在挂载的沙箱环境中运行,无法访问宿主机敏感数据。系统支持按群组隔离的持久记忆、可安排的任务调度及网络访问功能。独特的“技能优于功能”架构鼓励用户通过贡献技能脚本(如添加 Telegram 支持)来定制功能,而非直接修改核心代码,从而保持代码库的纯净与个性化适配。

README

NanoClaw Logo

NanoClaw —— 您的专属 Claude 助手,在容器中安全运行。它轻巧易懂,并能根据您的个人需求灵活定制。

我为什么创建这个项目

OpenClaw 是一个令人印象深刻的项目,愿景宏大。但我无法安心使用一个我不了解却能访问我个人隐私的软件。OpenClaw 有 52+ 个模块、8 个配置管理文件、45+ 个依赖项,以及为 15 个渠道提供商设计的抽象层。其安全性是应用级别的(通过白名单、配对码实现),而非操作系统级别的隔离。所有东西都在一个共享内存的 Node 进程中运行。

NanoClaw 用一个您能在 8 分钟内

NanoClaw 架构设计深度解析

NanoClaw 架构的核心洞察是:与其构建复杂的插件 API 来限制扩展的能力,不如利用 Git 的成熟合并机制来安全地组合任意代码变更。 AI(Claude Code)只在 Git 无法自动解决冲突时才介入,而且解决方案会被缓存(git rerere)以便下次自动应用。这使得大多数用户永远不会遇到未解决的冲突,同时保留了无限的定制能力

提示词(Kimi-2.5 Agent)

我没有理解 NanoClaw 这里的架构设计,结合源代码(https://github.com/qwibitai/nanoclaw )仔细研究一下,给我讲明白。

---
config:
  theme: base
  themeVariables:
    primaryColor: '#ffffff'
    primaryTextColor: '#1a202c'
    primaryBorderColor: '#e2e8f0'
    lineColor: '#94a3b8'
    secondaryColor: '#f8fafc'
    tertiaryColor: '#ffffff'
    fontSize: 14px
---
flowchart TB
 subgraph Philosophy["💡 设计哲学"]
    direction LR
        Git["🌲 Git 原生"]
        Direct["✏️ 直接代码修改"]
        Deterministic["🎯 确定性结果"]
  end
 subgraph ConflictResolution["⚔️ 三级冲突解决模型"]
    direction LR
        L1["<b>Level 1</b><br>🤖 Git 自动化<br><small>处理 95% 以上情况</small>"]
        L2["<b>Level 2</b><br>🧠 AI 辅助解决<br><small>Claude 处理边界</small>"]
        L3["<b>Level 3</b><br>👤 用户决策<br><small>极少数模糊场景</small>"]
  end
 subgraph SkillPackage["📦 Skill 包结构"]
    direction LR
        Manifest["manifest.yaml<br>配置"]
        Intent["SKILL.md<br>技能"]
        Add["add/<br>新增"]
        Modify["modify/<br>变更"]
  end
 subgraph SkillSystem["🎯 NanoClaw Skills 核心架构"]
    direction TB
        SkillPackage
        ConflictResolution
        Philosophy
  end
    L1 -- 冲突 --> L2
    L2 -- 无法决策 --> L3
    Philosophy --- ConflictResolution
    SkillPackage --> ConflictResolution

    style Deterministic fill:#f8fafc,stroke:#94a3b8
    style Direct fill:#f8fafc,stroke:#94a3b8
    style Git fill:#f8fafc,stroke:#94a3b8
    style L3 fill:#fffbeb,stroke:#f59e0b,stroke-width:2px,color:#92400e
    style L2 fill:#eff6ff,stroke:#3b82f6,stroke-width:2px,color:#1e40af
    style L1 fill:#f0fdf4,stroke:#22c55e,stroke-width:2px,color:#166534
    style SkillSystem fill:#ffffff,stroke:#cbd5e1,stroke-width:2px,color:#1e293b

一、项目定位:什么是 NanoClaw?

NanoClaw 是一个个人 Claude 助手,通过 WhatsApp 访问,具有以下特性:

  • 持久化记忆(按对话分组)
  • 定时任务调度
  • 容器隔离执行环境
  • 基于 Anthropic Claude Agent SDK

它的设计哲学是 "小到可以理解" ——整个代码库应该可以被一个人阅读和掌握,而不是像 OpenClaw 那样变成复杂的微服务架构。

二、核心架构:双层隔离模型

具身智能大脑:VLA 模型架构解析与训练实战

🦞 太空龙虾:基于 OpenVLA、π0、π0.5、π0.6 等核心论文

📋 目录

  1. VLA 模型概述
  2. 架构设计
  3. 数据工程
  4. 预训练策略
  5. 推理与部署
  6. 实战指南

1. VLA 模型概述

1.1 什么是 VLA 模型?

Vision-Language-Action (VLA) 是具身智能领域的核心范式,将三大核心能力端到端集成:

  • Vision:视觉感知(理解机器人看到的环境)
  • Language:语言理解(理解人类指令)
  • Action:动作生成(输出机器人执行的控制指令)

1.2 VLA 的革命性意义

传统机器人范式:

视觉感知 → 状态估计 → 任务规划 → 运动控制 → 执行

问题:各模块独立训练,误差累积,泛化能力弱

VLA 范式:

[图像 + 语言] → VLA 模型 → [动作序列]

优势:端到端训练,全局优化,泛化能力强

2. 架构设计

2.1 核心架构组件

2.1.1 视觉编码器(Vision Encoder)

作用: 将机器人视角的图像转换为特征表示

常用架构:

架构 特点 适用场景
ViT (Vision Transformer) 全局注意力,适合复杂场景 通用机器人操作
CLIP ViT 预训练视觉-语言对齐 开放场景理解
EfficientNet 高效,适合边缘部署 低功耗机器人
DINOv2 自监督预训练 少样本学习

输入维度: 单帧图像:[B, 3, H, W] 多帧历史:[B, T, 3,