Spacebot 深度解析：面向团队的 AI 操作系统
Spacebot 深度解析：面向团队的 AI 操作系统
项目: Spacebot
官网: https://spacebot.sh/
文档: https://docs.spacebot.sh/
GitHub: https://github.com/spacedriveapp/spacebot
整理时间: 2026-02-18
📋 项目概述
Spacebot 是一个面向团队和社区的 AI 操作系统，用 Rust 构建，旨在替代传统的单体会话模型。它将 AI 流程分解为专门的进程，每个进程只负责一件事，通过委托而非顺序执行来完成工作。
核心理念：Nothing blocks（无阻塞）—— 思考、执行、响应并发进行，而非顺序执行。
🏗️ 五大核心组件
1️⃣ Channels（频道）
- 角色: 用户-facing 的对话代理
- 特点: 有灵魂、身份、个性
- 职责: 与用户对话，将其他所有工作委托出去
- 类比: 类似 OpenClaw 的 Agent，是用户的主要接口
2️⃣ Branches（分支）
- 角色: Fork 的思考进程
- 特点: 拥有频道的完整历史上下文
- 职责: 异步探索，不阻塞主流程，只返回结论
- 类比: 像人类的”让我想想”——在后台思考，不打扰对话流
3️⃣ Workers（工作者）
- 角色: 任务特定的执行进程
- 特点: 无个性、无对话上下文，专注执行
- 职责: 文件操作、代码执行、研究工作
- 类比: 专业外包团队——拿到任务和工具，只交付结果
4️⃣ Cortex（皮层）
- 角色: 系统级观察者和记忆整合器
- 职责:
- 为每次对话生成记忆简报（Memory Bulletin）
- 监督 Workers 和 Branches
- 维护记忆图（Memory Graph）
- 检测跨频道模式
- 提供交互式管理聊天界面
- 更新频率: 每 60 分钟查询记忆图，综合成简报
5️⃣ Memory Graph（记忆图）
- 角色: 结构化记忆数据库
- 特点:
- 8 种类型化的记忆种类
- 向量 + 全文混合搜索
- 自动关联构建（事实→决策→事件→目标）
- 关键设计: 原始搜索结果永远不会进入对话，只有 Cortex 综合后的简报才会
🧠 记忆系统详解
记忆类型（8 种）
| 类型 | 用途 |
|---|---|
| Identity | 身份信息 |
| Recent | 近期记忆 |
| Decisions | 决策记录 |
| Important | 重要信息 |
| Preferences | 偏好设置 |
| Goals | 目标 |
| Events | 事件 |
| Observations | 观察记录 |
自动文件摄取
把文件丢进 ingest 文件夹即可自动处理：
- 支持格式:
.md.txt.json.yaml.csv.log.toml.xml.html.rst - 处理流程:
- Spacebot 分块文件
- 每块通过 LLM 处理
- 使用 memory tools 提取结构化记忆
- 避免重复（召回相关记忆）
- 保存带重要性评分和图关联的记忆
跨频道记忆同步
Cortex 持续扫描记忆，寻找嵌入相似性，自动构建图边连接：
- 事实链接到决策
- 事件链接到目标
- 图会随着使用自动变聪明
💻 技术架构
技术栈
| 组件 | 技术 | 用途 |
|---|---|---|
| 核心语言 | Rust | 内存安全、无 GC 暂停、可预测资源使用 |
| 异步运行时 | Tokio | 高性能并发 |
| 关系数据 | SQLite | 对话、记忆图、cron 任务 |
| 向量搜索 | LanceDB | 向量嵌入 + 全文搜索 |
| KV 存储 | redb | 设置、加密密钥 |
| 嵌入模型 | FastEmbed | 本地嵌入生成 |
| Discord | Serenity | Discord 集成 |
| 浏览器 | Chromiumoxide | 浏览器自动化 |
为什么选择 Rust？
“Spacebot 不是聊天机器人——它是自主 AI 流程的编排层。这是基础设施，基础设施应该是机器码。”
- 类型安全: 编译时保证正确性
- 无运行时依赖: 单个二进制文件
- 无 GC 暂停: 可预测的资源使用
- 无 Docker/微服务: 一切在一个容器内运行
🚀 快速开始
Docker 一键启动
docker run -d \
--name spacebot \
-v spacebot-data:/data \
-p 19898:19898 \
ghcr.io/spacedriveapp/spacebot:latest
Web UI: http://localhost:19898
带 API Key 启动
docker run -d \
--name spacebot \
-e ANTHROPIC_API_KEY="sk-ant-..." \
-v spacebot-data:/data \
-p 19898:19898 \
ghcr.io/spacedriveapp/spacebot:latest
源码构建
git clone https://github.com/spacedriveapp/spacebot.git
cd spacebot
# 可选：构建 Web UI (React + Vite)
cd interface && bun install && cd ..
# 安装二进制
cargo install --path .
⚙️ 配置方式
方式 A：环境变量（最快）
export ANTHROPIC_API_KEY="sk-ant-..."
spacebot
方式 B：交互式引导
直接运行 spacebot，不带任何配置，会引导完成：
- 提供商选择
- API Key 输入
- Agent 命名
- 可选 Discord 设置
方式 C：配置文件
~/.spacebot/config.toml:
[llm]
anthropic_key = "sk-ant-..."
# 或: openrouter_key = "sk-or-..."
# 或: openai_key = "sk-..."
[[agents]]
id = "main"
# Discord 集成（可选）
[messaging.discord]
enabled = true
token = "env:DISCORD_BOT_TOKEN"
[[bindings]]
agent_id = "main"
channel = "discord"
🎭 Agent 个性化
每个 agent 有三个可选的 markdown 文件：
| 文件 | 用途 |
|---|---|
SOUL.md |
个性、价值观、沟通风格 |
IDENTITY.md |
名称、性质、目的 |
USER.md |
关于对话人类的信息 |
位置：~/.spacebot/agents/{id}/workspace/
热重载: 修改后无需重启，自动生效
💬 消息平台支持
| 平台 | 状态 |
|---|---|
| Discord | ✅ 支持 |
| Slack | ✅ 支持 |
| Telegram | ✅ 支持 |
| Webhook | ✅ 支持 |
无需消息适配器也能运行——通过 Web UI 和 HTTP API 访问。
🏷️ 托管方案
| 方案 | 价格 | 配置 |
|---|---|---|
| Pod | $29/月 | 1 agent, 10GB, 1 dashboard seat |
| Outpost | $59/月 | 3 agents, 40GB, 2 seats, 优先支持 |
| Nebula | $129/月 | 10 agents, 80GB, 5 seats, 优先支持 |
所有方案:
- 包含 Discord/Slack/Telegram
- 混合记忆搜索
- 编码 & 浏览器 Workers
- Cron 任务
- 每日备份
注意: 目前需要自备 LLM API Key (BYOK)，未来将包含 bundled LLM credits。
🔑 关键特性总结
与传统 Agent 框架的区别
| 维度 | 传统框架 | Spacebot |
|---|---|---|
| 架构 | 单体会话 | 多进程分工 |
| 思考方式 | 顺序阻塞 | 并发分支 |
| 记忆 | Markdown 文件 | 图数据库 + 自动关联 |
| 执行 | 单线程 | Workers 并行 |
| 上下文管理 | 手动 | Compactor 自动压缩 (80%/85%/95% 阈值) |
| 部署 | 复杂依赖 | 单二进制/Docker |
核心优势
- 真正的并发: Channels、Branches、Workers 同时运行，互不阻塞
- 智能记忆: 不是简单存储，而是构建关联图，自动发现模式
- 零配置启动: Docker 一行命令，5 分钟运行
- 团队友好: 多频道、跨频道记忆同步、管理仪表盘
- Rust 基础设施: 性能、安全、长期稳定
🔗 相关链接
- 官网: https://spacebot.sh/
- 文档: https://docs.spacebot.sh/
- GitHub: https://github.com/spacedriveapp/spacebot
- Docker:
ghcr.io/spacedriveapp/spacebot:latest
💭 与 OpenClaw 的对比
| 特性 | OpenClaw | Spacebot |
|---|---|---|
| 定位 | 个人 AI 助手 | 团队 AI 操作系统 |
| 记忆 | 文件系统 (MEMORY.md) | 图数据库 (Memory Graph) |
| 架构 | 单 Agent | 多进程 (Channel/Branch/Worker/Cortex) |
| 技术栈 | TypeScript/Node | Rust |
| 部署 | CLI 工具 | 单二进制/Docker |
| 多平台 | 多频道支持 | 原生多频道 + 跨频道记忆 |
| 思考方式 | 顺序执行 | 并发分支 |
两者理念相通但实现不同：OpenClaw 更轻量个人化，Spacebot 更重型团队化。
🏷️ 标签
#AI #Agent #Spacebot #Rust #团队工具 #MemoryGraph #并发架构