PocketPaw
在自己的设备上运行、可通过多种聊天渠道使用的个人 AI 助手。
这个 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 密钥。