clawdbot无痛升级openclaw，飞书变个人AI助理保姆级教程
大家好，
我是阿星👋！
上期我们已经教大家如何用本机+clawdbot在飞书上部署个人助理。clawdbot接入飞书阿里云，立即拥有24小时AI助理贾维斯
但是clawdbot又改名为OpenClaw了旧的已经不维护了。
新版还加了webui功能可以可视化进行配置。所以我们肯定是要升级的。
而且新版还可以比较方便安装一下下面功能，还能做功能拓展：
在新版，你可以优先勾选以下几个最实用的技能
所以，如果你想实现下面这些功能，可以跟着下面步骤升级到2026.2.9
📝 apple-notes/⏰ apple-reminders: 这样你可以直接在飞书里跟机器人说“帮我记个笔记”或者“下午三点提醒我开会”。🐙 github: 勾选这个可以让你通过机器人查询仓库动态或管理 Issue。📸 camsnap: 很酷的功能，可以让机器人调用你 MacBook 的摄像头拍照并传给你（适合远程监控）。📨 imsg: 允许机器人帮你收发 iMessage 短信。🧩 clawhub: 核心组件，建议保留。
第一步：清理旧门户
- 🛑 先让旧机器人“下班” 在卸载之前，必须先停止正在运行的服务，否则进程占用会让你怀疑人生。
clawdbot gateway stop
🗑️ 彻底卸载旧版 ClawdBot
npm uninstall -g clawdbot
第二步：一键入驻新家
官方提供了一行代码的一键安装脚本，它会自动帮你把环境依赖（比如 Node 22+）都搞定：
curl -fsSL https://openclaw.ai/install.sh | bash
🔍 验明正身 安装完后，输入下面这行命令，看看新版本是不是已经在你的电脑里安装了：
openclaw --version
如果显示类似 2026.2.9，恭喜你，基础环境已就绪！
第三步：一键修复配置（复活贾维斯的灵魂！）
如果你是从老版本升级的，之前的路径占位符（比如“你的用户名”）会导致权限崩溃。直接复制并执行下面这段 终极修复命令 ，它会自动填入你的真实路径、配置百炼大脑并开启长连接模式：
cat <<EOF > ~/.openclaw/openclaw.json { "meta": { "lastTouchedVersion": "2026.2.9" }, "auth": { "profiles": { "bailian:default": { "provider": "bailian", "mode": "api_key" } } }, "models": { "mode": "merge", "providers": { "bailian": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "你的百炼APIKEY", "api": "openai-completions", "models": [ { "id": "qwen-vl-plus", "name": "Qwen VL Plus" } ] } } }, "agents": { "defaults": { "model": { "primary": "bailian/qwen-vl-plus" }, "workspace": "/Users/$(whoami)/clawd", "compaction": {"mode": "safeguard"}, "maxConcurrent": 4 } }, "channels": { "feishu": { "enabled": true, "appId": "你的飞书AppID", "appSecret": "你的飞书Secret", "connectionMode": "websocket", "groupPolicy": "open" } }, "gateway": { "port": 18789, "mode": "local", "bind": "loopback", "auth": { "mode": "token", "token": "admin123" } }, "plugins": { "entries": {} } } EOF(⚠️注意：请手动将代码里的你的百炼APIKEY、你的飞书AppID等信息替换为真实的凭证。)
第四步：飞书用户的“扫雷”操作
新版 OpenClaw 已经内置了飞书插件，旧的插件文件夹必须删干净，否则会报错。
清理旧插件 ：
rm -rf ~/.openclaw/extensions/feishu
启用新插件 ：
openclaw plugins enable feishu
第五步：挂载并重启享受
最后一步，一定要执行 install 来注册系统服务，然后重启网关：
openclaw gateway install
openclaw gateway restart
openclaw status --all
你应该能看到 Feishu | ON | OK | configured。如果这一行出来了，说明 OpenClaw 的“耳朵”已经张开了。
bug1：服务未真实挂载 (Gateway Not Loaded)
这是解决“连通性”的关键。
- 避坑提醒 ：配置完后， 千万不要直接运行
openclaw gateway start，否则会提示Gateway service not loaded。 - 正确姿势 ：必须先执行
openclaw gateway install进行“系统登记”（挂载）。 - 后果 ：如果不先挂载，网关就无法带着你新改的路径跑起来，飞书那边永远是断联状态。
openclaw logs --follow
Bug 2：不知道你从哪里复制的乱码导致路径权限错误
这是我们排查出的第一个、也是最严重的“硬伤”。
- 现象 ：如果你去查日志（
openclaw logs），会发现反复报错Error: EACCES: permission denied, mkdir '/Users/你的用户名'。 - 原因 ：因为配置文件里直接写了中文“你的用户名”，系统真的尝试在
/Users/目录下创建一个叫“你的用户名”的文件夹。 - 后果 ：由于没有权限，消息分发（Dispatch）在第一步就崩了。虽然飞书信号传到了你的 Mac，但机器人因为“写不进文件”而无法处理消息。
- 解决方法 ： 确保第三步的修复命令被完整执行 。代码中的
"/Users/$(whoami)/clawd"会自动将占位符替换成你真实的系统用户名（比如xingyang），从而彻底解决权限问题。
