一个下载即用的开源跨平台桌面 AI 助手, 真正的持久记忆 · 从经验中学习 · 长任务不阻塞 · 9 大平台 · MCP 生态,可从 GitHub Releases 下载桌面端,双击安装,3 分钟配置完成。无需命令行,无需配置文件,开箱即用。
仓库:https://github.com/Suge8/Bao
🎯 三个核心优势
1. 真正的持久记忆系统
基于 LanceDB 的记忆系统会跨会话保留你的偏好、项目背景和长期约定。向量检索 + 关键词检索双通路,智能注入相关上下文,不会把整段历史硬塞回 prompt。
记忆分类管理:偏好、个人信息、项目知识、通用事实,四类独立存储,过时内容主动清理,重要信息长期保留。
2. 从经验中持续学习
Bao 有闭环经验引擎。一次任务里踩过的坑,下次不会再从零开始。
自动提取教训、策略和失败模式
相似任务自动召回相关经验
质量评分系统:高质量经验(≥5 分,使用 ≥3 次)永久保留
工具失败后会反思重试,而不是机械重复到超时
它会随着使用持续变得更适合你。
3. 强大的长任务引擎
复杂任务不会卡住当前对话。Bao 支持子代理并行执行,你可以继续聊天,它在后台把耗时工作做完。
轨迹压缩:每 5 步自动压缩执行历史,保持上下文清晰
充分性检查:自动判断是否已收集足够信息,避免无效循环
进度透明:实时查询阶段、工具数、迭代轮次和最近动作
灵活控制:支持取消、续接和结构化任务跟踪
一个助手,不必被一件慢任务拖住全部交互。
🔄 与 OpenClaw 的对比
OpenClaw 是一个优秀的开源 AI 助手项目,定位是 local-first、Gateway 驱动,拥有完整的控制面体系(macOS app、Web UI、CLI、移动节点)。
Bao 的核心取舍不同:更短的上手路径 + 更强的记忆与学习能力。
维度OpenClawBao上手体验CLI 向导 + 配置文件 + Gateway 启动tencent.com下载桌面端,3 分钟配置完成部署依赖Node 22+ / pnpm / Gateway 工作流tencent.com桌面端零依赖,开发侧需 Python / uv核心优势完整 Gateway 控制面 + 多端协同持久记忆 + 经验学习 + 长任务引擎长任务处理Gateway 工具执行轨迹压缩、充分性检查、子代理并行记忆系统基础会话历史LanceDB 向量检索 + 分类记忆 + 经验引擎csdn.net技能生态官方 Skills + ClawHub兼容 ClawHub,支持 SKILL.md 格式github.com适合人群需要完整 Gateway 体系的用户想快速上手 + 保留扩展性的用户
🚀 快速开始
方式 1:桌面端(推荐)
前往 GitHub Releases 下载安装包:
macOS:
Bao-x.y.z-macos-arm64.dmg(Apple Silicon)或Bao-x.y.z-macos-x86_64.dmg(Intel)Windows:
Bao-x.y.z-windows-x64-setup.exe
安装后打开 Bao Desktop,按界面引导完成配置(约 3 分钟):
选择界面语言
配置 AI 服务(支持 OpenAI、Anthropic、Gemini、DeepSeek 等)
选择默认模型
启动网关,开始使用
方式 2:命令行(终端用户)
pip install -U bao-ai
bao方式 3:源码(开发者)
git clone https://github.com/Suge8/Bao.git
cd Bao
uv sync
uv run bao首次运行会自动生成 ~/.bao/config.jsonc。最小配置示例:
{
"providers": {
"openaiCompatible": {
"apiKey": "sk-or-v1-xxx"
}
}
}可选:配置效用模型节省成本(用于后台任务):
{
"agents": {
"defaults": {
"model": "anthropic/claude-sonnet-4-20250514",
"utilityModel": "openrouter/google/gemini-flash-1.5"
}
}
}💬 9 大聊天平台
一份配置,同时接入 9 个平台。每个平台自动适配最佳渲染格式。github.com
平台配置渲染Telegram@BotFather 获取 Token富文本 MarkdownDiscordBot Token + Intent富文本 MarkdownWhatsApp扫码连接纯文本飞书App ID + Secret原生标记SlackBot Token + App Token原生标记EmailIMAP/SMTP纯文本QQApp ID + Secret纯文本钉钉App Key + Secret原生标记iMessagemacOS 零配置纯文本
同一个 AI,9 种最佳阅读体验。
🤖 LLM Provider
极简 4 类配置,覆盖所有主流模型。github.com
类型支持示例OpenAI 兼容OpenAI、OpenRouter、DeepSeek、Groq、Ollama、vLLM 等openai/gpt-4oAnthropicClaude 全系列anthropic/claude-sonnet-4-20250514GeminiGemini 全系列gemini/gemini-2.0-flash-expCodex OAuth通过 ChatGPT 订阅认证,无需 API Keyopenai-codex/gpt-5.1-codex
🔌 MCP 支持
Model Context Protocol — 接入任何工具生态。配置兼容 Claude Desktop 和 Cursor。github.com
{
"tools": {
"toolExposure": {
"mode": "auto" // 智能路由,按需曝光工具
},
"mcpMaxTools": 50,
"mcpSlimSchema": true,
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
}
}
}
}智能工具路由:toolExposure.mode: auto 会自动打分,只曝光最相关的工具,避免 token 浪费。
💬 聊天命令
全平台通用命令:
命令说明/new新建对话(旧对话自动保留)/stop停止当前任务/session列出所有对话,按编号切换/delete删除当前对话/model切换模型/memory管理记忆(查看、编辑、删除)/help显示可用命令
🐳 Docker 部署
# 1. 准备配置
vim ~/.bao/config.jsonc
# 2. 复制环境变量模板
cp .env.docker.example .env.docker
# 3. 启动网关
docker compose --env-file .env.docker up -d bao-gateway
# 4. 查看日志
docker compose logs -f --tail=100 bao-gateway


