跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

ClawdBot 平滑迁移至 OpenClaw:飞书 AI 助理部署实战

将 ClawdBot 升级至 OpenClaw 实现飞书个人 AI 助理的平滑迁移。主要步骤包括卸载旧服务、运行官方安装脚本、修复配置文件中的路径占位符、清理旧插件并启用新模块。重点解决了网关未挂载及权限错误等常见问题,支持 Apple Notes、GitHub、摄像头调用等功能拓展。通过命令行配置百炼 API 与飞书凭证,完成本地服务注册与启动,确保机器人稳定运行。

极光发布于 2026/3/24更新于 2026/10/2582 浏览
ClawdBot 平滑迁移至 OpenClaw:飞书 AI 助理部署实战

图片

旧版 ClawdBot 已停止维护,新版 OpenClaw 不仅保留了原有功能,还增加了 WebUI 可视化配置界面,并支持更多插件拓展。为了获得更好的体验和功能支持,建议将本地环境升级至最新版本。

图片

新版支持的功能模块非常丰富,例如 Apple Notes、GitHub 管理、摄像头快照等。以下是核心功能的简要说明:

  • apple-notes / apple-reminders:在飞书内直接语音或文字指令创建笔记和提醒。
  • github:通过机器人查询仓库动态或管理 Issue。
  • camsnap:调用 MacBook 摄像头拍照并发送消息,适合远程监控场景。
  • imsg:收发 iMessage 短信。
  • clawhub:核心组件,建议保留。

1. 清理旧环境

卸载前必须先停止正在运行的服务,防止进程占用导致卸载失败。

clawdbot gateway stop
npm uninstall -g clawdbot

2. 安装新版 OpenClaw

官方提供了一键安装脚本,会自动处理 Node 22+ 等环境依赖。

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

安装完成后,验证版本信息:

openclaw --version

若显示类似 2026.2.9,说明基础环境已就绪。

3. 配置文件修复

从旧版升级时,配置文件中的路径占位符(如'你的用户名')会导致权限错误。需执行以下命令自动填充真实路径并开启长连接模式。

⚠️ 注意:请手动替换代码中的 你的百炼 APIKEY、你的飞书 AppID 等信息为真实凭证。

{
  "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"
:
{
}
}
}

将上述内容保存至 ~/.openclaw/openclaw.json。其中 /Users/$(whoami)/clawd 会自动解析为当前系统用户路径,避免硬编码导致的权限问题。

4. 插件清理与启用

新版内置了飞书插件,旧版插件文件夹必须删除,否则可能引发冲突。

rm -rf ~/.openclaw/extensions/feishu
openclaw plugins enable feishu

5. 服务注册与启动

最后一步是注册系统服务并重启网关。务必先执行 install 进行挂载,再执行 start。

openclaw gateway install
openclaw gateway restart
openclaw status --all

如果输出包含 Feishu | ON | OK | configured,说明服务已成功运行。

常见问题排查

网关未挂载

配置完成后,切勿直接运行 openclaw gateway start,否则会提示 Gateway service not loaded。必须先执行 openclaw gateway install 完成系统登记,否则网关无法加载新路径配置,导致飞书断联。

路径权限错误

若日志中出现 Error: EACCES: permission denied, mkdir '/Users/你的用户名',说明配置文件仍保留了中文占位符。系统会尝试在根目录下创建名为'你的用户名'的文件夹,因无权限而报错。确保执行了第三步的配置修复命令,使用 $(whoami) 变量可自动获取真实用户名,彻底解决此问题。

图片

目录

  1. 1. 清理旧环境
  2. 2. 安装新版 OpenClaw
  3. 3. 配置文件修复
  4. 4. 插件清理与启用
  5. 5. 服务注册与启动
  6. 常见问题排查
  7. 网关未挂载
  8. 路径权限错误

更多推荐文章

查看全部
  • 昇腾 NPU 运行 Llama 模型:环境搭建与性能测试
  • NSP 新范式:AI 世界模型构建与物理规律建模指南
  • 混合专家模型 (MoE) 详解
  • C++ 继承入门 (下):友元、静态成员与菱形继承的底层逻辑
  • Rust WebAssembly 与 Three.js 结合的高性能粒子系统实战
  • Spring Boot 微服务架构设计与实战指南
  • 网络安全自学指南:三个阶段与核心学习路线
  • 基于 Coze 构建 AI 应用及 Web 部署指南
  • LeetCode 49. 字母异位词分组 Java 实现
  • HarmonyOS6 RcInput 组件核心架构与类型系统设计
  • Python 核心语法速查:数据类型与基础操作
  • VS Code SSH 远程环境中 Copilot 无模型选项问题修复
  • Flutter for OpenHarmony:基于 flutter_rust_bridge 的跨语言高性能计算实践
  • Git 版本控制基础操作指南
  • Linux 上安装 PostgreSQL
  • JavaSE 基础:JVM 内存、类加载与 GC 机制
  • 深入辨析 PLC 编程语言:ST、STL 与 SCL 的区别
  • 嵌入式与工控核心技术解析:C#, PLC, STM32, FPGA, DSP 及 HMI
  • Dirsearch Web 路径扫描工具安装与使用指南
  • Java 智能仿真无人机项目 4.0 核心实现

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online