FastClaw
自托管多智能体运行时，用统一控制台交付可隔离的聊天代理。
- Star 数
- ★ 1.4k
- 最近更新
- 16 天前
- License
- NOASSERTION
- 主语言
- Go
- FA 评分
- 43/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 开始前需要
- 典型场景
- SaaS 团队需要为每位客户开通隔离的机器人时，可用 user 类型 API key 与 X-Fastclaw-End-User 懒创建用户，并隔离其会话、记忆和文件。
- 主要局限
- 许可证为带附加条件的 FastClaw Community License，禁止未经商业许可向无关组织提供多租户 SaaS，也禁止移除或修改控制台品牌。
这个 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 并排比较关键指标。
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有基于角色的API密钥（admin/user/agent）和沙箱选项，但未明确最小权限原则的默认配置；用户确认机制存在（如公开访问开关、API密钥创建），但未系统化；数据流透明度部分描述（如存储位置），但缺少详细的数据流图；敏感数据处理有提及（如API密钥仅显示一次），但未深入；依赖安全未提及漏洞扫描或锁定；外部影响有沙箱和网络配置，但未明确默认限制；回滚机制未提及；来源归属有版权声明，但发布者未验证。
自一致性较好，文档与代码结构一致，但未提供测试证据；依赖可用性未提及版本锁定或镜像；失败消息未提供具体示例。
受众和场景明确（开发者、企业），能力边界有描述（如沙箱边界），触发精度部分（如调度器），环境适配良好（支持多种部署方式）。
信息架构清晰，安装说明详细，命名稳定性一般（有版本标签），示例和FAQ有，已知限制部分（如沙箱边界），许可证明确，版本变更日志未提供，维护责任有版权方但未验证。
输出可用性有API和CLI，边际价值高（多代理框架），成本效益未量化。
声明可追溯性一般，跨来源佐证不足，事实与推断分离不明确。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 发布者身份未验证，需谨慎对待来源。
- 依赖安全未提及漏洞扫描或锁定，需自行检查。
- 回滚机制未提及，需评估数据丢失风险。
- 沙箱默认配置可能不够严格，需根据部署环境调整。
常见问题
FastClaw 能接哪些模型？
能否让外部应用按自己的终端用户隔离数据？
代理执行 shell 与文件操作安全吗？
可以不用网页控制台吗？
fastclaw agents 可直接管理同一存储中的代理、配置与系统文件；fastclaw apikey 可创建、轮换和删除 API key。