旧版 clawdbot 已停止维护，建议升级至新版 OpenClaw。新版增加了 WebUI 功能支持可视化配置，并优化了插件安装与扩展能力。
在新版中，你可以优先勾选以下实用技能：
📝 apple-notes/⏰ apple-reminders：在飞书里直接语音或文字指令记笔记、设提醒。🐙 github：通过机器人查询仓库动态或管理 Issue。📸 camsnap：调用 MacBook 摄像头拍照并发送（适合远程监控）。📨 imsg：收发 iMessage 短信。🧩 clawhub：核心组件，建议保留。
1. 清理旧版本
卸载前需先停止正在运行的服务，避免进程占用。
clawdbot gateway stop
彻底卸载旧版 ClawdBot：
npm uninstall -g clawdbot
2. 安装新版本
使用官方脚本一键安装，自动处理 Node 22+ 等环境依赖：
curl -fsSL https://openclaw.ai/install.sh | bash
验证安装版本：
openclaw --version
若显示类似 2026.2.9，表示基础环境就绪。
3. 修复配置文件
从旧版升级时，路径占位符可能导致权限问题。执行以下命令修复配置，自动填入真实路径、配置百炼大脑并开启长连接模式：
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 等信息替换为真实凭证。
4. 处理飞书插件
新版 OpenClaw 内置了飞书插件，必须清理旧插件文件夹以防报错。
清理旧插件：
rm -rf ~/.openclaw/extensions/feishu
启用新插件：
openclaw plugins enable feishu
5. 挂载服务并重启
执行 install 注册系统服务，然后重启网关：
openclaw gateway install
openclaw gateway restart
openclaw status --all
如果看到 Feishu | ON | OK | configured，说明部署成功。
常见问题
服务未真实挂载 (Gateway Not Loaded)
- 避坑：配置完后不要直接运行
openclaw gateway start，否则会提示Gateway service not loaded。 - 解决：必须先执行
openclaw gateway install进行系统登记（挂载）。否则网关无法加载新路径，导致飞书断联。
查看日志：
openclaw logs --follow
路径权限错误
- 现象：日志报错
Error: EACCES: permission denied, mkdir '/Users/你的用户名'。 - 原因：配置文件内保留了中文占位符'你的用户名'，系统尝试创建该目录但无权限。
- 解决：确保执行了第三步的修复命令。代码中的
/Users/$(whoami)/clawd会自动替换为真实系统用户名，从而解决权限问题。