tashfeenahmed/scallopbot

这是什么？

核心功能

• 01记忆随时间衰减、融合与归档，检索结合 BM25 与向量嵌入。
• 02按成本路由，支持七家 LLM 提供商故障切换，并设置每日和每月预算。
• 03双向支持 MCP：既可调用 MCP 服务器，也可向其他客户端暴露记忆工具。
• 04后台定时执行夜间记忆整合、自我反思和主动待办扫描。
• 05兼容 OpenClaw 与 agentskills.io 格式技能，内置 34 个技能。
• 06支持本地语音识别与合成，Web 控制台可安装为应用。

适用场景

• 在家用服务器或树莓派上部署私人常驻助手，通过 Telegram 随时联系。
• 让聊天助手与 Claude Code 等编程工具通过 MCP 共享同一份长期记忆。
• 通过在不同价位模型间路由并设置预算上限，控制 LLM 调用开销。
• 研究超越简单笔记存储的智能体记忆机制。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/tashfeenahmed/scallopbot.git
2. 2

   进入目录并安装依赖

   cd scallopbot && npm install
3. 3

   将 .env.example 复制为 .env 并至少填入一个大模型服务商的 API 密钥,然后构建

   npm run build
4. 4

   启动机器人;控制面板位于 http://localhost:3000

   node dist/cli.js start

使用前须知

• !需要 Node.js 24 或更新版本。
• !运行至少需要一个大模型服务商的 API 密钥,通常需付费。
• !尚未发布到 npm 仓库,需要从源码克隆后自行构建。

标签

常见问题

scallopbot 是什么？

可自托管的个人 AI 助手，记忆会随时间融合、关联与遗忘，支持 MCP 并兼容 OpenClaw 技能。 ScallopBot 是一个运行在自有服务器上的个人 AI 助手，可通过 Telegram、Web 控制台、命令行，以及 Discord、Slack、WhatsApp、Signal、Matrix 等渠道与你交互。记忆保存在一个 SQLite 文件中，结合 BM25 关键词检索、向量嵌入和可选的 LLM 重排序。记忆会按类别随时间衰减，相近内容会融合成摘要，低价值条目先归档再清理。

scallopbot 可以免费使用吗？用的什么许可证？

scallopbot 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

scallopbot 还在维护吗？

活跃维护中。scallopbot 最近一次提交是在 2026年10月16日。

scallopbot 适合用来做什么？

在家用服务器或树莓派上部署私人常驻助手，通过 Telegram 随时联系。 让聊天助手与 Claude Code 等编程工具通过 MCP 共享同一份长期记忆。 通过在不同价位模型间路由并设置预算上限，控制 LLM 调用开销。 研究超越简单笔记存储的智能体记忆机制。

scallopbot 怎么安装和运行？

克隆仓库: git clone https://github.com/tashfeenahmed/scallopbot.git 进入目录并安装依赖: cd scallopbot && npm install 将 .env.example 复制为 .env 并至少填入一个大模型服务商的 API 密钥,然后构建: npm run build 启动机器人;控制面板位于 http://localhost:3000: node dist/cli.js start

在哪里获取 scallopbot？

源代码和安装说明在 GitHub 上：https://github.com/tashfeenahmed/scallopbot