soulflow

⚙️ 零依赖 AI 工作流自动化框架

零依赖 AI 工作流框架,通过隔离 Agent 会话自动化开发、运维、研究等多步骤任务,确保执行专注与数据安全。

收藏
2.4k
安装
653
版本
latest
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

SoulFlow 是专为 OpenClaw 设计的通用 AI 工作流框架,允许用户通过 JSON 定义多步骤任务流程。用户可通过自然语言指令或 CLI 调用预置模板(如 security-audit、bug-fix、feature-dev),也可自定义工作流。框架通过 WebSocket 连接本地 OpenClaw Gateway,自动创建隔离的 soulflow-worker Agent 执行每个步骤,确保会话间无上下文干扰。工作流支持变量传递(如 {{task}}、{{step_output}}),每个步骤在独立的 Agent 会话中运行,具备完整的工具访问权限(读、写、编辑、执行、浏览器),并在 10 分钟超时保护下完成任务。

显著优点在于其零依赖架构采用纯 Node.js 22 原生模块,彻底消除了 npm 供应链攻击风险。会话隔离机制有效防止长期运行的 AI 任务产生的上下文膨胀和记忆污染,每个工作流步骤都在全新的 Agent 会话中执行。框架提供完善的示例工作流,覆盖开发、运维、研究等场景,用户可通过自然语言描述快速生成自定义工作流。自动通知功能(v1.1.0+)确保主 Agent 及时获取执行结果,无需手动轮询状态。此外,Worker Agent 继承现有 Agent 的 authProfiles,可直接使用已配置的 GitHub、云服务商等外部凭证,避免重复配置。

潜在缺点与局限性方面,作为 T3 来源的个人开源项目,缺乏企业级维护背书和长期支持保障。框架需要较高的系统权限,包括修改 Gateway 配置文件和创建具有完全工具访问权限的 Worker Agent,这在一定程度上增加了攻击面。虽然内置示例相对安全,但自定义工作流的执行完全依赖用户自行审查,恶意或错误的 JSON 工作流可能导致数据泄露或系统损坏。此外,所有操作基于本地 OpenClaw 权限运行,如果用户主 Agent 已拥有敏感文件访问权限,Worker 同样具备这些能力,无法提供更细粒度的权限隔离。

适合的目标群体主要面向开发者和 DevOps 工程师,特别是需要自动化代码审查、安全审计、Bug 修复或功能开发流程的技术团队。内容创作者和研究人员可利用其构建"研究-起草-编辑-发布"的内容流水线。运维团队可通过自定义工作流实现部署、验证、回滚的自动化操作。对于需要多步骤 AI 协作但担心上下文干扰的高级 OpenClaw 用户,SoulFlow 提供了理想的隔离执行环境。

使用该技能可能存在的常规风险集中在权限和自定义工作流的安全性上。Worker Agent 继承的外部服务凭证(authProfiles)可能被恶意工作流滥用于访问 GitHub、云服务 API 等第三方服务。文件系统读写权限意味着工作流可以修改或删除本地文件,建议在执行前备份重要数据。虽然代码本身无动态加载风险,但用户导入的第三方工作流 JSON 文件相当于可执行代码,必须严格审查其内容。此外,Gateway 配置的修改权限意味着 Skill 可以注册新的 Agent,若 Skill 作者不可信,可能存在持久化后门风险。建议在隔离环境或非生产系统中首次测试新工作流,并定期审查运行日志。

安全解读

SoulFlow 综合评估

核心用法

SoulFlow 是专为 OpenClaw 设计的通用 AI 工作流框架,允许用户通过 JSON 定义多步骤任务流程。每个步骤在独立的 soulflow-worker agent 会话中执行,避免上下文污染。内置三种开发示例工作流(安全审计、Bug 修复、功能开发),同时支持用户自定义任意领域的工作流。

使用方式

  • 自然语言:直接描述需求(如"审计 ~/myapp 的安全漏洞"),主 agent 自动匹配并调用对应工作流
  • 命令行node soulflow.js run <workflow> "<task>" 显式执行

自定义工作流:通过 JSON 定义步骤、变量替换规则和预期输出格式,放置于 workflows/ 目录即可生效。

显著优点

1. 零依赖安全架构:纯 Node.js 22 实现,零运行时依赖,杜绝供应链攻击风险
2. 会话隔离设计:每个工作流步骤在独立 agent 会话执行,无记忆泄漏,保证步骤间纯净传递

3. 权限透明:SKILL.md 详细声明所有权限需求,包括配置读写、agent 创建、凭证继承等

4. 灵活扩展:JSON 工作流定义简单直观,支持变量替换和跨步骤数据传递

5. 本地执行:仅通过 WebSocket 连接本地 Gateway(127.0.0.1),无外发网络请求

6. 自动通知:v1.1.0+ 支持工作流完成后自动通知主会话

潜在缺点与局限性

1. 高权限需求:需读写 Gateway 配置、创建高权限 worker agent,本质上是"以安全换功能"
2. T3 来源可信度:个人开发者/社区项目,无企业背书,需用户自行代码审查

3. 自定义工作流风险:框架本身安全,但用户导入的第三方 .workflow.json 可能包含恶意指令

4. 凭证继承隐患:worker agent 继承主 agent 的 authProfiles,恶意工作流可滥用 GitHub/云服务商凭证

5. 无加密本地通信:WebSocket 连接本地 Gateway 无加密(本地回环),虽无网络泄露风险但依赖系统隔离

6. Node.js 版本限制:要求 Node.js 22+,老旧环境需升级

适合人群

  • 开发者:需要自动化代码审查、安全审计、Bug 修复流水线
  • DevOps 工程师:构建部署验证、回滚自动化等运维工作流
  • 内容创作者:研究→起草→编辑→发布的结构化内容生产
  • 研究人员:数据收集→分析→综合→报告的多阶段研究流程
  • 自动化需求者:任何需要多步骤、可复现、可审计的任务场景

不适合:对来源可信度有严格要求的企业环境(T3 级别)、无法审查代码的用户、处理高度敏感数据且无法隔离的场景。

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 恶意工作流执行 | 导入的第三方 JSON 工作流可能包含危险指令 | 运行前审查 `.workflow.json` 内容 |
| 凭证滥用 | Worker 继承外部服务凭证,可能被滥用 | 使用 BYOK 模式隔离凭证,或在沙箱环境测试 |
| 文件系统操作 | 工作流可读写用户文件 | 备份重要数据,在非生产环境测试 |
| 配置篡改 | Skill 需修改 Gateway 配置注册 worker | 审查代码确认仅修改必要配置项 |
| 供应链风险(极低) | 零依赖架构已规避 | 定期关注上游更新 |

总体建议

SoulFlow 是功能强大且架构清晰的本地工作流框架,适合技术用户构建可复现的 AI 驱动流程。其零依赖设计和会话隔离是亮点,但 T3 来源等级和高权限需求要求用户具备代码审查能力和安全意识。建议在生产环境使用前进行充分沙箱测试,严格审查所有自定义工作流来源。

soulflow 内容

lib文件夹
workflows文件夹
手动下载zip · 32.0 kB
gateway.jstext/javascript
请选择文件