CrabTalk

轻量透明的本地智能助手核心

Just the daemon, just attach.
无所隐藏，只有纯粹的智能核心。

CrabTalk 是一个仅 8MB 的后台守护程序，将所有智能助手的事件实时传输到你的客户端 —— 包括文本变化、工具调用、思考步骤与会话流转。告别臃肿的预装应用，构建完全属于你的 AI 基础设施。

---

✨ 核心优势

• 极致轻量：仅 8MB 体积，对比动辄 1GB 的同类产品
• 完全透明：每一个思考步骤、每一次工具调用都实时可见，无隐藏逻辑
• 本地优先：所有数据保留在你的设备上，无云端同步，无遥测回传
• 零供应商锁定：支持 OpenAI、Claude、Gemini、Ollama 等任意兼容端点，随时切换模型
• 按需连接：只接入你需要的功能模块，跳过不必要的组件

---

🚀 一分钟快速开始

一条命令即可完成安装：

curl -sSL https://crabtalk.ai/install | sh

支持 macOS（Apple Silicon/Intel）、Linux（x86_64/ARM）和 Windows（通过 MINGW/Git Bash）。若使用 Rust，也可通过 Cargo 从源码构建。

---

🎯 架构设计

多 Agent 协作

CrabTalk 可同时运行多个智能体，每个 Agent 拥有独立的模型配置、系统提示词和工具权限。通过 Delegation（委托）机制，Agent 能够将任务分配给专门的子 Agent，实现真正的分布式协作。

MCP 工具生态

通过 Model Context Protocol 连接外部工具服务器 —— 文件系统、数据库、代码解释器等。CrabTalk 自动发现可用工具，支持热重载配置，无需重启守护程序即可增减功能。

灵活的命令系统

采用 Cargo 风格的子命令分发机制：

• telegram：将 Telegram 机器人连接到你的 Agent
• search：内置 MCP 搜索服务，聚合 DuckDuckGo 和 Wikipedia
• 自定义扩展：任何命名为 crabtalk-<name> 的二进制文件都会自动成为子命令

---

💡 本地记忆与隐私

Agent 的记忆完全存储在本地 ~/.crabtalk/memory/ 目录，通过 BM25 算法实现高效检索：

• Remember：保存重要信息为结构化条目
• Recall：基于关键词自动检索相关记忆（自动 Recall 使用消息前 8 个词作为查询）
• Forget：精确删除不再需要的信息

特殊的 MEMORY.md 文件作为 Agent 的"工作记忆"注入每次对话，而 Crab.md 定义了 Agent 的身份与个性 —— 完全由你编辑掌控。当对话超过 Token 阈值时，系统会自动压缩历史记录，生成摘要保存到本地会话文件。

💾 你的数据只属于你。没有云端数据库，没有外部存储，记忆永远不会离开你的机器。

---

🔧 配置与扩展

通过 TOML 配置文件精确控制每个细节：

• 为不同 Agent 配置不同的模型提供商与系统提示词
• 设置工具使用范围（Skills 和 MCP 服务器白名单）
• 配置心跳任务，实现定时自动执行

所有配置变更支持热重载，保存即生效。通过 CrabTalk Hub 可一键安装社区提供的 MCP 服务器、Agent 配置和自定义命令。