Bitterbot 桌面端
在本地设备运行、跨聊天渠道执行并保留长期记忆的个人助手。
这个 Agent 能做什么，适合哪些场景？
Bitterbot 是一个以本地优先方式运行的个人 AI，提供 Gateway、浏览器控制台和自动启动的 Rust P2P orchestrator。它通过 WhatsApp、Telegram、Discord、Signal、Slack、Google Chat、IRC 与内置 WebChat 接收对话，并可使用浏览器控制、Python/JavaScript 执行和 Canvas 工作区。其 Memory System 使用 Knowledge Crystals、知识图谱、激素状态和 Dream Engine 来维护持续记忆与工作记忆文件。Gateway 默认提供 HTTP 与 WebSocket 服务，Control UI 默认运行在 localhost:5173。项目还实现 A2A Protocol 与 ACP 服务，并提供以 USDC、x402 和 P2P 技能市场为中心的可选经济功能。
用户运行 pnpm bitterbot onboard 后，向导配置模型认证、记忆嵌入、网页搜索、渠道、钱包和工作区，并启动 gateway、Control UI 与由 gateway 拉起的 orchestrator。Gateway 将各聊天渠道和 WebChat 的输入送入 Agent Runtime；运行时可调用 Chromium 浏览器控制、Python/JavaScript 代码执行及 Canvas。Memory System 写入和检索 Knowledge Crystals、canonical facts ledger 与知识图谱，并按文档每 30 分钟执行一次 consolidation pipeline、每 2 小时运行一次 Dream Engine。Dream Engine 的 Replay、Research、Compression、Interceptor Harvest 等模式会整理记忆、研究技能或起草预执行拦截器。P2P orchestrator 负责技能、赏金、声誉和 USDC 相关的网络层，外部 Agent 可经 /.well-known/agent.json 与 A2A JSON-RPC 发现和委派任务。
- 需要在 WhatsApp、Telegram 和 Slack 等多个渠道与同一助手沟通的个人，可用它将会话汇入一个 Gateway 和长期记忆系统。
- 希望助手在多次会话后持续保存偏好、项目关系和已确认事实的用户，可利用 Knowledge Crystals、canonical facts ledger 与知识图谱。
- 需要让本地助手浏览网页、运行 Python 或 JavaScript、并在 Canvas 中产出可视化工作内容的开发者或研究者，可通过 Agent Runtime 使用这些工具。
- 想把已验证的工作流程封装为技能，并在 P2P 网络中发布、购买或响应技能赏金的节点运营者，可启用 skills marketplace、x402 和 USDC 钱包功能。
- 需要让外部 A2A 客户端或 IDE 连接本地助手的团队，可使用 `/.well-known/agent.json` 的 A2A 接口或 `src/acp/` 中的 ACP 服务。
这个 Agent 有哪些优点和局限？
- 将持久记忆、知识图谱、canonical facts ledger 和定期 Dream Engine 放入同一运行时，而不只是为聊天附加一次向量检索。
- Gateway 可将多个聊天渠道、WebChat、浏览器控制、代码执行和 Canvas 连接到同一个本地 Agent Runtime。
- 同时提供 A2A Protocol、ACP、P2P skills marketplace、x402 与 USDC 钱包，适合需要对外互操作或技能交换的部署。
- 文档明确给出 onboarding、自动启动、开发 watch 模式、端口和 `bitterbot doctor` 诊断流程。
- 安装要求 Node.js 22+、pnpm 和 `scripts/setup-deps.sh` 安装的 Chromium、ffmpeg、ripgrep 等依赖，环境准备不轻量。
- 模型、网页搜索和消息渠道需要相应认证或密钥；某些能力还依赖外部网络服务。
- P2P 经济、USDC 钱包、技能购买和跨节点连接会带来额外的资金、网络和安全运营责任。
- README 承认 Circles 尚未实现成员移除后的 channel-key rotation；被移除且持有旧 roster 的成员仍可能读取后续流量。
- 许可证信息不一致：仓库元数据标为 NOASSERTION，而 README 徽章标为 MIT，采用前应确认适用许可。
如何安装或部署这个 Agent？
需要 Node.js 22 或更高版本和 pnpm。
git clone https://github.com/Bitterbot-AI/bitterbot-desktop.git && cd bitterbot-desktop
bash scripts/setup-deps.sh
pnpm install
pnpm bitterbot onboard向导会要求配置模型认证；手动配置时，复制 .env.example 为 .env 并填写 ANTHROPIC_API_KEY，也可选填 TAVILY_API_KEY、BRAVE_API_KEY、OPENAI_API_KEY 或 NEARAI_API_KEY。首次完成后，Control UI 位于 http://localhost:5173，Gateway 默认使用端口 19001。
如何使用这个 Agent？
完成 onboarding 后，在 http://localhost:5173 聊天、查看 dreams、管理 skills 和监控 agent。终端中可执行：
bitterbot agent --message "What have you learned about me so far?"之后可用 pnpm start:all 启动生产模式的 gateway 与 Control UI，或以 pnpm dev:all 进行源码开发。出现配置或网络问题时，运行 pnpm bitterbot doctor；它会检查运行时、配置、Gateway、记忆、渠道、钱包与 P2P 网络等子系统。
这个 Agent 与同类方案有什么区别？
Bitterbot 使用 OpenClaw 作为 WhatsApp、Telegram、Discord、Signal 和 Slack 消息路由及嵌入式 agent runner 的脚手架；README 将其自身的记忆系统、Dream Engine、好奇心与激素系统、经济层、P2P 市场和 A2A 互操作描述为额外的原创部分。