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

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

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-30T20:15:13.000Z
- 最近活动: 2026-05-30T20:21:29.117Z
- 热度: 165.9
- 关键词: AI代理, 自托管, 多提供商, 持久化上下文, 中继架构, 工作流自动化, Claude Code, Codex, Gemini, 开源平台, 隐私保护
- 页面链接: https://www.zingnex.cn/forum/thread/pawflow-ai
- Canonical: https://www.zingnex.cn/forum/thread/pawflow-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

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

## 项目概述

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

## 核心设计理念

### 自主可控的代理运行环境

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

### 中继支持的执行架构

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

### 持久化与 durability

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

## 架构组件解析

### 服务器层

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

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

### 中继层

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

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

### 多提供商支持

PawFlow 支持9种LLM提供商，涵盖主流商业服务和自托管方案：

| 提供商 | 模式 | 特性 |
|---|---|---|
| Claude Code | CLI子进程/容器 + MCP | 非交互式编码、会话持久化、思考模式 |
| Claude Code交互式 | 交互式CLI容器 + 观察流 | Claude订阅会话、实时控制 |
| Codex app-server | 应用服务器协议 | Codex订阅或OpenAI API密钥 |
| Antigravity / Agy | 交互式CLI容器 | Gemini订阅、OAuth池、MCP工具 |
| Gemini CLI | CLI子进程 | Gemini Pro/CLI特定工作流 |
| Anthropic API | 直接HTTP | 流式传输、工具使用、视觉、扩展思考 |
| OpenAI API | 直接HTTP | 流式传输、工具使用、视觉、JSON模式 |
| OpenAI兼容 | 直接HTTP | 本地/自托管和第三方端点 |

用户可以在每个代理、每个对话或全局层面切换提供商，实现灵活的模型选择策略。

## 客户端生态

PawFlow 提供多种客户端接入方式：

### Web UI

主要的操作界面，集成聊天、上下文编辑器、记忆编辑器、文件附件、中继工具、桌面入口、终端、提供商会话和流程操作。

### PawCode CLI

终端客户端，支持交互式使用和Claude Code兼容的stream-JSON模式，便于集成到现有工具链。

### VS Code 扩展

可以直接附加到相同的对话和资源面板，实现IDE内的无缝体验。

## 应用场景

PawFlow 的设计使其适用于多种复杂场景：

### 代理式编码会话

针对链接工作空间的持久化编码会话，具备可审计的工具输出。开发者可以启动长期运行的编码任务，代理会记住之前的决策和上下文。

### 多代理协作

规划者、编码者、审查者、研究者和验证者可以在同一对话中协作。每个代理可以有不同的专长和工具集，通过共享上下文协调工作。

### 浏览器和桌面自动化

对于没有干净API的工作流，PawFlow 可以直接控制浏览器和桌面应用。这在处理遗留系统或没有API的第三方服务时特别有用。

### 媒体流水线

创建图像、视频、音频、3D资产、语音和FileStore输出，支持完整的创意生产流程。

### 定时运营流程

每日摘要、收件箱分类、数据转换、报告生成、监控和Webhook驱动的自动化。流程引擎支持NiFi风格的DAG，具备调度、背压和检查点功能。

### 可移植对话

完整的PawFlow归档，包括可选的FileStore附件和生成文件，支持对话的导出、备份和迁移。

## 认知系统架构

PawFlow 为代理设计了多层认知系统：

### 记忆系统

采用翼/厅/室（wing/hall/room）分类法组织事实、偏好和事件，存储在 `data/memories/{user}.json`。这种结构化的记忆组织方式模仿人类的空间记忆模式。

### 知识图谱

实体-关系三元组，支持时间有效性，存储在 `data/knowledge_graphs/{user}.json`。代理可以构建和维护关于项目、人员、概念的关系网络。

### 代理日记

每个代理的个人观察、决策和学习记录，存储在 `data/memories/{user}/diary_{agent}.json`。这让代理能够反思自己的经验并改进未来行为。

## 部署与安装

PawFlow 提供Docker安装器作为最简单的入门路径：

```bash
PAWFLOW_VERSION=$(curl -fsSL https://api.github.com/repos/allcolor/PawFlow-Agents/releases/latest \
  | python3 -c 'import json,sys; print(json.load(sys.stdin)["tag_name"])')

curl -L -o "pawflow-install-$PAWFLOW_VERSION.zip" \
  "https://github.com/allcolor/PawFlow-Agents/releases/download/$PAWFLOW_VERSION/pawflow-install-$PAWFLOW_VERSION.zip"
unzip "pawflow-install-$PAWFLOW_VERSION.zip"
cd "pawflow-install-$PAWFLOW_VERSION"

bash scripts/install-pawflow.sh --port PORT --pull-images --version "$PAWFLOW_VERSION"
```

安装完成后访问 `https://localhost:PORT/install` 完成初始化向导。首次运行的私钥为 `RoyBetty`，完成向导后会替换。

## 技术栈与依赖

- **Python 3.10+**：核心运行时
- **Docker**：推荐的中继部署方式
- **WebSocket**：服务器与中继之间的实时通信
- **SSE**：Web UI的实时更新
- **OAuth**：9种提供商的认证集成

## 与同类项目的比较

PawFlow 填补了现有工具之间的空白：

- **相比托管编码助手**：提供更大的灵活性和数据控制权
- **相比工作流工具**：不那么僵化，支持更自然的交互
- **相比纯库**：提供了完整的运行时环境

## 项目状态与社区

项目目前处于Alpha阶段，采用MIT许可证。开发活跃，有持续的CI/CD流程。社区通过GitHub Issues和Discussions进行协作。

## 总结与展望

PawFlow 代表了AI代理基础设施的一个重要发展方向：在保持用户控制和数据隐私的前提下，提供接近托管服务的体验。其中继架构是一个关键创新，解决了自托管AI工具长期面临的安全与功能两难问题。

随着AI代理在软件开发和自动化领域的普及，像PawFlow这样的基础设施将变得越来越重要。它不仅是一个工具，更是一个平台，让开发者和企业能够构建适合自己需求的AI代理生态系统。