FastClaw
自托管多智能体运行时,用统一控制台交付可隔离的聊天代理。
这个 Agent 能做什么,适合哪些场景?
FastClaw 是用 Go 编写的轻量级 AI Agent runtime,定位为创建、管理和运行代理的 Agent Factory。每个代理可拥有独立的 SOUL.md、记忆、技能、工具、模型覆盖项、会话和渠道绑定,并通过网页控制台、CLI 与 HTTP API 管理。运行时负责 LLM 通信、工具调用、会话隔离,以及 Docker 或 E2B 沙箱执行;默认将平台与代理数据存入 SQLite,也可改用 Postgres 支持多 Pod 部署。它提供 Telegram、Discord、Slack 渠道,以及兼容 OpenAI 的 /v1/chat/completions 接口,适合需要把多个可配置代理作为自托管产品后端或应用集成层的团队。
启动 fastclaw 后,首次运行向导配置 LLM provider 并创建默认代理;控制台可编辑代理的 SOUL.md、IDENTITY.md、MEMORY.md 等系统文件,绑定模型、技能、IM 渠道和定时任务。代理收到聊天请求后,运行时保存按 agent × user 以及渠道/chatID 隔离的会话,并可调用 exec、read_file、write_file、list_dir、web_fetch、web_search、memory_search 等内置工具。启用沙箱时,Docker 或 E2B 执行环境会同步技能与工作区,并在每次工具调用后把沙箱侧文件同步回持久化存储。外部应用可调用流式 /v1/chat/completions,使用 POST /v1/users 或 X-Fastclaw-End-User 建立隔离的终端用户身份;管理员还可用 /api/agents、/api/config、/api/skills/install 和 /api/apikeys 管理平台资源。
- SaaS 团队需要为每位客户开通隔离的机器人时,可用 user 类型 API key 与 X-Fastclaw-End-User 懒创建用户,并隔离其会话、记忆和文件。
- 内部平台团队需要在同一部署中维护多个角色不同的助手时,可为每个代理分别配置 SOUL.md、模型、技能和私有技能目录。
- 希望在 Telegram、Discord 或 Slack 上提供专用支持或业务机器人时,可为某个代理绑定对应渠道并让运行时隔离不同聊天线程。
- 需要由应用后端调用聊天代理的开发者,可使用流式 OpenAI 兼容 /v1/chat/completions 接口,而不是直接操作网页聊天界面。
- 需要让代理执行代码或文件操作、同时在托管部署中限制执行边界的团队,可选择 Docker 或 E2B 沙箱并设置 FASTCLAW_DEPLOY=hosted。
这个 Agent 有哪些优点和局限?
- 单一 Go 二进制同时提供控制台、CLI、代理运行时、会话管理和 HTTP API,减少了将这些组件自行拼装的工作。
- 代理级模型覆盖、技能、身份文件、渠道与按用户分区的会话/记忆,适合在一个部署中运营多个独立角色。
- SQLite 默认部署简单,同时明确支持 Postgres、Redis、对象存储和 Kubernetes 的多副本部署路径。
- Docker 与 E2B 沙箱支持技能/工作区同步;托管模式可强制将 exec 与文件调用限制在沙箱内。
- 许可证为带附加条件的 FastClaw Community License,禁止未经商业许可向无关组织提供多租户 SaaS,也禁止移除或修改控制台品牌。
- LLM、渠道机器人和外部搜索/抓取都依赖网络及相应 provider 或 bot 凭据;README 未给出这些服务的成本或配额保证。
- 自托管默认由主机 shell 执行工具调用,只有模型按调用选择 `exec(sandbox:true)` 才进入沙箱;面向不可信 IM 用户时需额外设置 `FASTCLAW_SANDBOX_ENFORCE=1`。
- 跨 Pod 部署需要自行配置 Postgres,并在需要共享渠道锁和消息流时配置 Redis;分布式技能/文件同步还需要 S3 兼容对象存储。
如何安装或部署这个 Agent?
安装:curl -fsSL https://raw.githubusercontent.com/fastclaw-ai/fastclaw/main/install.sh | bash
首次运行:fastclaw
向导中配置 LLM provider 后会创建默认代理。若使用 CLI 创建 OpenAI 代理,先在环境中提供 OPENAI_API_KEY,再运行:fastclaw agents init alpha --provider openai --model openai/gpt-4o-mini --api-key-env OPENAI_API_KEY
控制台位于 http://localhost:18953;也可用 fastclaw daemon start 在后台运行。
如何使用这个 Agent?
用 fastclaw agents ls 查看代理,用 fastclaw agents config alpha set temperature 0.7 修改代理配置,用 fastclaw agents files put alpha SOUL.md ./SOUL.md 上传身份文件。通过控制台进入代理后,可测试聊天、安装私有技能、绑定 Telegram/Discord/Slack、检查会话并管理代理创建的 cron 任务。应用集成时,向 /v1/chat/completions 发送兼容 OpenAI 的流式请求;多租户应用使用 user 类型 key,并附带 X-Fastclaw-End-User: <your-app-user-id>。
这个 Agent 与同类方案有什么区别?
仓库主题将 FastClaw 标注为 OpenClaw alternative;提供的材料没有可核实的逐项功能对比。