Tiny Claw（Mandibles）
一只轻量自主的个人 AI 伙伴：核心极小、插件化架构，通过自我改进记忆与智能分层路由，把 AI 陪伴做得简单、便宜、真正个人化。
信任：源码归属得满分——README 的 Credits 段详尽列出 OpenClaw、SHIELD.md、Bun、WG Tech Labs 等灵感与组件来源，且明确否认加密代币关联。依赖安全得 2 分：CI 中所有 GitHub Actions 按提交 SHA 固定版本、启用每周 CodeQL 扫描、package. 对 undici 做了 override。最低权限、用户确认、敏感数据处理、回滚均只得 1 分：README 宣称路径沙箱、权限引擎、AES-256-GCM 秘密管理、自动备份，但提供的源码中没有这些实现，静态审查无法核实，断言缺乏支持。数据流透明与外部影响各 1 分：代理可执行 shell、访问云端 LLM（Ollama Cloud），但未见对数据外发范围的用户可见说明。未发现恶意行为或红色线条风险。
可靠性：自洽性 2 分——README 的架构描述与 package. 工作区、目录结构基本吻合；扣分点是版本标注 2.0.0 却声明'重度开发中，随时会坏'，定位矛盾。依赖可用性 2 分——CI 使用 --frozen-lockfile 并固定 Bun 版本，可复现构建有保障；扣分点是对 Ollama Cloud 等外部服务的可用性无降级说明。失败消息 2 分——compactor 测试明确验证 provider 失败时优雅返回 null 不崩溃；但 shell/沙箱等高风险路径的错误处理无证据。
适应性：受众与场景 3 分——README 明确定位为个人非企业用户，附对比表、哲学说明与科幻参照，场景边界清晰。能力边界 2 分——明确'人格不可覆盖'并在警告块声明未发布状态；扣分点是各子系统的具体限制未文档化。触发精度 1 分——8 维分类器与智能路由仅见于宣传表格，无代码或测试佐证其精度。环境适配 2 分——Bun 原生、SQLite 持久化、零配置文件的自配置路径清楚；扣分点是 Quick Start 未列 Bun 前置要求。
规范：信息架构 3 分——项目结构逐目录注释，包职责划分明确。许可证 3 分——完整 GPL-3.0 文本随库分发，README 与 package. 一致声明。已知局限 2 分——显式警告'正在重度开发，运行可能破坏体验，请等首个正式版'，这是诚实的；扣分点是缺乏子系统级别的已知问题清单。安装说明仅 1 分——只有两条命令，无前置条件、无故障排查。命名稳定性 2 分——明确与 OpenClaw 划清界限并解释命名由来，但项目处于 2.0.0 且 API 未承诺稳定。示例与 FAQ 1 分——仅一个 channel 插件指南链接，无使用示例。版本日志 1 分——未见 CHANGELOG。维护责任 2 分——单一可识别作者、issue 模板指引、CI 门禁齐全；扣分点是单人维护的持续性风险未说明。
有效性：输出可用性 2 分——Web UI（Svelte 5、SSE 流式）与 CLI 双入口，界面描述具体；但均无源码佐证体验质量。边际价值 2 分——'从零构建、插件化、内置免费 Ollama Cloud'与现有框架差异化明确；扣分点是竞品对比表为自我声明。成本收益 2 分——分层路由与 4 层上下文压缩针对成本设计，并有压缩率统计测试佐证；扣分点是节省幅度无基准数据，且项目自述'现在运行可能损害体验'，现阶段使用收益存疑。
可验证性：主张可追溯 1 分——README 提出大量量化或技术主张（8 维分类器、5 层安全、3 层记忆），但提供的源码仅覆盖压缩器一个子系统，多数主张无法在本次审查中溯源；扣分点是主张与可见代码覆盖严重失衡。跨源印证 2 分——compactor 的测试确实印证了'4 层压缩管线、分层摘要、指标统计'的部分主张，package./CI 与 README 结构互相吻合；但其他子系统无第二来源。事实与推断分离 2 分——README 用 NOTE/WARNING/CAUTION 块区分既成事实与前瞻计划，措辞总体克制；扣分点是对比表将推断性优势表述为既定事实。
- 项目自述处于重度开发阶段且'随时会坏'，官方明确建议等待首个正式版——静态审查不应被视为可用性背书。
- 安全声明（沙箱、权限引擎、SHIELD.md 强制、AES-256-GCM 秘密管理）在本次提供的源码中均不可核实，请勿据此假设存在实际防护。
- 代理具备 shell 执行与云端 LLM 通信能力，部署前应自行审查数据外发范围与密钥管理实现。
- Quick Start 未列 Bun 运行时前置要求，实际安装可能受阻。
- 多数核心主张（8 维路由、5 层安全、子代理委派）缺少代码级佐证，需在首个正式发布后重新评估。
这个 Agent 能做什么，适合哪些场景？
Tiny Claw（代号 Mandibles，蚂蚁）是 Waren Gonzaga 开发的自主个人 AI 伴侣框架，明确声明不是 OpenClaw 的缩小版，而是从零构建的独立原生框架。它运行在 Bun 运行时上，核心极小，频道、模型提供商和工具全部以插件形式存在于 plugins/ 目录，packages/ 下拆分为 core、memory、router、compactor、heartware、delegation、shield、sandbox 等 20 个聚焦模块。它内置 3 层自适应记忆（情景记忆、语义 FTS5、时间衰减）、4 层上下文压缩管线、8 维查询分类器驱动的智能路由（简单问题走便宜模型）以及 SHIELD.md 反恶意软件执行引擎。默认内置 Ollama Cloud 提供商（含 kimi-k2.5:cloud 和 gpt-oss:120b-cloud 两个模型），并提供 Discord 风格的 Svelte 5 Web 界面（SSE 实时流式输出）。项目仍在高强度开发中，官方提示可能不稳定，且明确声明没有任何加密代币。
运行 bun install && bun start 后，Tiny Claw 在本地启动并通过 http://localhost:3000 提供对话式引导配置，无需手动配置文件。它通过 conversation 让代理自我配置，使用 packages/memory 的 3 层记忆系统（情景记忆 + SQLite FTS5 全文检索 + 时间衰减）从每次对话中学习；packages/router 的 8 维查询分类器将请求按复杂度分层路由到已安装的 provider 插件（内置 Ollama Cloud，可装 OpenAI、Anthropic 插件并自动故障转移）；packages/compactor 以规则预压缩、shingle 去重、LLM 摘要和 L0/L1/L2 分层摘要压缩上下文；packages/delegation 编排子代理（黑板协作、自适应超时），packages/intercom 提供 pub/sub 代理间通信；packages/shield 在运行时执行 SHIELD.md 反恶意软件策略，配合路径沙箱、内容校验、审计日志、自动备份和限速共 5 层安全。
- 想要一个像 Fallout 中 Codsworth 那样有独立个性、随时间成长的朋友式 AI 伴侣的个人用户
- 对 token 成本敏感、希望简单问题走便宜模型、复杂问题才调用强模型的开发者和重度用户
- 不想写配置文件、希望代理通过对话自我配置的非技术用户
- 需要多个子代理协作完成任务并通过事件总线互通信息的自动化场景
- 已有 OpenAI 或 Anthropic API、想通过 provider 插件接入自己的模型账号的用户
- 希望在本地自托管、通过 Discord 风格 Web UI 使用的隐私敏感用户
这个 Agent 有哪些优点和局限？
- 从零构建的原创框架，零依赖外部 AI 框架，核心极小且非单体架构
- 3 层自适应记忆（情景记忆、FTS5、时间衰减）和 4 层上下文压缩显著降低长期使用的 token 成本
- 8 维智能路由按查询复杂度分层调用模型，并随已安装 provider 插件自适应
- 内置 SHIELD.md 反恶意软件执行引擎加 5 层安全（路径沙箱、内容校验、审计日志、自动备份、限速）
- 内置免费 Ollama Cloud 提供商，无需 Claude Pro/Max 订阅即可起步
- 自带 Discord 风格 Web UI、子代理委派系统和代理间 pub/sub 通信
- 项目处于高强度开发中，官方明确警告功能可能损坏，尚无首个正式发布
- 强依赖 Bun 运行时，非 Node.js 22 + pnpm 生态，迁移或集成需适配
- 没有官方加密代币，任何以 Tiny Claw 名义发行的代币均与项目无关，需警惕冒牌项目
- 核心带有不可覆盖的独立个性（Heartware 系统），不适合需要完全自定义系统提示词的场景
- OpenAI/Anthropic 等模型需通过 provider 插件接入，内置开箱即用的只有 Ollama Cloud
如何安装或部署这个 Agent？
前置要求：安装 Bun 运行时，注册 Ollama Cloud 免费账号（内置默认提供商）。安装步骤：git clone 仓库后执行 bun install 安装依赖。项目处于活跃开发期，官方警告运行当前版本可能不稳定，建议等待首个正式发布。
如何使用这个 Agent？
在项目目录执行 bun start，打开 http://localhost:3000，Tiny Claw 会引导完成剩余设置，无需配置文件；首次设置时在 kimi-k2.5:cloud（默认）和 gpt-oss:120b-cloud 之间选择模型，之后可通过对话随时切换。开发模式：bun dev（热重载）；构建：bun build；测试：bun test。频道与提供商均为插件，可参考 plugins/channel/README.md 开发插件。
这个 Agent 与同类方案有什么区别？
README 将 Tiny Claw 与其他 AI 代理框架（如基于 Pi、Claude Code、Codex 构建的框架及 OpenClaw）对比：Tiny Claw 是从零构建的原创框架，核心极小、插件化，内置自我改进记忆与分层路由，并自带 Web UI 和 SHIELD.md 安全层；而 OpenClaw 是其灵感来源（龙虾 vs 蚂蚁），其他框架通常构建在现有框架之上、核心逐渐膨胀、每条查询都打到最贵模型且需要 Claude Pro/Max 订阅或多个 API 密钥。