核心功能
SoulFlow 是一款为 OpenClaw 设计的通用 AI 工作流框架,允许用户通过 JSON 定义多步骤工作流,每个步骤在独立的代理会话中执行,避免上下文膨胀和记忆污染。框架通过 WebSocket 连接本地 OpenClaw 网关,自动创建专用的 soulflow-worker 代理来执行工作流步骤。
显著优点
1. 会话隔离:每个工作流步骤在全新的代理会话中运行,确保上下文干净、专注
2. 零依赖:纯 Node.js 22 实现,无需额外依赖
3. 内置示例:提供安全审计、Bug 修复、功能开发三类开发工作流模板
4. 灵活扩展:支持自定义任意领域的工作流(内容、运维、研究等)
5. 自动通知:工作流完成后自动通知主代理会话(v1.1.0+)
6. 自然语言调用:用户可通过日常描述触发工作流,无需记忆命令
潜在局限
- 权限要求高:需读取/修改网关配置、创建代理、继承外部服务凭证
- 安全风险:工作流步骤拥有完整工具访问权限(read/write/exec/browser),恶意工作流可能造成损害
- Node.js 版本依赖:要求 Node.js 22+ 以使用原生 WebSocket
- 单点故障:依赖本地 OpenClaw 网关连接
- 超时限制:单步骤默认 10 分钟超时
适合人群
- 开发团队需要自动化代码审查、安全扫描、Bug 修复流程
- 运维人员需要标准化部署、验证、回滚流水线
- 内容创作者需要研究-起草-编辑-发布的自动化流程
- 研究人员需要数据收集-分析-综合的报告生成流程
- 任何需要多步骤 AI 协作任务的 OpenClaw 用户
常规风险
1. 代码执行风险:工作流可执行任意命令,需严格审查自定义工作流来源
2. 凭证泄露风险:Worker 继承主代理的 authProfiles,可访问 GitHub、云服务商等外部服务
3. 数据泄露风险:恶意工作流可能读取敏感文件并外泄
4. 配置篡改风险:需修改 ~/.openclaw/openclaw.json 注册工作代理
5. 供应链风险:需信任技能作者(0xtommythomas-dev),建议安装前审查 GitHub 源码
使用建议
- 首次使用前审查内置工作流(尤其是 security-audit 和 bug-fix)
- 运行自定义工作流前检查
.workflow.json文件内容 - 在非生产环境测试新工作流
- 执行修改代码的工作流前备份重要文件
- 对不可信工作流使用隔离/沙箱环境运行