OpenSquilla — 高效Token的AI代理
同一预算，更高智能密度：本地模型路由、持久记忆与统一网关，让每个Token都发挥最大价值。
- Star 数
- ★ 7.1k
- 最近更新
- 1 天前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 开发者希望在本地开发时使用多个 LLM 提供商，但不想为每个模型手动切换配置，可通过 OpenSquilla 的自动路由降低 token 成本。
- 不适合
- 希望开箱即用、不愿处理未签名安装包或手动迁移数据的用户
- 对遥测敏感、要求默认零数据外发的组织
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
OpenSquilla 是一款以 token 效率为核心的微内核 AI 代理。核心组件是本地模型路由器 SquillaRouter（基于 LightGBM 与 ONNX 的轻量分类器），它在设备端为每一轮对话选择成本最低且能胜任的模型，并通过四层分级（C0–C3）实现智能路由。系统提供统一的 TurnRunner 循环，支撑 Web UI、CLI 和多聊天渠道，并集成持久本地记忆（SQLite 全文搜索与 sqlite-vec 语义召回）、分层安全沙箱、内置工具（文件操作、Shell、Git、网页搜索、图像生成等）以及可插拔的 20+ LLM 提供商适配层（TokenRhythm、OpenRouter、OpenAI、Anthropic、Ollama、DeepSeek 等）。OpenSquilla 采用 Apache-2.0 许可，支持 Windows、macOS 和 Linux，并提供桌面安装包、快速终端安装、源码安装和 Docker 镜像。当前稳定版为 0.5.2，其 PinchBench 基准测试显示，在保持相近得分的同时，token 消耗与成本远低于单一高端模型方案。
OpenSquilla 通过 opensquilla 命令行提供完整的代理生命周期：onboard 向导配置提供商和路由器，gateway run 启动 Starlette ASGI 服务器（默认 127.0.0.1:18791），提供 Web UI 控制台（/control/）和 WebSocket RPC。chat 启动交互式 REPL，agent -m "提示" 执行单次自动化任务。在每一轮对话中，SquillaRouter 在本地分析文本特征（长度、语言、代码、关键词、语义嵌入），并将请求路由至分层的模型池（C0–C3），同时动态调整推理复杂度和系统提示。内置 15 种按需技能（编码、GitHub、cron、Office 文档生成等），支持 MCP 客户端与服务端（通过 mcp extra）。持久记忆通过 MEMORY.md 和 Markdown 笔记管理，支持全文搜索和语义召回。安全沙箱提供三级策略，在 Linux 使用 Bubblewrap，macOS 使用 Seatbelt，Windows 使用 native 后端。统一网关使 Web UI、CLI、Slack、Telegram、Discord、飞书、钉钉、企业微信、Matrix、QQ 等渠道共享同一执行循环，支持工具调用、重试和决策日志。
- 开发者希望在本地开发时使用多个 LLM 提供商，但不想为每个模型手动切换配置，可通过 OpenSquilla 的自动路由降低 token 成本。
- 团队需要一个统一的 AI 助手网关，同时接入 Slack、飞书、Telegram 等聊天工具，并在 Web UI 和 CLI 中保持一致的交互。
- 数据科学家需要处理长文档或代码库，希望持久记忆和语义搜索帮助快速检索相关信息。
- 系统管理员希望在受限环境中运行 AI 代理，需要强沙箱隔离和权限控制，以监控自主操作的副作用。
- 需要将 AI 代理集成到自动化流程中，通过单次
agent命令和 JSON 输出完成特定任务，如数据提取、代码生成或报告生成。
如何安装或部署这个 Agent？
快速终端安装（推荐）：确保 uv 已安装（否则先安装），然后执行 uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.2/opensquilla-0.5.2-py3-none-any.whl"。Windows 用户还可下载 exe 安装包，macOS 用户使用 dmg。从源码安装：克隆仓库（含 LFS），运行 bash scripts/install_source.sh（macOS/Linux）或 PowerShell 脚本，需先安装 Git、Git LFS、Node.js 22.12+ 和 uv。
如何使用这个 Agent？
运行 opensquilla onboard 进行首次配置，按向导选择提供商（如 OpenRouter）并设置 API key（建议通过 --api-key-env 环境变量传递）。然后启动网关：opensquilla gateway run，打开 http://127.0.0.1:18791/control/ 使用 Web UI，或使用 opensquilla chat 进行交互对话。单次任务可执行 opensquilla agent -m "你的问题"。使用 opensquilla doctor 检查系统健康。
这个 Agent 有哪些优点和局限？
- 本地模型路由在设备端进行分类，提示词不出设备，保护隐私。
- 支持 20+ LLM 提供商，无单一供应商锁定。
- 内置持久记忆（语义搜索）和分层安全沙箱，增强上下文和安全性。
- 统一网关支持多渠道（Web UI、CLI、聊天应用），保持一致的执行环境。
- 提供桌面安装包和 Docker 镜像，部署选项丰富。
- 需要 Python 3.12 和 uv，且从源码构建时依赖 Node.js，安装复杂度中等。
- SquillaRouter 在 macOS 和 Windows 上需要额外安装原生库（如 libomp、VC++ 运行时），否则路由器不可用。
- 默认发送匿名遥测数据（可配置关闭），可能涉及隐私顾虑。
- Windows 桌面安装包未签名，可能触发 SmartScreen 警告。
- 从 OpenClaw/Hermes 迁移需要显式操作，且可能涉及数据冲突处理。
这个 Agent 与同类方案有什么区别？
README 中对比了 OpenSquilla 与 OpenClaw（作者称受到其启发），在 PinchBench 1.2.1 基准上，OpenSquilla 以 0.9251 得分接近 OpenClaw 的 0.9255，但 total cost 仅为 $0.688 vs $6.233，输入 token 大幅减少。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenSquilla — 高效Token的AI代理 当前 | 51 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 7.1k | 1 天前 | Python | OpenAI API · Claude API |
| OmniRoute — 免费 AI 网关 | 60 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 78k | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| Code Puppy | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 869 | 今天 | Python | Codex · OpenAI API · Claude API |
| OpenClaude — 通用终端 AI 编程代理 | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 34k | 今天 | TypeScript | Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README详细说明了安装遥测、数据收集范围（明确列出发送与不发送的数据）、隐私开关（OPENSQUILLA_PRIVACY_DISABLE_NETWORK_OBSERVABILITY）以及卸载时保留数据的选项。这体现了数据流透明性和敏感数据处理方面的良好实践。但缺少对权限最小化、用户确认机制（如工具执行前确认）的具体描述，外部影响（如网络请求）虽有说明但未提供用户控制细节。回滚方面，卸载命令支持--dry-run和保留数据，但未提及配置或状态回滚。来源归属方面，作者列为'OpenSquilla contributors'，但发布者未验证，且未提供明确的贡献者归属或来源追溯。因此，数据流透明性得2分，敏感数据处理得2分，回滚得2分，其余因证据不足或仅部分覆盖得1分。
证据显示：README和pyproject.toml中版本号一致（0.5.2），CI配置包含多个测试矩阵，表明项目内部一致性较好。但依赖可用性方面，依赖列表广泛且包含多个可选extras，但未提供依赖锁定或版本固定策略，可能影响可复现性。失败消息方面，README提到了一些错误处理（如DLL load failed、libomp缺失），但未系统性地描述错误消息设计。因此，自一致性得2分，依赖可用性和失败消息各得1分。
证据显示：README明确列出了目标受众（桌面用户、终端用户、开发者）和多种使用场景（桌面安装、快速终端安装、从源码安装、开发），并提供了详细的安装路径选择。能力边界方面，文档说明了哪些功能需要额外extras（如matrix、document-extras），但未明确说明Agent的能力限制。触发精度方面，未详细描述命令或工具的触发条件。环境适配方面，支持Windows、macOS、Linux，并提供了针对不同平台的安装说明。因此，受众与场景得2分，能力边界得2分，环境适配得2分，触发精度得1分。
证据显示：README结构清晰，包含安装、配置、运行、卸载等章节，信息架构良好。安装说明非常详细，覆盖多种平台和方式，得3分。命名稳定性方面，项目名称和命令（opensquilla）一致，但未提供API或配置的稳定性保证。示例和FAQ方面，README提供了多个命令示例，但未提供FAQ。已知限制方面，README提到了一些平台特定的问题（如Windows DLL、macOS libomp），但未系统性地列出所有限制。许可证为Apache-2.0，文件完整，得3分。版本和变更日志方面，README提到了版本0.5.2，但未提供详细的变更日志。维护责任方面，作者列为'OpenSquilla contributors'，但未明确维护者或贡献指南。因此，信息架构得2分，安装说明得3分，命名稳定性得1分，示例和FAQ得2分，已知限制得1分，许可证得3分，版本和变更日志得1分，维护责任得1分。
证据显示：README描述了产品的核心价值（token效率、智能路由、持久记忆、安全沙箱），并提供了多种使用方式（CLI、Web UI、聊天渠道），表明输出可用性较好。边际价值方面，产品声称在相同预算下提供更高智能密度，但缺乏独立验证。成本效益方面，文档提到了token效率，但未提供具体成本数据。因此，输出可用性得2分，边际价值得2分，成本效益得2分。
证据显示：README中的一些声明（如'Token-efficient'、'higher intelligence density'）缺乏具体数据或引用支持，因此声明可追溯性得1分。跨来源佐证方面，未提供外部验证或独立测试结果，得1分。事实与推断分离方面，文档将产品特性描述为事实，但未明确区分哪些是推断或承诺，得1分。
- 发布者身份未验证，需谨慎对待来源。
- README中的性能声明（如'更高智能密度'）缺乏独立验证，不应视为事实。
- 安装遥测默认启用，需用户主动禁用，注意隐私影响。
- 依赖未锁定版本，可能影响可复现性和安全性。
- 未提供详细的变更日志，版本演进不透明。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.5.6 OpenSquilla 0.5.6
发布说明摘录
OpenSquilla 0.5.6 Overview Core bug fixes, improved long-session compaction, and Browser Use (Beta). ✨ What's Improved - Compaction and long sessions: manual and automatic compaction now share model-aware budgets that account for instructions, tools, and attachments. Bounded history recovery can keep work moving when a summary fails, without replacing the saved history; active input and pending tool work stay protected. - Task and connection reliability: fixes for Gateway reconnects, durable …在 GitHub 查看 ↗ -
v0.5.5 OpenSquilla 0.5.5
发布说明摘录
OpenSquilla 0.5.5 Overview C5 multi-model fusion, more reliable tasks, persistent workspaces, Tencent SkillHub, and signed Windows installers. ✨ What's Improved - C5 fusion: four models draft responses in parallel, then a tool-capable model combines them into a final answer. - Chats, Plans, and Goals: better reconnect recovery, saved attachment drafts, editable task progress, and clearer pause, resume, and cancellation. - Workspaces and documents: persistent task files, local HTML previews, inline file actions, and bounded document reading and editing. …在 GitHub 查看 ↗ -
v0.5.4 OpenSquilla 0.5.4
发布说明摘录
OpenSquilla 0.5.4 Overview OpenSquilla 0.5.4 is a feature and maintenance release for the 0.5 stable line. It introduces a beta for versioned, single-file HTML editing in Electron Desktop, optional Runtime Packs with slimmer installers, per-chat model routing, and a more resilient C3 multi-model fusion path. It also improves chat continuity, Desktop startup and recovery, provider behavior, Skills, attachments, process lifecycle handling, and the Web interface. Existing gateway configuration, chats, Agents, memory, and scheduled jobs stay …在 GitHub 查看 ↗
常见问题
OpenSquilla 支持哪些 LLM 提供商？
如何关闭遥测？
OPENSQUILLA_PRIVACY_DISABLE_NETWORK_OBSERVABILITY=true，或在配置文件中设置 [privacy] disable_network_observability = true。SquillaRouter 在 macOS 上报 libomp 错误怎么办？
Library not loaded: @rpath/libomp.dylib，需要安装 Homebrew 的 libomp：brew install libomp，然后重启网关。OpenSquilla 会在未安装时继续以单模型路由运行。能否将 OpenSquilla 集成到现有的 OpenClaw 或 Hermes 环境？
opensquilla migrate openclaw --apply 或 opensquilla migrate hermes --apply 命令，先运行 --json 进行 dry-run 检查。在 Docker 中如何部署？
OPENSQUILLA_GATEWAY_IMAGE=ghcr.io/opensquilla/opensquilla:latest docker compose up -d，或从源码构建镜像：docker build -t opensquilla:local .。