PocketPaw
在自己的设备上运行、可通过多种聊天渠道使用的个人 AI 助手。
按维度查看评分与理由
证据显示有安全功能（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链接，但未独立验证。事实与推断分离未明确。
- 未提供安全功能的实现细节，需审查代码确认Guardian AI等是否真正生效。
- 依赖未锁定版本，存在供应链风险。
- README声称的功能（如50+工具）未在pyproject中完全体现，需验证。
- 回滚机制未提及，升级失败时可能无法恢复。
- 发布者身份未验证，需谨慎对待。
这个 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 有哪些优点和局限？
- 同一 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？
桌面版可下载 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 与同类方案有什么区别？
模型与后端选择上，Claude Agent SDK 是默认后端；OpenAI Agents、Google ADK、Codex CLI、OpenCode 和 Copilot SDK 是可配置替代项。Ollama 是本地、可离线运行的选择，而 Anthropic、OpenAI 和 Google Gemini 需要配置相应 API 密钥。
常见问题
必须付费订阅才能使用吗？
为什么刚启动时显示 UNHEALTHY？
它会在哪里保存设置和生成的文件？
~/.pocketpaw/config.json，API 密钥会加密存储。Docker 部署时，代理创建的文件会出现在宿主机的 ./workspace/。能否限制工具执行？
--security-audit 和 self-audit daemon。