花了一个周末,我把 OpenClaw v2026.3.23-2 在 Ubuntu 上完整跑通了,模型侧接的是 Kimi,IM 侧对接的是飞书。这套组合跑起来之后,等于多了一个能 7x24 小时在线对话、能干活、能接技能的智能体。整个过程比预想的要曲折,尤其是在模型配置和飞书事件订阅这两个环节,官方文档写得比较省略。这篇实录把步骤、踩过的坑、以及最后的解决办法全部记下来,给后面要搭同款方案的朋友一份可以直接照着操作的参考。我先把方案选型说清楚,再按时间线走完整流程,最后是问题排查清单。不管你是第一次接触 OpenClaw,还是已经在别的系统上折腾过,应该都能找到对自己有用的部分。
1. 整体设计与选型思路
1.1 为什么把宿主放在 Linux Ubuntu 上
先说结论:OpenClaw 这种面向服务端的智能体框架,Linux 是更舒服的宿主环境。我自己最开始是在 Windows 上尝试的,结果遇到了几个非常典型的报错,比如 oneclaw node runtime not found,还有删除 ~/.openclaw 目录时提示 EBUSY resource busy or locked。这些问题在 Linux 上几乎不会出现。根源在于 OpenClaw 的大量脚本和依赖工具都按照 Unix 路径约定和权限模型来设计,Windows 的文件锁机制、路径分隔符、命令行参数解析都会带来额外麻烦。
换到 Ubuntu 之后,整个安装过程顺畅了一大截。另外还有一个更实际的理由:智能体这个东西,部署完了是要长期在线的。你可能希望它半夜帮你盯消息、定时跑任务、对接工作流,这种场景下,一台云服务器或者老旧的 Linux 小主机比你的个人电脑可靠得多。把 OpenClaw 跑在 Ubuntu 上,再用 systemd 托管,重启机器都能自动拉起,这才是正经的生产级玩法。所以我这次直接选了一台 Ubuntu 22.04 LTS 的服务器,安安静静让它自己跑,不用我操心。
1.2 模型选型与 IM 工具选择逻辑
这次选 Kimi 不是随手定的。OpenClaw 本身是多模型架构,理论上你可以接 OpenAI、Claude、DeepSeek、本地 Ollama 模型等等。但我觉得对大多数中文用户来说,Kimi 是一个很省心的选择:Moonshot 开放平台的 API Key 注册就能拿,计费清晰,中文语境下的理解能力也够强,上下文窗口对长文档和复杂任务比较友好。我还专门对比了一下,它在多轮对话中的稳定性不错,日常作为智能体的“大脑”是够用的。
选飞书也有明确理由。飞书的开放平台提供机器人能力和长连接事件订阅,不需要你有公网 IP 或者独立域名就能把消息推给机器人,这在个人部署场景里实在太重要了。微信个人号接入恰恰相反,第三方协议不稳定,还要面对风控,长期用的体验并不好。飞书作为 IM 工作入口,既适合个人使用,也可以直接放到团队里用,一次配置,大家都能和智能体对话。如果你后面想接钉钉,思路也差不多,OpenClaw 的 channel 机制是通用的,核心逻辑就是同样的配置套路换一个平台参数而已。
对了,如果你用默认配置跑 OpenClaw,第一次启动时它可能自带 DeepSeek 之类的模型预设,没改配置就去启动,你会看到 unknown model: deepseek 这种报错。这个不是部署失败,纯粹是配置没跟上,后面我详细讲怎么改。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 部署前准备:环境与依赖
2.1 系统与基础依赖安装
这次用的系统是 Ubuntu 22.04 LTS,内存分配了 4G,磁盘 40G。OpenClaw 本身的资源占用不算高,2G 内存也能跑,但考虑到还有 Node.js 进程、Control UI、日志文件,建议至少 2G 起步,4G 会更稳。如果你在云服务器上买的是 1G 内存的小机器,后面跑起来大概率会频繁 OOM,别问我怎么知道的。
先做一轮系统更新,然后安装基础工具:
bash复制sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential
git 用来拉取项目,curl 用来装 Node.js 版本管理器,build-essential 提供编译工具链。即使 OpenClaw 是纯 JS/TS 项目,某些依赖在安装时也可能需要本地编译,少装 build-essential 可能让你在 npm install 阶段碰到莫名其妙的 gyp 报错。这一步没什么技术含量,但做不做会让后面的体验差很多。
2.2 Node.js 运行时安装与版本选择
OpenClaw 对 Node.js 版本有要求,官方写的是 Node 18+,但我实测下来,Node 20 LTS 是最稳的。原因并不复杂
