clawdbot无痛升级openclaw，飞书变个人AI助理保姆级教程

大家好，

我是阿星👋！

上期我们已经教大家如何用本机+clawdbot在飞书上部署个人助理。clawdbot接入飞书阿里云，立即拥有24小时AI助理贾维斯

但是clawdbot又改名为OpenClaw了旧的已经不维护了。

新版还加了webui功能可以可视化进行配置。所以我们肯定是要升级的。

而且新版还可以比较方便安装一下下面功能，还能做功能拓展：

在新版，你可以优先勾选以下几个最实用的技能

所以，如果你想实现下面这些功能，可以跟着下面步骤升级到2026.2.9

📝 apple-notes / ⏰ apple-reminders : 这样你可以直接在飞书里跟机器人说"帮我记个笔记"或者"下午三点提醒我开会"。
🐙 github : 勾选这个可以让你通过机器人查询仓库动态或管理 Issue。
📸 camsnap : 很酷的功能，可以让机器人调用你 MacBook 的摄像头拍照并传给你（适合远程监控）。
📨 imsg : 允许机器人帮你收发 iMessage 短信。
🧩 clawhub : 核心组件，建议保留。

第一步：清理旧门户

🛑 先让旧机器人"下班" 在卸载之前，必须先停止正在运行的服务，否则进程占用会让你怀疑人生。

arduino 复制代码

clawdbot gateway stop

🗑️ 彻底卸载旧版 ClawdBot

复制代码

npm uninstall -g clawdbot

第二步：一键入驻新家

官方提供了一行代码的一键安装脚本，它会自动帮你把环境依赖（比如 Node 22+）都搞定：

arduino 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

🔍 验明正身 安装完后，输入下面这行命令，看看新版本是不是已经在你的电脑里安装了：

css 复制代码

openclaw --version

如果显示类似 2026.2.9，恭喜你，基础环境已就绪！

第三步：一键修复配置（复活贾维斯的灵魂！）

如果你是从老版本升级的，之前的路径占位符（比如"你的用户名"）会导致权限崩溃。直接复制并执行下面这段 终极修复命令 ，它会自动填入你的真实路径、配置百炼大脑并开启长连接模式：

javascript 复制代码

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 已经内置了飞书插件，旧的插件文件夹必须删干净，否则会报错。

清理旧插件 ：

bash 复制代码

rm -rf ~/.openclaw/extensions/feishu

启用新插件 ：

bash 复制代码

openclaw plugins enable feishu

第五步：挂载并重启享受

最后一步，一定要执行 install 来注册系统服务，然后重启网关：

lua 复制代码

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 进行"系统登记"（挂载）。
后果：如果不先挂载，网关就无法带着你新改的路径跑起来，飞书那边永远是断联状态。

css 复制代码

openclaw logs --follow

Bug 2：不知道你从哪里复制的乱码导致路径权限错误

这是我们排查出的第一个、也是最严重的"硬伤"。

现象：如果你去查日志（openclaw logs），会发现反复报错 Error: EACCES: permission denied, mkdir '/Users/你的用户名'。
原因：因为配置文件里直接写了中文"你的用户名"，系统真的尝试在 /Users/ 目录下创建一个叫"你的用户名"的文件夹。
后果：由于没有权限，消息分发（Dispatch）在第一步就崩了。虽然飞书信号传到了你的 Mac，但机器人因为"写不进文件"而无法处理消息。
解决方法 ： 确保第三步的修复命令被完整执行 。代码中的 "/Users/$(whoami)/clawd" 会自动将占位符替换成你真实的系统用户名（比如 xingyang），从而彻底解决权限问题。