FastClaw
自托管多智能体运行时,用统一控制台交付可隔离的聊天代理。
- Star 数
- ★ 1.4k
- 最近更新
- 2 天前
- License
- NOASSERTION
- 主语言
- Go
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- SaaS 团队需要为每位客户开通隔离的机器人时,可用 user 类型 API key 与 X-Fastclaw-End-User 懒创建用户,并隔离其会话、记忆和文件。
- 不适合
- 想托管多租户 SaaS 服务外部组织的团队:社区许可证要求商业授权
- 希望移除或修改仪表盘品牌的团队:许可证禁止改动 FastClaw 品牌
- 源码审查
- 63/100 · 存在缺口
这个 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?
安装:
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 有哪些优点和局限?
- 单一 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 与同类方案有什么区别?
仓库主题将 FastClaw 标注为 OpenClaw alternative;提供的材料没有可核实的逐项功能对比。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| FastClaw 当前 | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.4k | 2 天前 | Go | OpenAI API · Claude API |
| Shannon | 56 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 2.3k | 2 个月前 | Go | OpenAI API · Claude API |
| Omnara 托管 Agent 平台 | 68 · 存在缺口 | 云服务 / SaaS免费版 + 付费版 | ★ 3.4k | 1 天前 | Go | Codex · Claude Code · Claude.ai · OpenAI API · Claude API |
| Osaurus | 76 · 表现良好 | 桌面应用免费 + 模型费 | ★ 8.1k | 1 天前 | Swift | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档描述了 API key 分级、沙箱隔离、凭证仅在服务端保存,以及沙箱令牌静态加密和轮换影响,支持最小权限和敏感数据保护得分。集成指南明确要求应用逐次授权,但代码运行技能要求立即执行、自动安装依赖并重试,未体现确认机制;工具、频道和调度器会产生外部影响,但所给材料没有充分说明默认授权、撤销或统一恢复流程,因此相应项扣分。文档给出沙箱失败和轮换后的恢复路径,也标注了部分限制;依赖清单存在,但没有依赖安全审查证据。
README、CLI 源码和部署说明总体描述同一运行时,但技能指南提及 fastclaw.json、与 README 的 env-only 配置说明不一致;另有文档残句和 fastagent 命名混用,故自洽性仅为部分。Go 模块锁定了具体依赖版本,并说明 SQLite、Postgres、可选 Redis 等依赖形态;CLI 错误返回及文档中的 HTTP 错误示例提供了一些失败信息,但没有足够材料证明所有运行失败都有清晰处理。
产品覆盖固定代理与动态代理、个人和多租户集成、多个 LLM、消息频道及本地和云部署,并针对不同 API key 能力和用户场景给出选择指引。能力边界有说明,但代码运行技能的宽泛触发描述和一律立即执行的指令限制了触发精度;环境变量、操作系统构建和部署方式有覆盖,然而技能搜索路径仍含旧配置形态,环境说明并非完全一致。
README 按架构、配置、部署、CLI 和 API 组织,提供安装、配置表、示例和限制说明;技能指南也有结构化格式。文档提到的技能搜索目录与当前配置描述存在不一致,fastclaw/fastagent 名称混杂,扣除命名稳定性。许可证文本及其附加条件有明确披露,但并非宽松的纯 Apache 2.0;版本构建方式有说明,材料中没有完整变更历史或清晰的持续维护责任声明。
产品把代理管理、工具执行、会话记忆、沙箱、频道与 API 集成组合为可部署运行时,且对安装、CLI 操作和集成有具体示例,体现出较高的预期增值。输出可经 API、流式接口和 CLI 使用,但未提供足够证据评估实际输出质量;外部服务、数据库和沙箱带来部署及运维成本,文档给出本地到多副本部署选项,却不足以证明成本收益已被量化。
README、主程序、Go 依赖清单、许可证和沙箱设计文档提供了可追溯的产品主张;沙箱轮换文档列出具体测试名和语义,形成部分跨文件印证,但本审查未执行测试。文档通常能区分配置事实、设计决策和接受的故障窗口;不过部分测试和安全行为仅由文档陈述,无法从所给代码片段独立确认,因此未给满分。
- 代码运行技能要求立即执行代码、自动安装缺失依赖并重试;部署时应审查该技能及工具权限,尤其是面向不可信聊天用户时。
- 技能指南提及 fastclaw.json 和旧技能目录,与 README 的 env-only 配置描述有差异;部署前应核对当前版本的实际配置路径。
- 许可证含多租户托管和界面品牌限制;使用前应确认用途符合附加条款。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Full Changelog: https://github.com/fastclaw-ai/fastclaw/compare/v1.5.0...v1.5.1在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/fastclaw-ai/fastclaw/compare/v1.4.0...v1.5.0在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/fastclaw-ai/fastclaw/compare/v1.3.1...v1.4.0在 GitHub 查看 ↗
常见问题
FastClaw 能接哪些模型?
能否让外部应用按自己的终端用户隔离数据?
代理执行 shell 与文件操作安全吗?
可以不用网页控制台吗?
fastclaw agents 可直接管理同一存储中的代理、配置与系统文件;fastclaw apikey 可创建、轮换和删除 API key。谢谢反馈,我们会据此改进页面。