Bitterbot 桌面端
在本地设备运行、跨聊天渠道执行并保留长期记忆的个人助手。
按维度查看评分与理由
证据显示：README 描述了本地优先、默认回环绑定、工作区限制、用户确认机制（如 circles 的默认拒绝、代理写入需批准）、敏感数据加密（X25519、AES-256-GCM）、依赖固定（pnpm overrides、minimumReleaseAge）、外部影响（钱包、P2P 市场）有免责声明。扣分：缺乏具体代码验证，权限最小化仅部分实现（如工具工作区限制为可选），用户确认机制仅部分场景，数据流透明度不足，回滚机制未提及，来源归属仅部分（LICENSE 中提及 OpenClaw 和 pi-agent，但未提供详细归属）。
证据显示：README 和 package.json 一致，依赖列表完整，有 CI 工作流。扣分：未提供失败消息的具体示例，依赖可用性未验证（静态审查），自一致性仅基于文档，未检查代码内部一致性。
证据显示：README 明确目标用户（个人用户）、场景（聊天、记忆、技能交易），能力边界有描述（如 circles 默认拒绝、工具限制），环境适配（macOS/Linux/Windows、Node>=22）。扣分：触发精度未详细说明（如技能触发条件），能力边界部分模糊（如自主赚钱的边界），环境适配未覆盖所有平台细节。
证据显示：README 结构清晰，安装步骤详细，许可证明确（MIT），版本号存在（2026.2.15），有 CHANGELOG 引用。扣分：命名稳定性未验证（版本号非语义化），示例和 FAQ 不足，已知限制仅部分（如 circles 移除成员问题），维护责任未明确（无贡献指南），版本变更日志未提供。
证据显示：输出可用性（CLI、UI、API），边际价值（独特功能如记忆、梦想引擎），成本效益（免费开源，但需 API 密钥）。扣分：输出可用性未验证（静态），边际价值基于宣传，成本效益未量化（如资源消耗）。
证据显示：README 中的声明部分有文档链接（如 memory architecture），但未提供具体证据（如测试结果）。扣分：声明可追溯性不足，跨来源佐证缺乏（仅单一来源），事实与推断未明确分离（如宣传性语言）。
- 该仓库包含实验性金融功能（钱包、P2P 市场），涉及真实资金，存在财务风险。
- 依赖众多且部分为预发布版本（如 @whiskeysockets/baileys 7.0.0-rc.9），可能不稳定。
- 安全文档建议仅本地使用，但未提供完整的威胁模型。
- 发布者身份未验证，需谨慎对待。
这个 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 互操作描述为额外的原创部分。
常见问题
首次启动必须提供哪类凭证？
.env 中填写 ANTHROPIC_API_KEY；README 还列出可选的 Tavily、Brave、OpenAI 和 NearAI 密钥。