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

OpenClaw 本地部署与飞书集成实战

OpenClaw 是一款开源个人 AI 助手,支持多平台即时通讯。需先在 Windows 环境安装 Node.js 及配置 PowerShell 权限,随后运行一键脚本完成核心部署。配置过程中可选用智谱 GLM 模型,并通过飞书开发者后台创建应用以接入机器人。文末提供常用命令速查及常见报错解决方案。

DebugKing发布于 2026/3/15更新于 2026/9/954 浏览
OpenClaw 本地部署与飞书集成实战

OpenClaw 安装与飞书机器人接入指南

项目背景

OpenClaw(曾用名 ClawdBot、MoltBot)是一款开源个人 AI 助手。早期因名称版权及域名被抢注等问题,最终定名为 OpenClaw。它不同于传统的聊天机器人,具备真正的执行能力,能够操作电脑、处理邮件、管理日程等,且数据完全由用户掌控。

环境准备

1. 安装 Node.js

虽然安装脚本支持自动检测依赖,但为了稳定性,建议先手动安装 Node.js。

  • 下载地址:https://nodejs.org/zh-cn/download
  • 推荐版本:Node v22.x 及以上

2. 配置 PowerShell 权限

在 Windows 上运行脚本需要调整执行策略。请以管理员身份打开 PowerShell,依次执行以下命令:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy Bypass -Scope Process

说明: 第一条允许当前用户运行本地和下载的脚本,第二条确保当前会话不受限制。这些设置仅影响当前账户,不会危及系统安全。

快速安装

复制以下命令并在 PowerShell 中执行:

iwr-useb https://openclaw.ai/install.ps1 | iex

该脚本会自动完成环境检测、依赖安装、核心文件下载及环境变量配置。如果执行报错,请检查网络或手动安装 Node.js 环境。

初始配置向导

安装完成后,程序会自动启动配置向导 (openclaw onboard)。

  1. 风险告知:按方向键选择 Yes 确认继续。
  2. 模式选择:选择 QuickStart 模式即可。
  3. 模型 API Key:OpenClaw 需连接大语言模型。国内用户推荐使用智谱 GLM 系列以降低 Token 成本。
    • 若无 Key,可访问官网注册获取:https://www.bigmodel.cn/
  4. 模型选择:默认选择 GLM 4.7 旗舰模型。
  5. 通讯平台:初次配置建议跳过飞书,后续通过 UI 单独配置。
  6. 功能插件 (Skills):暂选 No,稍后在 Web UI 中启用。
  7. Hooks:根据需求勾选,通常保持默认。
  8. 启动服务:向导结束后,等待约 30 秒,选择 Open the Web UI 打开控制面板。

浏览器将自动跳转至 Web UI 界面,此时可进行基础测试。

接入飞书机器人

若需在飞书中使用 OpenClaw,需先在飞书开放平台创建应用。

1. 飞书开发者后台配置

  1. 访问飞书开放平台:https://open.feishu.cn
  2. 进入开发者后台,创建企业自建应用。
  3. 填写应用信息并获取 AppID 和 AppSecret。
  4. 添加机器人组件,配置所需权限(如发送消息、读取通讯录等)。
  5. 提交审核并发布为在线应用。

2. 安装与配置插件

回到 PowerShell 窗口,执行以下命令安装飞书插件:

openclaw plugins install @m1heng-clawd/feishu

安装成功后,运行配置命令:

openclaw config

按提示选择渠道为飞书,输入之前获取的 AppID 和 AppSecret,域名选择中国区,并根据需求开启群组聊天权限。配置完成后重启服务。

3. 配置事件回调

  1. 返回飞书开发者后台,找到应用详情中的'事件订阅'。
  2. 选择使用长连接接收事件。
  3. 添加接收消息事件,并开通获取通讯录基本信息的权限。
  4. 重新发布版本。

至此,即可在飞书客户端与 OpenClaw 进行对话交互。

常用命令速查

命令功能
openclaw onboard重新进入配置向导
openclaw status查看运行状态
openclaw health健康检查
openclaw gateway start启动服务
openclaw gateway stop停止服务
openclaw update更新到最新版本
openclaw doctor诊断问题
openclaw uninstall卸载 OpenClaw

常见问题排查

Q1: 安装飞书插件提示 spawn npm ENOENT

这通常是 Windows 下 npm 调用路径的问题。可尝试修改源码中的 exec.js 文件,在 spawn 调用时增加 shell: true 参数。

Q2: 提示'openclaw 命令找不到'

关闭所有终端窗口,重新打开 PowerShell。若仍无效,执行 exec bash 或重启电脑刷新环境变量。

Q3: 端口 18789 被占用

使用其他端口启动服务:

openclaw gateway --port 18790

Q4: API Key 配置错误

执行 openclaw onboard 重新配置,确保密钥格式无误。

结语

OpenClaw 将 AI 从'聊天工具'进化为'执行工具'。虽然初期配置有一定门槛,但一旦跑通,你将拥有一个 24/7 待命的超级助理。主要成本在于模型 API 调用,合理选择国产模型可有效控制开销。

目录

  1. OpenClaw 安装与飞书机器人接入指南
  2. 项目背景
  3. 环境准备
  4. 1. 安装 Node.js
  5. 2. 配置 PowerShell 权限
  6. 快速安装
  7. 初始配置向导
  8. 接入飞书机器人
  9. 1. 飞书开发者后台配置
  10. 2. 安装与配置插件
  11. 3. 配置事件回调
  12. 常用命令速查
  13. 常见问题排查
  14. Q1: 安装飞书插件提示 spawn npm ENOENT
  15. Q2: 提示“openclaw 命令找不到”
  16. Q3: 端口 18789 被占用
  17. Q4: API Key 配置错误
  18. 结语

更多推荐文章

查看全部
  • 基于 HarmonyOS 6.0 的智能监护系统设计与实现
  • 告别数据线!用filebrowser在安卓手机建Web文件服务器(Termux实战)
  • AI 大模型微调详解:核心原理与主流方法解析
  • 具身智能视角下的机器人训练全流程解析
  • 2023 年高考大专就业前景较好的专业推荐
  • 大模型赋能电气行业:从定制设计到人才培养的变革
  • IntelliJ IDEA Python 开发环境配置与实战
  • Stable Diffusion 整合包实战:小白快速上手 AI 绘画指南
  • 《Agent Runtime 工程化》第十一章 源码研读方法:11.11 验收标准
  • AI 产品经理转型指南:核心能力与实战路径
  • 基于 SpringBoot 的在线房屋租赁管理系统设计与实现
  • 密码爆破漏洞详解
  • DeepSeek 系列模型版本演进与核心特性对比
  • YOLOv11 交通违规检测数据集训练方案:头盔佩戴与闯红灯识别
  • 商汤开源 SenseNova-MARS:多模态搜索推理模型突破
  • AJAX 原始请求详解:XMLHttpRequest 对象使用指南
  • Ollama 本地部署与运行开源大模型指南
  • 2026 GitHub 热门 Python 项目:AI 代理与数据工具
  • 高鋒集團合夥人兼 Web3Labs 行政總裁黃俊瑯:以資本與生態賦能傳統企業 Web3 轉型
  • MIDI 全解析:从协议底层到 Python 实操,音乐开发与 AI 作曲

相关免费在线工具

  • 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