EnvoyHome 是一个自托管、安全优先的家庭智能体:对话、记忆、文档知识库、静态工作流、审批,以及可选的智能家居控制——全部运行在你自己的机器上。桌面和手机只是望向它的窗口。
轻客户端通过 home.* 连接家庭智能体。中心是智能体循环、工作流、记忆与工具;hub 是可选的。
一个属于你的家庭智能体——不是套了家庭外壳的云端聊天机器人。
EnvoyHome 是 EnvoyMesh 应用家族中的家庭智能体。核心就是智能体循环本身:envoy-harness、静态工作流、记忆、审批,以及一整套智能体可调用的工具——文件、网页、浏览器、办公文档、技能、计划任务、MCP 等等。
智能体住在家庭电脑上。密钥、会话记录、沙箱和智能家居凭据都留在那里。桌面和手机通过 home.* 通道接入;它们是窗口,不是大脑。
智能家居只是这些能力中的一个工具面——当你接入 hub 时有用,但从不定义这个产品。EnvoyHome 用自然语言、审批和工作流来增强 Home Assistant 与 MQTT;它不替代你的 hub,也不附带社交网络。
每一次对话、工作流和计划任务都经过家庭守护进程。轻客户端只是重新连回来——它们从不持有模型密钥,也不运行智能体循环。
用可视化图或 YAML 编写静态 DAG,也可以从自然语言起草。工作流节点调用与对话相同的工具,也走相同的审批。
持久化的待审批、默认 600 秒 TTL、失败即拒绝,以及绑定到已解析调用的授权——而不是一个“智能体可以做任何事”的总开关。
档案、常驻笔记、每日记录、情景检索、KnowYou、文档知识库与技能——持久写入由 PendingLearn 把关。
家庭档案共享同一个智能体,但记忆、文件与策略彼此隔离。手机配对到家庭,每台设备只被允许代表它绑定的账户。
接入 OpenAI 兼容或 Anthropic 兼容的提供商,本地运行 llama.cpp,或连接 Ollama。隐私模式会强制本地推理,并可阻断智能家居出网。
路径沙箱内的文件工具、网页搜索与阅读、带表单卡片的浏览器、办公文档导入导出、技能、会话、MCP 服务器,以及可选的 HA/MQTT 工具。
磁盘上的格式是一个 SKILL.md 目录。可从磁盘、URL 或 ClawHub 安装——启用前先验证能力。智能体自己写的技能只能进入 PendingLearn。
重复或一次性任务,用自然语言描述“什么时候”并由你确认;心跳用于周期性回顾;常驻指令在重启后仍然存在。
桌面外壳是你配置家庭、观察智能体、回答审批的地方。
顶层「工作流」(不再藏在技能下)。在图中或 YAML 里搭建 DAG——与对话共用同一套工具目录与审批。
连接真实 hub 或启动内置演示。设备必须先绑定,智能体才能使用;安全锁定始终先询问。
每个档案一条会话栏、一个面向家庭智能体的输入框,以及内联显示的原生审批——允许、拒绝,或只放行这一次调用。
截图取自本地桌面设置外壳,使用演示档案。点击任意截图可放大。
EnvoyHome 的 iOS / Android Flutter 预览版是连接你自己守护进程的轻客户端。配对一次,即可通过自己的家庭连接对话、处理审批并管理同一套家庭设置。
扫描桌面二维码、粘贴配对链接、输入 host:port,或通过 SSH 连接。手机直接接入你的家庭守护进程。
按家庭档案区分的会话、内联允许 / 拒绝审批、附件与系统语音输入。共享文件和产物通过同一条家庭连接打开。
对话、计划任务中心(任务 · 场景 · 历史)与设置镜像桌面端。LLM、连接、技能(技能包)和系统集中在同一个设置中心。
真实连接页面,提供链接、host:port 和 SSH 选项。配对输入框特意保持为空。
通过已配对的守护进程连接完成的真实通用对话,不含个人或家庭数据。
LLM、连接、技能和系统通过同一条家庭连接,镜像桌面端的控制面。
截图取自 iOS 模拟器中运行的真实 Flutter 应用。点击任意手机截图可放大。
EnvoyHome 不把“一切都是记忆”当作设计。每一层都有明确职责、预算和注入规则——这样智能体可以记住事情,而不会悄悄改写你是谁。
MEMORY.md,以及最近两天的笔记。L5(深度存储)是一个插槽:默认用文件,重型 RAG 后端只作为可选插件。文件始终是事实来源。
knowledge/;EnvoyHome 会在本地 SQLite 中按账户建立索引,并带引用地回答。混合检索可以使用 :18793 上的 Home embed 引擎——全部在家庭机器上完成。你的文档不会被上传到 EnvoyHome 云端,因为根本没有这样的云。
接入 Home Assistant 或 MQTT broker,智能体就能读取状态,并在获得批准后调用服务。它与你现有的 hub 集成;不会变成另一个 hub。
admin,不是写文件。无人值守的回合需要匹配的授权;脚本、场景和按钮的间接调用默认拒绝。neverUnattended 的对象,每次都要询问。预览状态:Home Assistant REST 工具与 MQTT 发布今天已经可用,并附带演示 hub,可走完“对话 → 审批”的完整路径。实时入站事件管道与真实家庭的正式验收,仍需按运维清单执行。
EnvoyMesh 轻客户端是主路径。第一方聊天插件覆盖六个常用平台,HTTP 入口负责其余场景。
桌面和手机通过 home.* 直连家庭,拥有完整的设置与对话。扫描二维码、输入 host:port 或经 SSH 跳板配对一次即可。
参考实现的机器人插件。把发送者绑定到家庭档案,回复留在同一线程。
通过官方 Bot API 的私信对话。不会在整个服务器范围内执行设备动作。
Socket Mode 应用,使用 bot 与 app token。仅支持私信。
长连接事件,仅处理 p2p 消息——不需要公网回调地址。
Stream Mode 机器人,用于一对一对话。
微信客服同步,用于一对一的沟通线程。
一个极简的 /v1/inbound 端点,接住那些永远不会以插件形式加载的机器人。
聊天插件附带配置指南和统一的“发送者 → 档案”绑定。IM 渠道的机器人实机验证仍在进行中——预览阶段请优先使用手机轻客户端。
共享家庭的默认值:沙箱开启、审批持久化、未知即拒绝。
身份就是设备上的一对 Ed25519 密钥。没有 EnvoyHome 注册、没有邮箱,也没有可被攻破的托管会话库。
待审批与授权按账户落盘。重启后问题还在;超时解析为拒绝;无法确认主体身份时同样拒绝。
文件工具统一经过路径沙箱。工具声明 read、write、exec、network、admin 或 sensitive——只能升级,不能降级。
一个硬开关:强制本地推理并拒绝云端工具。开启智能家居出网阻断后,还会拒绝设备动作与事件源通知。
记忆、会话、文件、授权与策略都按账户隔离。已配对设备只能代表它绑定的账户行动。
设备动作属于 admin。摄像头、门锁与存在数据属于 sensitive,会强制本地推理。设备状态不会自动进入常驻记忆。
三款应用共享同一张网——身份、配对与传输——但各自保留独立的大脑与独立的状态。
预览版从源码运行。你需要 Node.js 22+、pnpm,以及一份同级的 EnvoyMesh 检出。
EnvoyHome 通过 link: 链接 @envoymesh/*——它们不在 npm 上。同级依赖缺失或分支不对时,检查会失败关闭。
./scripts/peers-check.sh
# 或设置 ENVOYHOME_PEERS_GIT_BASE 后运行 ./scripts/fetch-peers.sh
不要在 CI=true 下安装——pnpm 严格模式的这个陷阱在本仓库有明确约定。
env -u CI pnpm install pnpm -r build
单独运行守护进程,或让桌面外壳托管它。然后创建档案、添加模型,需要时再配对手机。
pnpm run dev:daemon # 仅守护进程 pnpm desktop:dev # Tauri 设置外壳
| WebSocket | ws://127.0.0.1:4780/ws |
| 健康检查 | http://127.0.0.1:4781/health |
桌面端以 macOS 为主,Linux 与 Windows 尽力支持。手机应用是 Flutter 预览版。
EnvoyHome 0.2.0 处于早期预览阶段。v1.0.0 尚未打标签,也没有正式的 App Store 或 Play 上架——请从源码或 release/ 下本地构建的安装包安装。
需要 Node.js ≥ 22 与 pnpm 10.33(根 packageManager)、一份同级的 EnvoyMesh 检出,以及桌面外壳所需的 Rust 与 Tauri CLI 前置依赖。
./scripts/peers-check.sh
env -u CI pnpm install
pnpm -r build
pnpm desktop:dev # 缺少守护进程构建时先构建,然后启动 Tauri dev
desktop:dev 会执行 ./scripts/desktop-dev.sh:仅在缺少该文件时构建 packages/daemon/dist/bin/envoyhome-daemon.js,然后启动 tauri:dev;二进制存在后由 Tauri 托管守护进程。启动前不需要准备 provider 配置文件——首次打开的设置页会要求创建档案并选择模型提供方(预设 + 密钥,或 Local / Ollama)。
发布安装包:./scripts/build-desktop.sh macos → release/envoyhome-desktop-0.2.0-macos-*.dmg(需要 Developer ID 签名与公证;默认暂存推送凭据,可用 REQUIRE_PUSH_CREDENTIALS=0 跳过)。Windows:在 Windows 主机上运行 .\scripts\build-desktop.ps1。