企业官网建设流程全解析

• 人工智能
• 大模型
• AI Agent
• AI 应用
• Agent 记忆
• 工具调用

Boop 是一个基于 iMessage 的开源个人 AI 智能体：给一个专属号码发一条 iMessage，你的 Agent 就会被唤醒，帮你查日程、写草稿、跑定时任务，然后像真人一样回你消息。它支持 Claude Code 与 Codex/ChatGPT 两种订阅运行时，无需额外 API Key，内置分层记忆、自动化任务、1000+ 第三方工具集成和一个实时调试面板。本文将用最核心的三条命令，带你完整走完 Boop 智能体的新手部署路径。

1. Boop 是什么：一条 iMessage 背后的 AI 智能体

Boop 的工作流是一条清晰的流水线：

iMessage → Sendblue webhook → 交互 Agent → 子 Agent（每任务一个） │ │ ▼ ▼ 记忆库 集成工具（MCP）

• 交互 Agent（Interaction agent）是"前台"：理解消息、检索记忆、决定直接回答还是派发任务；
• 执行 Agent（Execution agent）是"工人"：一个任务一个实例，只加载调度者指定的集成工具，返回精炼结果；
• 记忆库分短期 / 长期 / 永久三层，每轮对话后自动抽取记忆，按天衰减清理；
• 集成通过 Composio 接入 Gmail、Slack、GitHub、Notion 等 1000+ 服务。

架构详解见 ARCHITECTURE.md，核心实现分别在 server/interaction-agent.ts 与 server/execution-agent.ts。

2. 准备工作：账号与环境，3 分钟备齐

先克隆仓库并安装依赖：

git clone https://gitcode.com/gh_mirrors/bo/boop-agent cd boop-agent npm install

再安装并登录其中一个 Agent 运行时（二选一即可）：

# Claude 运行时 npm install -g @anthropic-ai/claude-code claude # 登录一次后退出 # 或 Codex 运行时 npm install -g @openai/codex codex login

Boop 直接复用本机登录态，不需要单独的ANTHROPIC_API_KEY或OPENAI_API_KEY。

3. 快速启动：三条命令唤醒你的智能体

第一步：交互式配置npm run setup

这一条命令完成所有手工配置：选择 Claude 或 Codex 运行时与模型、导入 Sendblue API 密钥和专属号码、自动创建 Convex 部署，并生成.env.local配置文件（模板见 .env.example）。完整实现在 scripts/setup.ts。

第二步：准备公网地址（ngrok）

Sendblue 需要把收到的消息推回你的本机，装一次 ngrok 并授权即可：

brew install ngrok # 或到官网下载 ngrok config add-authtoken <your-token>

第三步：一键启动npm run dev

它会并行拉起四个进程：服务器、Convex、调试面板（http://localhost:5173）和 ngrok 隧道，并在隧道就绪后自动向 Sendblue 注册 webhook。启动成功后你会看到类似横幅：

🐶 Debug dashboard (click me): http://localhost:5173 🌐 Public URL: https://abc123.ngrok-free.app 📮 Sendblue webhook (inbound): https://abc123.ngrok-free.app/sendblue/webhook 📱 Text this Sendblue number: +1xxx (请从另一部手机发送)

⚠️ 免费 ngrok 的 URL 每次重启都会变化。长期运行建议用 ngrok 保留域名或 Cloudflare Tunnel 等固定地址隧道，在面板里配置一次 webhook 即可。

4. 发出第一条 iMessage：实时看到智能体工作

用另一部手机给专属号码发任意消息，终端会实时打印智能体的完整"思考链"：

server │ [turn a3f21d] ← +1xxx: "what's on my calendar today?" server │ [turn a3f21d] tool: recall({"query":"calendar today"}) server │ [turn a3f21d] tool: spawn_agent({"integrations":["google-calendar"],...}) server │ [agent 9e82c1] done (completed, 2.1s) server │ [turn a3f21d] → reply (3.4s): "Light day — just your 2pm with Sarah..."

[turn xxx]代表一轮 iMessage 往返，[agent xxx]是它派生的子智能体。即使暂时不接 Sendblue，也能在调试面板的 Chat 页直接聊天，或用POST /chat接口驱动——整套流程完全可用。

5. 不只是聊天：记忆图谱、自动化与 1000+ 集成

🧠 分层记忆：它真的记得你说过什么

记忆按 short / long / permanent 三层存放、衰减速度不同；每轮对话结束后自动抽取事实写入，每 6 小时执行一次清理。配置 Voyage 或 OpenAI embeddings Key 后启用向量检索召回，不配则回退为子串匹配。代码在 server/memory/，面板 Memory 页可用力导向图直观浏览记忆聚类：

⏰ 用 iMessage 口述一句，就建好定时自动化

直接发消息"每天早上 8 点帮我总结日历"，Agent 会调用create_automation创建定时任务，到点自动执行并把结果推回 iMessage。轮询循环实现在 server/automations.ts（每 30 秒检查一次到期任务），面板里可随时开关：

🔌 一个 Key 连通 Gmail、Slack、GitHub 等 1000+ 工具

在.env.local填入COMPOSIO_API_KEY后重启，打开面板 Connections 页点 Connect 完成托管 OAuth，下一条消息即可直接使用，无需重启。每个子智能体只加载调度者指定的工具包，上下文保持精简；任何对外发送操作都会先生成"草稿"，经你确认后才真正发出：

6. 常见坑位速查

7. 下一步看哪里，以及为什么叫 Boop

Boop 是一个"fork-and-own"模板——跑通后自由改造系统提示词、记忆阈值和工具。推荐阅读：

• README.md：完整快速启动与命令说明
• INTEGRATIONS.md：如何添加自己的 MCP 集成
• convex/schema.ts：消息、记忆、智能体的数据模型
• debug/src/components/：调试面板各页面源码

顺便说说名字的来历：Boop 来自作者的狗狗 Luna，它最爱用鼻子顶人的手指。作者希望这个 Agent 也像 Luna 一样，主动在 iMessage 上给你"boop"一下——一条提醒、一份草稿、一个跟进，就像下面这张照片里它正在做的事：

到这里，你就有了一个会聊天、有记忆、能跑定时任务、还能连接 1000+ 工具的 iMessage 个人智能体。去给它发第一条消息吧。

• 人工智能
• 大模型
• AI Agent
• AI 应用
• Agent 记忆
• 工具调用