大家好，
我是阿星👋！
上期我们已经教大家如何用本机+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），从而彻底解决权限问题。
