LettaBot

项目概述#

LettaBot 是由 Letta 官方（letta-ai 组织）推出的跨平台个人 AI 助手，底层基于 Letta Code SDK 构建。它以单一 Agent 身份在 Telegram、Slack、Discord、WhatsApp 和 Signal 等多个聊天平台上无缝运行，并提供跨平台、跨会话的持久化统一记忆能力。主要语言为 TypeScript（89.1%），运行时要求 Node.js 20+，当前版本为 v0.2.0-alpha.12，已有 463 次提交。

核心能力#

多通道接入与交互#

• 同一 Agent 无缝接入 Telegram、Slack、Discord、WhatsApp、Signal
• 群组精细控制：支持 open、listen、mention-only、disabled 四种模式
• 流式响应，支持实时消息更新
• 语音消息：入站自动转录（OpenAI Whisper / Mistral Voxtral），出站语音合成（ElevenLabs / OpenAI TTS），原生语音气泡渲染

记忆与上下文管理#

• 统一记忆：单一 Agent 记住所有通道上的对话
• 持久记忆：支持跨会话（天/周/月）的对话记忆持久化

主动行为与自动化#

• 心跳检查：定期自动检查并审查任务
• 调度系统：支持创建一次性提醒和循环 Cron 任务

工具与技能扩展#

• 本地工具执行：Agent 可读取本地文件、搜索代码
• Skills 系统：兼容 skills.sh 和 ClawdHub 技能市场，内置 1Password 等技能
• Home Assistant 集成：通过 ClawdHub 技能实现智能家居控制
• 信息流摄取：只读模式接入 Bluesky Jetstream 流，支持按 DID 过滤

接口与安全#

• OpenAI-Compatible API：暴露 /v1/chat/completions 和 /v1/models 端点
• 访问控制：支持配对码机制
• 默认安全模型将工具执行限制为只读操作（Read、Glob、Grep、web_search、conversation_search）

架构要点#

• 全出站连接架构：完全无需公网 URL 或网关。Telegram 采用长轮询，Slack/Discord 使用 WebSocket，WhatsApp 使用 Baileys 出站 WebSocket，Signal 通过本地守护进程（127.0.0.1）通信
• 会话模型：默认单 Agent + 单共享会话；可配置为按通道隔离会话（底层依然共享 Agent 记忆）
• 后台任务机制：心跳和 Cron 任务运行于"静默模式"，Agent 必须通过 CLI 主动决策是否发送消息
• 发布流程：通过 GitHub Actions 自动化，基于版本标签触发构建、测试与发布说明生成
• 部署方式：支持 Railway（含 railway.toml）、Docker（含 Dockerfile）及开发模式热重载（npm run dev）

安装与使用#

前置条件：Node.js 20+、Letta API Key（来自 app.letta.com）或自托管 Letta Docker Server、至少一个通道凭证。

git clone https://github.com/letta-ai/lettabot.git
cd lettabot
npm install && npm run build && npm link
lettabot onboard
lettabot server

可选连接 ChatGPT 订阅：lettabot connect chatgpt

自托管后端：

docker run -v ~/.letta/.persist/pgdata:/var/lib/postgresql/data -p 8283:8283 -e OPENAI_API_KEY="your_key" letta/letta:latest

CLI 与配置#

核心命令包括 lettabot onboard（交互式设置）、lettabot connect（连接模型提供商）、lettabot server（启动服务）、lettabot configure（编辑配置）、lettabot skills status（查看技能）、lettabot destroy（重置数据）。Bot 交互命令：/start、/status、/heartbeat。

Agent CLI 工具示例：

lettabot-message send --text "Hello from a background task"
lettabot-react add --emoji :eyes: --channel discord --chat 123 --message 456
lettabot-history fetch --limit 25 --channel discord --chat 123456789

配置文件 lettabot.yaml 支持设置会话模式（shared / per-channel）、心跳策略、各通道群组消息处理规则及用户白名单等。

待确认信息#

• letta.bot 官网实际可用性未在 README 中直接验证
• Letta Code SDK 的独立仓库/文档链接未公开
• 完整支持的 LLM 模型列表未明确列出
• skills.sh 平台完整 URL 未提供
• Moltbot 关联项目的具体仓库链接未给出