一条命令部署现成AI CRM:Busabase模板安装完全教程

原创2026-11-04 16:21:491,916 阅读

一条命令部署现成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 AI CRM 工作区首页:审核队列、知识节点与 Agent 活动

🚀 第一步:启动本地 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,确认目录结构符合预期再正式安装。

Busabase 表格视图:客户公司与联系人 CRM 记录

🤖 部署完成后:让 AI Agent 接管 CRM

模板装好之后,价值才开始体现。把本地服务的地址告诉你的 Agent(Claude Code、Cursor、Codex 等均可),它会先读到工作区里的 SETUP_SKILL.md 完成接入,随后就能:

  1. 查客户:直接从 Companies、Contacts 等 Base 里读结构化记录,而不是靠你复制粘贴;
  2. 跟进更新:把拜访记录、生命周期阶段变更写成 Change Request 提交回来;
  3. 查手册:SKILL 节点里的操作手册保证换一台机器、换一个 Agent,工作方式完全一致。

这正是 Busabase 的定位:Agent 保持无状态,工作成果留在工作区——数据、文档、技能、应用对人和 Agent 都是同一份。

✅ 人类审核:AI 的每一次写入都有账可查

CRM 数据通常很敏感,Busabase 的权限模型天然适合"AI 干活、人来把关":

  • 权限受限时,Agent 的写入只以 Change Request 形式进入 Inbox,等人批准后才合并进正式记录;
  • 每条变更带说明、字段级 diff、作者和历史,批准、驳回、修改意见全程留痕;
  • 安装模板时用 --require-review,连模板自带的示例数据也要先过你的审核。

Busabase Inbox 审核界面:Agent 提交的 AI CRM 数据变更请求

审核通过后,记录详情里可以看到完整的溯源信息——谁提议、谁批准、基于哪次提交,适合需要审计的业务数据:

Busabase CRM 记录详情:审核通过与审计历史

❓ 常见问题

  • 安装失败会留垃圾吗? 不会。失败的默认行为是把已创建的内容移入回收站(--no-rollback 可关闭此保护)。
  • 仓库里有多个包怎么装? 用 --skill <name> 指定要装哪一个。
  • 装到私有仓库? 设置 GITHUB_TOKEN 即可;也支持直接安装 busabase-cli export 导出的本地目录。
  • 数据存在哪? 本地模式下在 ~/.busabase/data/(PGlite 数据库 + 文件存储),想换外部 Postgres 或 S3 兼容存储可设置 PG_DATABASE_URL、STORAGE_URL。

📚 延伸阅读

从一条命令到 AI 可以读写、人类可以审核的 CRM,Busabase 把"搭系统"的时间压缩到了几秒钟。剩下的,交给你的 Agent 吧。

登录后查看全文
busabase