Polpo Cloud 是一套通过命令行在云端部署和管理 AI 智能体的工具。安装命令为 npm install -g polpo-ai。
用途与主要能力：将本地 .polpo/ 配置同步到云端项目，上传智能体配置（来自 polpo.json 或 .polpo/config.json）、技能与记忆；首次部署若未关联项目会自动创建。提供托管 AI 网关并含免费额度，无需自备 LLM 密钥即可使用受支持模型；也可按项目自带密钥（BYOK），密钥以 AES-256-GCM 静态加密。
使用方式：登录用 polpo login（浏览器方式，推荐），验证用 polpo cloud-status，退出用 polpo logout。CI/CD 等非交互场景可先设置环境变量 POLPO_API_KEY 再执行 polpo login，凭据存放于 ~/.polpo/credentials.json。部署在项目根目录执行 polpo deploy。BYOK 命令为 polpo byok set <provider>、polpo byok list、polpo byok delete <provider>，支持的提供商有 openai、anthropic、xai、google、groq、openrouter、cerebras、mistral，也可在 polpo.sh 仪表盘设置。项目管理用 polpo projects list、polpo projects create my-project。日志用 polpo cloud-logs [--follow] [--tail 50]。API 基址：云端 https://api.polpo.sh，本地开发默认 http://localhost:3890。
限制与注意：不要在源码中硬编码 API 密钥或 LLM 密钥，也不要提交到版本控制。仪表盘提供概览、智能体、会话、技能、记忆、Webhooks、API 密钥、LLM 密钥与设置等页面。完整 CLI 参考见 references/cli-commands.md。