这个系列的第一篇我写了怎么把 OpenClaw 这个 AI 核心在家庭环境里跑起来,模型用的 DeepSeek,基础对话已经没问题了。但说实话,跑通归跑通,家里没人愿意打开那个网页去聊天。直到我把飞书机器人接进 OpenClaw,这事儿才真正从“我自己的玩具”变成了“家里人愿意用”的工具。现在我在飞书里跟它聊天气、查日程、让它调接口干活,老婆在群里 @ 它也能正常响应。这篇文章就把从飞书开放平台创建应用、到 OpenClaw 配置飞书通道、再到写 Skill 扩展能力的完整过程都拆开讲一遍,顺带把部署期间那几个高频报错(比如 Control UI did not start、node runtime not found)一并说清楚。
1. 为什么最后选飞书当家庭 AI 的对话入口
1.1 不是微信接不起,而是飞书更省心
我最早想的是接入微信,毕竟全家人都用微信,习惯成本为零。但实际调研下来发现,微信个人号协议接入这类机器人,本质上是在走非官方接口,有挺大的风控风险。轻则消息发不出去,重则账号被限制。公众号倒是正规,但订阅号/服务号的接口权限、认证流程、消息模板,对家庭内部这种小规模场景来说太重了,而且也不支持那种“像真人一样聊天”的连续对话体验。
飞书不一样。飞书开放平台提供了官方机器人能力,个人可以创建一个只有几个人的企业,在内部自建应用,然后启用机器人,这套流程完全免费,也不要求企业认证。更关键的是,飞书的事件订阅支持长连接模式,也就是说不需要公网 IP、不需要配置回调 URL,OpenClaw 在家里跑着,通过长连接就能实时收到飞书消息。对家庭内网环境来说,这一条直接解决了最大的网络配置难题。
1.2 飞书机器人对于家庭场景的几个比较优势
拿我实际体验来说,飞书作为入口有几个优点不是纸面参数,而是日常用出来的:
- 多端齐全:手机、电脑、网页都有客户端,长辈用手机,我自己在电脑上也能顺手打开同一个会话。
- 单聊群聊都支持:既能和机器人单独聊天,也能把机器人拉进家庭群,所有人共享一个助手。
- 消息卡片能力:飞书机器人可以发复杂卡片消息,后面做日程提醒、待办列表的时候,展示效果比纯文本好太多。
- 权限模型的颗粒度合适:开放平台里可以精确控制这个应用能读什么、不能读什么,把最小权限给了,心里踏实。
- OpenClaw 社区对飞书通道的打磨已经比较成熟:基本就是填上 App ID 和 App Secret 就能跑,下一步扩展接口也有现成路子。
当然,这不是说飞书完美。飞书机器人在国内使用时,偶尔会碰到开放平台控制台打开慢、应用审核需要管理员同意这类小摩擦。但相比微信那种“能不能用看运气”的状态,飞书是正规军路线,更适合一个想要长期稳定运行的家庭基础设施。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 先让 OpenClaw 跑起来:环境、模型与三个启动报错
2.1 家庭部署的环境选型与安装流程
OpenClaw 的部署门槛不算高,Node.js 环境就能跑。我建议用家里长期开机的设备,比如 Mac mini、老旧笔记本,或者一块跑着 Linux 的小主机。我自己用的是一台 Mac mini,功耗低,放客厅角落也没声音。
安装流程大致是这样:
- 先装 Node.js,务必选 LTS 版本,我用的 18.x,后面会解释为什么不建议用最新版本。
- 通过 npm 全局安装 OpenClaw CLI 工具(具体包名以你安装时的官方文档为准):
bash复制npm install -g @openclaw/cli
- 初始化项目目录:
bash复制openclaw init my-home-ai
cd my-home-ai
- 启动:
bash复制openclaw start
第一次启动会引导你配置模型。我自己用的是 DeepSeek 的 API,配置里需要填 API Key,模型名填 deepseek-chat。如果你不想依赖外部 API,也可以用 Ollama 跑本地模型,OpenClaw 对
