从 OpenClaw 到 FastClaw：多 Agent 架构设计笔记

💡 核心洞察

好的 Agent 架构不是把所有功能塞进一个进程，而是让每一层都能独立演化。

📋 导读

OpenClaw 创新亮点

OpenClaw 关键缺陷

FastClaw 设计原则

架构经验总结

✅ OpenClaw 做对了什么

① 多端接入：Agent 无处不在

支持 Telegram、Discord、Slack、飞书等极广 IM 接入，外加 Web Chat 和 CLI。Agent 不应该被困在一个 App 里。

② SOUL 机制：让 Agent 有「人味」

SOUL.md 定义人格、语气、价值观。带来两个好处：

✓用户粘性暴涨，留存率高几倍

✓同一套 SOUL 可换模型不换人设

③ 记忆检索：越用越懂你

长期摘要 MEMORY.md 注入上下文；每日明细 memory/*.md 按需检索，不占 token。

配合 SOUL.md、USER.md，真正做到「越用越懂你」。

④ 主动通知：从被动到主动

Cron Job + 心跳机制，让 Agent 可以主动推送天气提醒、监控 PR、检查评论。

这是 Agent 从工具进化为助理的关键一步。

⑤ 对话式安装：养成式体验

「帮我装一个翻译技能」——Agent 自己去搜索、安装、配置。对话即操作。

⑥ 多 Agent 协作：团队模式

写代码、写文档、Code Review、部署上线——多个 Agent 在单进程内隔离运行，各有独立 workspace 和会话历史。

⚠️ OpenClaw 的八大缺陷

① 缺少平台级多租户

没有「用户（account）」抽象，要隔离只能「一人一 Agent」。托管 500+ 用户成本高、浪费大。

② Gateway 是单点故障

所有 Channel、Plugin、Agent 挂在一个 Node.js 进程里，一个插件内存泄漏，整个崩溃。

没有隔离，就没有可靠性。

③ 默认上下文偏重，Token 失控

bootstrap 文件越堆越大，默认配置对 token 不敏感，账单可观。钱烧得心疼。

④ 资源占用大

Node.js + npm 依赖 + 文件 I/O，idle 吃 500MB+ 内存，加上 Docker 沙盒小机器跑不动。

⑤ 云原生不友好

配置和状态落在本地文件系统，无法共享；存储不可水平扩展；部署是有状态进程。

⑥ 臃肿的 npm 依赖树

node_modules 超 800MB，构建 3 分钟+，每次更新依赖都像开盲盒。

⑦ Web UI 体验差

界面粗糙、配置藏得深，「能用但不想用」就是劝退。

⑧ 安全模型只服务「单机单操作者」

exec 默认全开、免审批，prompt injection 未解决，密钥明文，无 per-user RBAC。

🚀 FastClaw 设计原则

① 云原生优先

# 一行命令安装，单二进制文件
curl -fsSL https://raw.githubusercontent.com/fastclaw-ai/fastclaw/main/install.sh | bash

# 零配置启动（纯环境变量）
FASTCLAW_PORT=18953 fastclaw

没有本地配置文件，运行配置走数据库；SQLite → Postgres 一个环境变量切换；S3 存储共享技能和文件。

② 多租户与 RBAC

四种用户角色：super_admin / user / app_user / channel_user

system → user → agent → (user, agent) → 内层覆盖外层

管理员配默认 Key，用户覆盖一层即可，天然多租户。

③ 会话隔离

Session key 为 (user_id, agent_id, channel_type, chat_id) 四元组。100 个用户用同一个 Agent，各看各的记忆。

④ 高并发

Go goroutine 天然并发。Session 无状态、状态在数据库，任意 Pod 可处理任意请求，水平扩展只需加 Pod。

⑤ 单二进制分发

# 编译产物约 30MB
make build
ls -lh bin/fastclaw
# -rwxr-xr-x 30M

没有 node_modules，没有运行时依赖，下载、chmod、运行三步搞定。

⑥ 内存占用低

场景	OpenClaw	FastClaw
Idle 空载	~500MB	~30MB
1 个会话	~600MB	~50MB
10 个会话	~1.2GB	~80MB
100 个会话	OOM	~200MB

同样的硬件，能扛 10 倍流量。

⑦ 插件隔离

通过 JSON-RPC 子进程 隔离运行，插件崩溃不影响 Gateway，自动重启。

FastClaw Gateway ↔ JSON-RPC ↔ Plugin Process

⑧ 工具 Provider Fallback

外部工具统一 Provider + Fallback Chain。如 Web Search 主 Tavily、备 SerpAPI，限流自动切换，用户无感知。

🏗️ FastClaw 架构核心

存算分离

计算层：Gateway 无状态，可水平扩展，任意 Pod 处理任意请求。

存储层：SQLite（单机）/ Postgres（集群）+ S3 对象存储。数据库是唯一真相源。

数据持久化不依赖进程生命周期，随时换存储后端。

Scope 配置继承

基于 Scope 链式继承：管理员设全局默认，用户偏好覆盖一层，特定 Agent 再覆盖一层。无需代码变更、无需重启。

Fallback 容错

LLM：claude-sonnet → gpt-4o → 本地 ollama

Web Search：Tavily → SerpAPI → 直接抓取

Sandbox：Docker 本地 → E2B 云端 → 受限无沙盒

每层 Fallback 对上层透明，用户无感知。

🎯 FastClaw 四层定位

① Assistant — 个人助理

一行命令安装，可视化配置，接入 Telegram / Discord / 飞书 / 微信 ClawBot。

② Factory — Agent 制造工厂

在云平台创建 Agent，自定义 SOUL、技能、模型。适合技能创作者和提示词工程师。

③ Runtime — Agent 运行时

导出 API 给其他 Agent 产品使用，无需实现 Agent Loop、Sandbox 等运行时逻辑。如 weclaw.im 一小时上线。

④ Platform — Agent 协作平台

团队版 OpenClaw，共享知识库与 Skills，企业私有化部署只需一台内网服务器。

💎 五条架构经验

① 先做单租户，但架构预留多租户

OpenClaw 后期加多租户几乎等于重写。FastClaw 第一行代码就设计 (user_id, agent_id) 隔离模型。

多租户不是功能，是架构决策。

② 存储决定一切

文件系统做多实例部署、水平扩展是噩梦。用数据库存状态，文件系统只存「内容」不存「状态」。

③ 隔离是可靠性前提

子进程隔离 Plugin，Docker/E2B 隔离代码执行，数据库事务隔离并发写入。

两个组件故障域不同，就不要共享进程。

④ Fallback 是必需品

LLM 会限流、宕机、涨价；Web Search 会超时；Image Gen 会排队。主 Provider 挂了自动切备用。

生产级 Agent 必须对所有外部依赖做 Fallback。没有例外。

⑤ Token 是钱，上下文是金

✓SOUL 文件精简到 500 token 以内

✓Memory 按需检索，不全量注入

✓长对话定期压缩摘要

✓Tools 说明分层，常用详细、不常用只放名字

会省 token 的 Agent 才能活下去。

「好的架构不是设计出来的，
是迭代出来的。」

在迭代前想清楚：存算分离、多租户隔离、Fallback 容错，

你会省下很多时间。

从「做一个很酷的开源项目」到「做一个能跑在生产环境的平台」

欢迎 fork & star：github.com/fastclaw-ai/fastclaw