PocketPaw
在自己的设备上运行、可通过多种聊天渠道使用的个人 AI 助手。
- Star 数
- ★ 917
- 最近更新
- 6 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 46/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望把个人助手部署在自己电脑上，并通过浏览器或 Telegram 与其交互的个人用户。
- 不适合
- 需要稳定生产环境的团队：项目处于 beta，版本间可能有破坏性变更
- 不愿配置任何模型提供商的用户：首次运行会显示 UNHEALTHY，AI 功能不可用
- 依赖原生 Windows 做浏览器自动化和 shell 工具的用户：这些功能在 WSL2 下才最佳
这个 Agent 能做什么，适合哪些场景？
PocketPaw 是一个自托管的个人 AI 助手，提供 Python 后端、原生桌面客户端和浏览器仪表盘。消息经由事件驱动的 message bus 进入 AgentLoop，再路由到所选的 AgentBackend。它可连接 Discord、Slack、WhatsApp、Telegram 等渠道，并支持 Claude Agent SDK、OpenAI Agents、Google ADK、Codex CLI、OpenCode 和 Copilot SDK 等后端。桌面客户端位于 client/，使用 Tauri 2.0 与 SvelteKit，通过 REST 和 WebSocket 连接 Python 后端。服务默认通过本机仪表盘运行，Docker 部署时会将代理创建的文件写入宿主机的 workspace/ 目录。
渠道将消息发布到事件驱动的 message bus，AgentLoop 取出消息并交给已配置的 AgentBackend。后端可调用浏览器、网页搜索、图像生成、语音、OCR、研究、委派、skills 及集成工具，并把结果返回到网页或已连接的聊天渠道。它可保存长期事实和会话历史，支持 smart compaction 与可选的 Mem0 语义搜索。每次工具调用可由 Guardian AI 审查；同时可配置工具策略、Plan Mode、--security-audit 审查和带追加式审计日志的 self-audit daemon。
- 希望把个人助手部署在自己电脑上，并通过浏览器或 Telegram 与其交互的个人用户。
- 需要在 Discord、Slack、WhatsApp 或 Telegram 中接收和回复助手消息的团队或个人。
- 想用 Ollama 在本地运行推理、避免依赖云端模型服务的用户。
- 需要通过多个代理完成竞品分析等研究任务，并等待结果回传的产品或业务人员。
- 希望在允许执行工具前启用 Guardian AI、Plan Mode 和审计记录的安全敏感用户。
如何安装或部署这个 Agent？
桌面版可下载 Windows、macOS 或 Linux 安装包。终端安装需 Python 3.11+ 与 pip：pip install pocketpaw && pocketpaw。首次运行后访问 http://localhost:8888，在 Settings > API Keys 配置至少一个模型提供商密钥：Anthropic、OpenAI 或 Google Gemini；也可设置 POCKETPAW_ANTHROPIC_API_KEY、POCKETPAW_OPENAI_API_KEY 或 POCKETPAW_GOOGLE_API_KEY。Docker 部署可执行：git clone https://github.com/pocketpaw/pocketpaw.git && cd pocketpaw，然后 cp .env.example .env 和 docker compose up -d。
如何使用这个 Agent？
启动 pocketpaw 后，打开 http://localhost:8888。在 Settings > API Keys 保存至少一个提供商密钥，并在需要时选择 POCKETPAW_AGENT_BACKEND，例如 claude_agent_sdk、openai_agents 或 google_adk。随后在仪表盘聊天，或从仪表盘连接 Discord、Slack、WhatsApp 或 Telegram。若使用 Docker，可用 docker exec pocketpaw cat /home/pocketpaw/.pocketpaw/access_token 获取访问令牌；若使用宿主机 Ollama，则在 .env 设置 POCKETPAW_OLLAMA_HOST=http://host.docker.internal:11434。
这个 Agent 有哪些优点和局限？
- 同一 AgentBackend 协议覆盖六种后端，可在 Claude Agent SDK、OpenAI Agents、Google ADK、Codex CLI、OpenCode 和 Copilot SDK 之间选择。
- 同时提供本机网页仪表盘、原生 Tauri 桌面客户端和九种以上消息渠道。
- 支持 Ollama，本地部署路径可用于完全离线运行。
- 安全功能明确包括 Guardian AI 工具调用审查、注入扫描、工具策略、Plan Mode 和追加式审计日志。
- 项目仍处于 Beta，文档明确提示版本之间可能有破坏性变更。
- 首次运行在未配置模型提供商前会显示 UNHEALTHY，AI 功能不可用。
- 不同后端的能力不完全一致：README 表中仅 Claude Agent SDK、Google ADK 和 Codex CLI 标示支持 MCP。
- 浏览器自动化和 shell 工具在 Windows 上建议使用 WSL2；原生 Windows 的明确覆盖范围是网页仪表盘和 LLM 聊天。
这个 Agent 与同类方案有什么区别？
模型与后端选择上，Claude Agent SDK 是默认后端；OpenAI Agents、Google ADK、Codex CLI、OpenCode 和 Copilot SDK 是可配置替代项。Ollama 是本地、可离线运行的选择，而 Anthropic、OpenAI 和 Google Gemini 需要配置相应 API 密钥。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PocketPaw 当前 | 46 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 917 | 6 天前 | Python | Codex · OpenAI API · Claude API |
| NextClaw | 58 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 263 | 今天 | TypeScript | Codex · Claude Code |
| OpenWork | 71 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 24k | 今天 | TypeScript | Codex · Claude Code |
| LazyMind | 50 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 601 | 今天 | Go | Codex |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有安全功能（Guardian AI、注入扫描、工具策略、计划模式、审计日志），但具体实现细节未提供，权限最小化、用户确认、数据流透明等仅部分体现。敏感数据处理提到API密钥加密，但未说明具体机制。依赖安全有版本约束，但未提及漏洞扫描。外部影响有工具策略但未明确默认限制。回滚机制未提及。来源归属有作者信息但未验证。
自一致性较好，README与pyproject版本一致（0.4.18），但存在不一致：README声称'50+工具'，pyproject未列出全部；README提到'9+渠道'，但pyproject仅列出部分。依赖可用性有版本范围，但未提供锁定文件。失败消息有健康检查提示，但未提供详细错误处理文档。
目标受众明确（个人用户、开发者），场景多样（聊天、自动化、研究）。能力边界有安全策略但未详细说明。触发精度有工具策略但未明确触发条件。环境适配支持多平台、Docker、WSL2，但未提供系统要求细节。
信息架构清晰，有README、文档链接、架构图。安装说明详细，覆盖多平台。命名稳定但版本更新频繁（0.4.18）。示例和FAQ有示例对话，但无FAQ。已知限制仅提及Beta状态。许可证MIT明确。版本变更日志未提供，但pyproject有更新注释。维护责任有团队信息但未明确。
输出可用性有示例对话，但未提供实际输出格式。边际价值高（本地优先、多后端），但未与其他产品对比。成本效益有免费选项（Ollama），但未提供定价信息。
声明可追溯性部分有文档链接，但未提供具体证据。跨来源验证有PyPI、GitHub链接，但未独立验证。事实与推断分离未明确。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 未提供安全功能的实现细节，需审查代码确认Guardian AI等是否真正生效。
- 依赖未锁定版本，存在供应链风险。
- README声称的功能（如50+工具）未在pyproject中完全体现，需验证。
- 回滚机制未提及，升级失败时可能无法恢复。
- 发布者身份未验证，需谨慎对待。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.4.18 PocketPaw v0.4.18
发布说明摘录
PocketPaw v0.4.18 226 commits since v0.4.16. Dev → main sync release. Skips 0.4.17 because PyPI prohibits re-uploads under a previously-used tag (same reason soul-protocol skipped 0.3.2). The bulk of this release is a failing-first security cluster across the file, scope, SSRF, PII, rate-limit, audit-log, cookie, and CSP layers, plus ee/cloud journal projections, the Google Drive zero-copy federation source, KB-go integration with hybrid BM25 + vector search, and soul on by default. Security …在 GitHub 查看 ↗ -
v0.4.16 PocketPaw v0.4.16
发布说明摘录
PocketPaw v0.4.16 150 commits since v0.4.15. Security-focused rollup — hardens the REST auth surface, credential store, command allowlist, and settings API. Ships Discord v0.7 integration, Soul Protocol 0.2.9, a Python 3.14 compatibility warning, and a behavioural fix that stops long sessions from getting stuck on "Prompt is too long". Security - CredentialStore v2 — Argon2id + AES-256-GCM replace the Fernet/PBKDF2 pair, with a backup-safe v1→v2 migration path and macOS hardware binding (#762) …在 GitHub 查看 ↗ -
client-v0.1.4 PocketPaw Desktop v0.1.4
发布说明摘录
Picks up all backend changes from v0.4.15 — A2A protocol, Deep Agents, Soul Protocol v0.2.4, 7-layer security hardening, 10 new CLI commands, and all the fixes that shipped since v0.1.3. No changes to the desktop shell itself. Binaries are being built now and will appear here shortly. Downloads Once ready, grab the right file for your platform: - macOS (Apple Silicon): PocketPaw_0.1.4_aarch64.dmg - macOS (Intel): PocketPaw_0.1.4_x64.dmg - Windows: PocketPaw_0.1.4_x64-setup.exe or .msi - Linux (Ubuntu/Debian): PocketPaw_0.1.4_amd64.deb …在 GitHub 查看 ↗
常见问题
必须付费订阅才能使用吗？
为什么刚启动时显示 UNHEALTHY？
它会在哪里保存设置和生成的文件？
~/.pocketpaw/config.json，API 密钥会加密存储。Docker 部署时，代理创建的文件会出现在宿主机的 ./workspace/。能否限制工具执行？
--security-audit 和 self-audit daemon。