PawFlow：面向真实基础设施的自托管AI代理运行时平台

一个开源的AI代理运行时层，支持多提供商代理、持久化上下文、中继执行和确定性工作流，让用户能够在自托管环境中运行 durable AI 代理，操作本地文件、浏览器、桌面和工作流。

• 原作者/维护者：allcolor
• 来源平台：GitHub
• 原始标题：PawFlow-Agents
• 原始链接：https://github.com/allcolor/PawFlow-Agents
• 来源发布时间/更新时间：2026-05-30

PawFlow 是一个面向真实基础设施的自托管AI代理运行时平台。它定位在聊天代理、本地工具和生产工作流之间，提供持久化的对话、上下文、记忆、文件、流程和提供商会话管理。通过中继（Relay）架构，PawFlow 能够在用户本地机器上执行文件系统、浏览器、桌面和媒体工具操作，同时保持服务器的无状态性和安全性。

与许多托管的AI编码助手不同，PawFlow 的核心价值主张是"不将工作空间交给供应商控制的代理云"。用户完全拥有自己的数据和执行环境，可以选择在本地、私有云或离线环境中部署。这种设计理念对于注重数据隐私和合规性的企业尤为重要。

PawFlow 采用独特的服务器-中继分离架构。服务器负责托管API、代理编排、流程引擎和Web界面，而中继则运行在用户的本地机器上（或Docker容器中），通过WebSocket连接执行实际工具操作。这意味着代理可以操作用户的本地代码库，而服务器无需直接访问用户文件，实现了功能与安全的平衡。

项目强调"durable"（持久化）概念——对话、共享上下文、代理专属上下文、记忆、知识图谱、日记、项目图谱、文件和存储桶都能在重启后保留。这种设计让AI代理真正具备了长期记忆和上下文连续性，而非每次对话都从零开始。

服务器是PawFlow的核心，包含以下子系统：

• 代理系统：支持LLM + 工具的编排，可配置多种提供商
• 流程引擎：支持100多种任务类型的NiFi风格DAG，具备调度、背压、检查点和审批功能
• 认证网关：支持9种OAuth提供商
• Web聊天界面：基于SSE的实时通信，支持文件、上下文和命令交互

中继是PawFlow架构的关键创新。它运行在用户机器上，负责执行90多种工具操作：

• 文件操作：读取、写入、编辑、全局搜索、正则匹配
• 系统命令：bash执行、屏幕管理
• 浏览器自动化：网页浏览、表单填写、数据提取
• 媒体生成：图像、视频、音频、3D资产生成
• 桌面控制：GUI自动化、应用控制
• 记忆管理：知识图谱、项目图谱、代理日记