Boop 配置完全指南：.env.local 里 15 个关键环境变量一次讲透-北京尧图网络

人工智能大模型AI AgentAI 应用Agent 记忆工具调用【免费下载链接】boop-agentiMessage personal agent: choose Claude Agent SDK (Claude Code) or Codex app-server runtime (Codex/ChatGPT), with memory, sub-agents, automations, integrations.项目地址https://gitcode.com/gh_mirrors/bo/boop-agent点击查看免费下载Boop 是一个通过 iMessage 与你私聊的个人 AI 智能体——用你已有的 Claude Code 或 Codex / ChatGPT 订阅驱动自带记忆、子智能体、定时自动化与上千种集成。所有配置都集中存放在项目根目录的.env.local文件里运行npm run setup时会自动基于 .env.example 生成。本文带你一次讲透.env.local 里 15 个关键环境变量帮你快速完成 Boop 配置并跑通整条链路。快速上手一条命令生成 .env.local你几乎不用手写.env.local。Boop 的交互安装脚本会询问运行时、拉取密钥并把结果写回配置文件源码见 scripts/setup.ts。git clone https://gitcode.com/gh_mirrors/bo/boop-agent cd boop-agent npm install npm run setup # 交互式生成 .env.local 创建 Convex 部署 npm run dev # 启动 server / convex / debug UI / ngrok启动时server/env-setup.ts 会先加载.env.local再回退到.env所以本地开发只改.env.local即可。下面 15 个变量是「跑起来常用能力」的核心更细的可选项浏览器、Apple 数据、ngrok 等文末速查表见 server/runtime-config.ts。一个关键概念Convex 设置会「压过」环境变量Boop 支持从 iMessage 直接改模型、切运行时如「换成 opus」。这些改动写入 Convex 的settings表优先级高于.env.local。环境变量只是「兜底默认值」。解析逻辑见 server/runtime-config.ts先查 Convex 设置查不到才回落到process.env里的默认值。15 个关键环境变量详解一、Convex 数据库连接2 个变量必填说明CONVEX_DEPLOYMENT✅Convex 部署标识npx convex dev自动生成。VITE_CONVEX_URL✅供 Vite Debug 面板使用的部署 URL同样由convex dev写入。这两个变量无需手动填npm run setup跑完就有了。本地开发可把CONVEX_URL保持注释避免 CLI 出现「双 URL」歧义。二、Sendblue / iMessage 桥接3 个变量必填说明SENDBLUE_API_KEY✅Sendblue 控制台获取。SENDBLUE_API_SECRET✅Sendblue 控制台获取。SENDBLUE_FROM_NUMBER✅必须是 Sendblue 分配的号码别人发进来的那个不是你的私人手机号。⚠️SENDBLUE_FROM_NUMBER填错会报missing required parameter: from_number或Cannot send messages to self。修复命令npm run sendblue:sync # 自动从 Sendblue CLI 拉取正确号码并写回 .env.local三、Agent 运行时与模型3 个变量默认说明BOOP_RUNTIMEclaude引擎选择claudeClaude Agent SDK或codex本地 Codex app-server。BOOP_MODELclaude-sonnet-4-6Claude 路径的兜底模型可在 iMessage 里临时切换。BOOP_CODEX_MODELgpt-5.5Codex 路径的默认模型配合BOOP_CODEX_REASONING_EFFORT默认medium。四、主动提醒收件人1 个变量必填说明BOOP_USER_PHONE主动功能必填接收主动 iMessage 通知的手机号v1 单用户假设。不填则 webhook 仍注册但通知被丢弃。逻辑见 server/proactive-email.ts。五、服务器与公网地址2 个变量默认说明PORT3456本地监听端口。PUBLIC_URLhttp://localhost:3456对外 URL用于拼出 Sendblue 入站 webhook。用固定域名隧道Cloudflare Tunnel 等时改成你的稳定域名npm run dev会跳过 ngrok。六、集成与向量召回2 个变量必填说明COMPOSIO_API_KEY可选解锁 1000 工具集成Gmail、Slack、GitHub…。不填也能纯聊天记忆自动化。VOYAGE_API_KEY/OPENAI_API_KEY可选二选一启用向量记忆召回两者都空则回退本地模型始终可用。召回优先级见 server/embeddings.tsVoyage → OpenAI → 本地 Transformers.js三者都输出 1024 维向量Convex 索引完全兼容。七、计费覆盖与图片保留2 个变量必填说明ANTHROPIC_API_KEY可选用 API Key 计费绕过 Claude Code 订阅适合部署到服务器。BOOP_IMAGE_RETENTION_DAYS可选iMessage 收到图片的保留天数默认3被记忆引用的图片永久保留。设为0关闭清理仅调试。清理逻辑见 server/images/clean.ts。其他可选变量速查以下变量默认关闭或按需开启详见 .env.example本地浏览器BOOP_BROWSER_ENABLED默认false、BOOP_BROWSER_PROFILE_DIR、BOOP_BROWSER_SHOW_UI、BOOP_BROWSER_LOGIN_HANDOFF、BOOP_BROWSER_CHANNEL等。本地 Apple 数据仅 MacBOOP_APPLE_ENABLED、BOOP_APPLE_MESSAGES_ENABLED、BOOP_APPLE_NOTES_ENABLED、BOOP_APPLE_REMINDERS_ENABLED。隧道 / webhookNGROK_DOMAIN付费保留域名、SENDBLUE_AUTO_WEBHOOK默认true免费 ngrok 每次重启自动注册。升级提醒BOOP_UPSTREAM_CHECK设false关闭新版横幅。Composio 用户COMPOSIO_USER_ID默认boop-default。常见配置错误排查现象可能原因解决from_number缺失 /send to selfSENDBLUE_FROM_NUMBER填了私人号码npm run sendblue:syncConvex 报「双 URL」同时设置了CONVEX_URL与VITE_CONVEX_URL本地注释掉CONVEX_URL重启后 webhook 失效免费 ngrok 每次换 URL用保留域名或SENDBLUE_AUTO_WEBHOOKtrue改了模型没生效变量只是兜底Convex 设置优先在 iMessage 里切换或清 Convex 设置召回不准未配置向量密钥填VOYAGE_API_KEY或OPENAI_API_KEY更多架构细节见 ARCHITECTURE.md接入自定义工具见 INTEGRATIONS.md。配置完成后npm run dev会打印带颜色的四路日志和 webhook 横幅——用另一部手机给你的 Sendblue 号码发条消息Boop 就会回你。赞分享人工智能大模型AI AgentAI 应用Agent 记忆工具调用【免费下载链接】boop-agentiMessage personal agent: choose Claude Agent SDK (Claude Code) or Codex app-server runtime (Codex/ChatGPT), with memory, sub-agents, automations, integrations.项目地址https://gitcode.com/gh_mirrors/bo/boop-agent点击查看免费下载相关推荐vllm-metal 配置完全指南所有环境变量与调优参数一次讲透vllm metal 配置完全指南所有环境变量与调优参数一次讲透 vllm metal 是专为 Apple SiliconM 系列芯片 Mac打造的 vLLocalStack环境变量终极指南20个关键配置完全解析LocalStack环境变量终极指南20个关键配置完全解析 LocalStack是一个功能齐全的本地AWS云堆栈让开发者能够离线开发和测试云应用及无服务器应如何配置Super-Linter环境变量大全指南从VALIDATE到FILTER的100开关一次讲清如何配置Super Linter环境变量大全指南从VALIDATE到FILTER的100开关一次讲清 Super Linter 是一个开箱即用的代码检查代码质量CI/CD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Boop 配置完全指南：.env.local 里 15 个关键环境变量一次讲透

相关推荐

从零手写MATLAB直方图均衡化：原理、实现与工程优化

Python 解析 AI 代码自动补全的实现方式：从 401/local proxy failed 到 TaoToken 统一 Key 通道

2026腾讯云618活动说明及Hermes Agent/OpenClaw配置Token Plan新手快速入门

更多资讯

信贷风控实战：贷款违约预测的端到端Python建模与避坑指南

Cloudera Manager单节点部署NODE1安装指南：CDH 6.x集群搭建核心步骤

半量工具，双倍效能：ARPO革新大模型强化学习

VSCode插件离线下载与安装：用TaoToken统一Key打通内网vsix部署链路

Kubernetes 1.18.8 离线部署实战：从拆包到集群扩容

ACM/ICPC 北京站网络赛 B Tomb Raider：用二进制枚举解字符串字典序问题

今日更新

Susi AI API实战指南：susi_alexa_skill如何用Node.js调用chat.json获取智能回答

换新电脑了？KeyStats 恢复码数据找回完全指南，端到端加密统计一键重建

重建二叉树：由前序与中序遍历序列还原二叉树的原理与 Java 实现（YCBlogs 剑指 Offer 精讲）

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？