KinBot

自托管 AI Agent 平台，具备持久记忆、多 Agent 协作与多通道集成能力

项目概述#

KinBot 是由 MarlBurroW 组织维护的开源自托管 AI Agent 运行平台，Slogan 为 "AI agents that actually remember you."。它解决的核心问题是主流 LLM 对话缺乏跨会话持久记忆、缺乏与外部系统的深度集成能力，以及多 Agent 之间无法有效协作。

核心能力#

持久记忆与智能#

持久记忆：通过 SQLite（FTS5 全文检索 + sqlite-vec 向量相似度）实现双路召回，跨月对话上下文不丢失
知识库 / RAG：上传文档自动索引，支持基于知识库的问答
Session Compacting：旧消息压缩为望远镜式合并摘要，原始消息始终保留（无删除策略）
子代理（Sub-agents）：Agent 可生成 worker 处理子任务
代理间通信：Kins 之间可对话、委托、协作，通过记忆共享上下文
连续会话：永不重置的会话流

自动化与集成#

Cron 定时任务：基于 Croner 实现自动化计划执行
Webhooks：外部系统事件驱动触发
HTTP 请求工具：Agent 可主动发起外部 API 调用
6 个消息通道：Telegram、Discord、Slack、WhatsApp、Signal、Matrix
MCP Server 支持：Model Context Protocol 集成（具体兼容列表待确认）
自定义工具 & Mini Apps：可扩展的工具与轻量应用
插件系统：社区插件 + 自定义插件，含 create-kinbot-plugin 脚手架
Contacts（联系人）：Agent 可维护用户关系网络
Human-in-the-loop：关键决策需人工确认
23+ AI Provider：Anthropic、OpenAI、Gemini、Mistral、DeepSeek、Groq、Ollama、OpenRouter、Cohere、xAI 等，覆盖 LLM、embedding、image、search provider
多 Provider 自动检测：自动选择可用 provider

安全与隐私#

AES-256-GCM 加密保险库：密钥永不暴露在 prompt 中；redaction 机制防止密钥泄露进摘要
角色认证：基于角色的权限控制（基于 Better Auth）
邀请系统：受控用户注册
100% 自托管：数据永不离开用户服务器

用户体验#

8 套调色板 + Dark/Light/System 主题
英文 & 法文双语（i18next）
@提及自动补全、文件上传、图片生成
实时 SSE 流式响应

架构设计#

单进程架构，基于 Bun + Hono + React 19，SQLite 单文件存储（FTS5 + sqlite-vec）。关键设计机制包括：

Queue per Kin：每个 Kin 一次处理一条消息，用户消息优先于自动化消息，避免并发冲突
Global SSE：每浏览器标签仅一个 SSE 连接，按 kinId 多路复用，无逐 Kin 轮询开销
No message deletion：compacting 将旧消息压缩为日期摘要，原始消息始终保留于数据库
Secrets stay in vault：保险库密钥永不暴露在 prompt 中，redaction 防止泄露进摘要

Channels (Telegram/Discord/Slack/WhatsApp/Signal/Matrix)
          │
┌─────────┴──────────────────────────────────────┐
│              KinBot (single process)            │
│  ┌──────────────┐    ┌─────────────────────┐   │
│  │ React + Vite │◄──▶│ Hono REST API + SSE │   │
│  │ Tailwind 4   │    └──────────┬──────────┘   │
│  │ shadcn/ui    │               │               │
│  └──────────────┘    ┌──────────▼──────────┐   │
│                      │ Vercel AI SDK       │   │
│                      │ Kin Engine          │   │
│                      └──────────┬──────────┘   │
│  Queue(FIFO) · Croner(cron) · Mini Apps · Plugins │
│                      ┌──────────▼──────────┐   │
│                      │ SQLite + FTS5       │   │
│                      │ + sqlite-vec        │   │
│                      └─────────────────────┘   │
└───────────────────────────────────────────────┘
          │                               │
  AI Providers (23+)               Integrations
                                  (MCP, Webhooks, Tools)

部署方式#

Docker（推荐）#

docker run -d --name kinbot -p 3000:3000 -v kinbot-data:/app/data ghcr.io/marlburrow/kinbot:latest

打开 http://localhost:3000，引导向导处理后续配置。

其他方式#

一键脚本：项目内 install.sh
Docker Compose：docker/ 目录提供编排文件
手动安装：需 Bun >= 1.0

开发环境#

git clone https://github.com/MarlBurroW/kinbot.git
cd kinbot
bun install
bun run dev    # Vite dev server (5173) + Hono backend (3333)

关键配置#

变量	默认值	说明
`PORT`	`3333`	HTTP 服务端口
`HOST`	`127.0.0.1`	绑定地址（`0.0.0.0` 对外暴露）
`KINBOT_DATA_DIR`	`./data`	持久化数据目录
`ENCRYPTION_KEY`	自动生成	AES-256-GCM 64 字符 hex 密钥，首次运行自动生成
`PUBLIC_URL`	`http://localhost:3333`	公网 URL（用于 webhook、邀请链接）

典型应用场景#

DevOps 副手：连接 GitHub Webhook，自动分类 issue、审查 PR、运行 CI 检查，记住代码库规范与历史决策
家庭自动化大脑：通过 MCP 对接 Home Assistant，学习用户日常习惯，按上下文调整灯光/供暖
个人知识库：上传文档、会议纪要、项目规格，代理用 RAG 索引并跨月累积上下文回答问题
多代理团队：调度代理接收请求后分派给专业子代理（代码/运维/写作），通过记忆共享上下文
业务监控：Webhook 接入销售数据/工单/服务器指标，构建 mini-app 仪表板，发送 Slack 日报
家庭助手：多用户共享实例，不同 Kin 管理购物/日程/家务，各自记住每位成员偏好

待确认信息#

首次发布日期：仓库有 75 个 release，README 未注明首次发布时间
维护者/团队规模：仅有 GitHub org "MarlBurroW"，未明确个人或团队背景
商业授权详情：README 提到可通过 issue 讨论，但未公开价格或条款
插件注册表在线地址：仓库内有 registry/ 目录，但未见公开的在线插件市场 URL
文档站独立域名：文档在 docs-site/ 目录，未确认是否有独立部署的在线文档 URL
MCP Server 具体支持列表：README 提到支持 MCP，但未列出具体兼容的 MCP Server