一条命令部署现成AI CRM:Busabase模板安装完全教程
一条命令部署现成AI CRM:Busabase模板安装完全教程
Busabase 是一款开源的 AI Agent 数据库与协作工作区,支持本地运行和自托管。本文将以 busa-crm 模板为例,手把手演示如何用一条命令在你的本地工作区部署一个开箱即用的 AI CRM:客户公司、联系人、跟进记录等表格结构、示例数据和 AI Agent 的操作手册一次装齐。
📦 一个 CRM 模板包里有什么
Busabase 的模板(Template)比普通插件包更进一步:它同时也是一个 Agent Skill。安装时模板会被识别为"应用",包含四部分:
- 文件夹与 Base 表格:字段、视图等结构,立即创建;
- 示例数据:开箱不空,默认直接合并进表;
- AirApp 应用代码:跑在工作区数据之上的轻量界面;
- SKILL.md 操作手册:落地为 Skill 节点,告诉任何接入的 AI Agent 该怎么使用这套 CRM。
模板的判断与安装逻辑在 template.ts 中统一实现,保证模板中心、CLI 安装、界面预览三处口径一致。
🚀 第一步:启动本地 Busabase 服务
不需要装数据库,不需要建账号,一条命令即可:
npx busabase server
服务起来后打开 **http://localhost:15419/dashboard/local**,你会看到一个带示例数据的工作区——底层用内嵌的 PGlite 数据库和本地文件存储,数据落在 ~/.busabase/data/。
接着安装 API 客户端并连接本地服务:
npx busabase-cli login --base-url http://localhost:15419
开源本地服务无需鉴权,登录后 busabase-cli 的所有命令都会指向你的本地实例。更多接入方式(Docker、桌面版、从源码运行)见 README_zh-CN.md。
⚡ 核心步骤:一条命令安装 busa-crm 模板
确认服务在线后,执行这一句:
busabase-cli install https://github.com/busabase/templates/tree/main/templates/busa-crm
命令的几个关键点:
| 行为 | 说明 |
|---|---|
| 结构立即生效 | 文件夹、Base、字段、视图当场创建 |
| 内容默认合并 | 示例记录、文档直接写入,打开应用就不空 |
| 命名冲突前缀 | Base 的 slug 会加上目标文件夹前缀,避免和别的模板撞上 settings 这类重名 |
| 版本固定 | URL 里的 git ref 就是版本锁,指向 tag 的内容永不漂移 |
install 命令还支持这些常用参数(完整帮助见 run.ts):
--dry-run:只打印安装计划(目录树、记录数、冲突),不实际创建任何东西,适合先看看再决定;--require-review:把记录与文档以 Change Request 形式提交、等你批准,而不是直接合并;--rename:遇到同名节点时自动加-2、-3后缀安装,而不是报错失败;--no-sample-records:示例数据只提议不合并,适合想要一张干净空表的场景。
💡 小建议:第一次装可以先跑一遍
--dry-run,确认目录结构符合预期再正式安装。
🤖 部署完成后:让 AI Agent 接管 CRM
模板装好之后,价值才开始体现。把本地服务的地址告诉你的 Agent(Claude Code、Cursor、Codex 等均可),它会先读到工作区里的 SETUP_SKILL.md 完成接入,随后就能:
- 查客户:直接从 Companies、Contacts 等 Base 里读结构化记录,而不是靠你复制粘贴;
- 跟进更新:把拜访记录、生命周期阶段变更写成 Change Request 提交回来;
- 查手册:SKILL 节点里的操作手册保证换一台机器、换一个 Agent,工作方式完全一致。
这正是 Busabase 的定位:Agent 保持无状态,工作成果留在工作区——数据、文档、技能、应用对人和 Agent 都是同一份。
✅ 人类审核:AI 的每一次写入都有账可查
CRM 数据通常很敏感,Busabase 的权限模型天然适合"AI 干活、人来把关":
- 权限受限时,Agent 的写入只以 Change Request 形式进入 Inbox,等人批准后才合并进正式记录;
- 每条变更带说明、字段级 diff、作者和历史,批准、驳回、修改意见全程留痕;
- 安装模板时用
--require-review,连模板自带的示例数据也要先过你的审核。
审核通过后,记录详情里可以看到完整的溯源信息——谁提议、谁批准、基于哪次提交,适合需要审计的业务数据:
❓ 常见问题
- 安装失败会留垃圾吗? 不会。失败的默认行为是把已创建的内容移入回收站(
--no-rollback可关闭此保护)。 - 仓库里有多个包怎么装? 用
--skill <name>指定要装哪一个。 - 装到私有仓库? 设置
GITHUB_TOKEN即可;也支持直接安装busabase-cli export导出的本地目录。 - 数据存在哪? 本地模式下在
~/.busabase/data/(PGlite 数据库 + 文件存储),想换外部 Postgres 或 S3 兼容存储可设置PG_DATABASE_URL、STORAGE_URL。
📚 延伸阅读
- 官方中文说明:README_zh-CN.md
- 典型应用场景(含 CRM 数据治理):use-cases.md
- CLI 完整命令文档:busabase-cli README
- 模板安装机制源码:template.ts
从一条命令到 AI 可以读写、人类可以审核的 CRM,Busabase 把"搭系统"的时间压缩到了几秒钟。剩下的,交给你的 Agent 吧。



