OpenClaw + 飞书:Windows 上部署 AI 助手的完整踩坑记录

📅 发布时间:2026/7/12 21:26:02 👁️ 浏览次数:
OpenClaw + 飞书:Windows 上部署 AI 助手的完整踩坑记录
折腾了一整天,终于把 OpenClaw 在 Windows 上跑起来了,还成功对接了飞书。说实话,过程中踩了不少坑,有些官方文档没提到的细节卡了我好久。这篇文章记录完整的部署流程,希望能帮你少走弯路。先说说 OpenClaw 是什么简单来说,OpenClaw 是一个开源的 AI 助手框架。它能把 Claude、GPT 这些大模型接入到各种聊天平台——飞书、钉钉、Telegram、WhatsApp 都能接。它的设计挺有意思:Gateway(网关):负责跟各种平台通信Agent(代理):实际处理对话的逻辑Skills(技能):可插拔的工具集,比如查天气、操作文件我选它主要是因为开源 + 可自托管。数据在自己手里,不用担心隐私问题。Windows 部署的正确姿势:WSL2官方文档明确说了:Windows 上推荐用 WSL2。我一开始不信邪,想在原生 Windows 上跑,结果各种报错——Node 版本问题、路径分隔符问题、权限问题… 折腾了两小时后乖乖滚去装 WSL2 了。安装 WSL2 + Ubuntu以管理员身份打开 PowerShell:wsl--install或者指定 Ubuntu 版本:wsl--list--online wsl--install-d Ubuntu-24.04装完重启,然后在 WSL 里启用 systemd(Gateway 需要它):sudotee/etc/wsl.conf/dev/null'EOF' [boot] systemd=true EOF关闭 WSL 再重启:wsl--shutdown验证 systemd 是否生效:systemctl--userstatus看到绿色圆点就说明 OK 了。安装 OpenClaw在 WSL 里执行:gitclone https://github.com/openclaw/openclaw.gitcdopenclawpnpminstallpnpmui:buildpnpmbuild这里有个坑:pnpm 可能会因为网络问题卡住。如果卡住了,换国内源或者开代理。装完之后运行引导程序:openclaw onboard这个向导会一步步带你配置,包括