FastClaw / 运行模型

架构

FastClaw 的核心架构是 Gateway + Store + Agent Manager + Tool Registry + Channel Manager + Project Runtime。

核心层

gateway.New 会打开 store、workspace、channel、cron、webhook、plugin、taskqueue、usage/quota 和 user spaces；Agent Manager 再把 provider、memory、skills、tool registry、sandbox、MCP 等能力绑定到每个 Agent。

组件	职责
Gateway	进程级编排、store、channels、cron、plugins、usage、runtime
Store	用户、API key、Agent、session、project、files、config、cron、usage
Agent Manager	按 user/agent 构建 Agent loop，绑定 provider、memory、tools、skills
Tool Registry	内置工具、provider-backed tools、MCP tools、plugin tools
Project Runtime	web app 模板、dev server、preview、logs、文件定位

数据目录

README 的目录模型很简单：数据库是大多数配置和运行时状态的事实来源，skills 仍保留文件系统形态。单机默认 SQLite，多副本可切 Postgres。

~/.fastclaw/
  fastclaw.db
  skills/
  agents/
    <agentId>/agent/skills/

云模式假设

源码里 IsCloudMode 总是 true，多用户能力是默认路径。即使你只本地使用，也要按多用户、多 Agent、多 session 的隔离模型理解它。

Identity.CanAccessAgent 会校验 agent ACL，越权时返回 404 避免泄露存在性。
API server、Dashboard 和 Channels 都走同一套 store 与身份边界。
Redis 可选；没有 Redis 时使用 DB-backed channel lease。