OpenClaw 部署 + 飞书对接完整教程【防踩坑版】

每天都在健身的程序员2026-03-13 9:01

OpenClaw 部署 + 飞书对接完整教程

说明

本教程基于 Linux 系统实现 OpenClaw 开源本地 AI 助手的部署，以及飞书机器人的完整对接流程，全程实操可落地，强调数据自主可控与隐私安全，适配零基础入门。

一、OpenClaw 简介

OpenClaw（原名 Clawdbot，后更名 Moltbot，2025 年 1 月正式定名）是运行在本地环境的高权限 AI 智能体，核心特性如下：

  • 本地部署：运行在自有服务器/电脑，数据完全自主可控
  • 多平台支持：适配飞书、WhatsApp、Telegram、Discord 等主流聊天工具
  • 浏览器控制：可浏览网页、填写表单、提取网页数据
  • 系统访问：读写文件、执行 Shell 命令、运行脚本
  • 持久化记忆：记住用户偏好和交互上下文
  • 插件扩展：支持社区技能插件，也可自定义开发插件

适用场景：邮件管理、日程安排、数据查询、代码编写、系统运维等，是专属的开源 AI 助手。

二、安装前准备

环境要求

项目 具体要求
操作系统 Linux（推荐）/macOS / Windows (WSL2)
Node.js ≥ 22.x
内存 ≥ 2GB（建议 4GB，不足需配置 swap）
网络 可访问 GitHub、npm 仓库（国内服务器需配置代理）
AI 模型 通义千问、OpenAI、Claude、KIMI 等任一 API Key（通义千问免费额度充足，推荐入门）

部署方式选择

  • 阿里云一键部署（推荐新手）：直接使用阿里云预置镜像，几分钟完成服务器搭建，无需手动配置环境
  • 手动部署：适合有基础的用户，按步骤安装依赖和程序

三、OpenClaw 完整安装步骤

3.1 方式一：阿里云一键部署（新手首选）

直接使用阿里云 OpenClaw 专属部署方案，无需手动配置依赖、解决环境冲突，几分钟即可完成服务器搭建。访问阿里云 OpenClaw 一键部署地址，按页面提示完成云服务器创建与 OpenClaw 部署即可。部署完成后直接跳至 3.3 初始化配置 步骤。

3.2 方式二：手动安装（分步操作）

步骤 1：安装 Git 版本控制工具

OpenClaw 安装需通过 Git 拉取相关资源，先完成 Git 安装：

bash 复制代码 
# 更新服务器软件源
sudo apt update
# 安装Git
sudo apt install git -y
# 验证安装（输出git版本即成功）
git --version
步骤 2：安装 Node.js 22.x（核心运行环境）

OpenClaw 要求 Node.js 版本 ≥ 22.x，推荐通过 NVM（Node 版本管理器）安装，适配性更强：

bash 复制代码 
# 国内服务器（使用Gitee镜像源，避免网络超时）
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash

# 国外服务器（使用官方源）
# curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

# 重新加载环境变量，使NVM生效
source ~/.bashrc

# 安装Node.js 22版本
nvm install 22

# 验证Node.js版本（输出v22.x.x即满足要求）
node -v

# 验证npm版本（自动随Node.js安装）
npm -v
步骤 3：安装 OpenClaw 主程序

通过官方一键安装脚本执行，自动拉取最新版本并完成基础部署：

bash 复制代码 
# 执行OpenClaw官方安装脚本
curl -fsSL https://openclaw.bot/install.sh | bash

注意事项：

  • 国内服务器若安装失败，优先检查网络代理是否配置，确保能访问 GitHub、npm 仓库；
  • 其他操作系统（macOS/Windows WSL2）安装方式，参考 OpenClaw 官方安装文档；
  • 安装过程中会自动检测环境，若提示依赖缺失，按控制台提示补充安装即可。

3.3 初始化配置（安装后必做）

主程序安装完成后，控制台会自动进入 OpenClaw 配置向导，按以下固定步骤选择，完成基础初始化：

  1. 安全风险确认 ：控制台弹出安全警告，提示 OpenClaw 具备系统高权限，选择 Yes 并回车（确认知晓风险并继续）；
  2. 配置模式选择 ：选择 QuickStart（快速配置模式，复杂细节可后续通过命令调整，推荐入门）；
  3. AI 模型服务商选择 ：选择 Qwen (OAuth)（通义千问，免费额度充足，无需额外充值，适配中文场景）；
  4. 通义千问账号授权 ：
    • 继续选择 Qwen OAuth，控制台会生成一个授权链接和验证码；
    • 复制授权链接在本地浏览器打开，按提示登录通义千问账号，若需验证则输入控制台的验证码；
    • 授权完成后，控制台提示 Model configured，表示模型对接成功；
  5. 默认模型选择 ：选择 Keep current (qwen-portal/coder-model)（默认编码模型，兼顾聊天与代码编写，适合入门）；
  6. 消息通道选择 ：选择 Skip for now（先跳过通道配置，后续单独针对性配置飞书通道，避免混乱）；
  7. 技能插件配置 ：选择 No（暂不配置技能，先完成基础部署，后续按需开启）；
  8. 启动方式选择 ：选择 Hatch in TUI（推荐终端交互界面，轻量且易验证安装结果）。

3.4 安装成功验证

  • 选择 TUI 启动后，控制台会进入 OpenClaw 的终端聊天界面，输入 Hello 并回车，若控制台出现交互性回复，说明基础安装成功；
  • 若需退出 TUI 界面，按 ctrl + c 即可，后续可通过命令重新启动服务；
  • 首次验证后，建议先关闭 TUI，继续完成飞书通道配置，避免端口占用。

四、OpenClaw 基础操作

4.1 查看服务状态

bash 复制代码 
openclaw status

输出包含 Dashboard 地址、系统信息、服务运行状态、内存占用等，若显示 Gateway service: running，说明服务正常启动。

4.2 访问 Web UI 管理面板

OpenClaw 默认监听 127.0.0.1:18789，服务器本地可直接访问，远程需通过 SSH 隧道映射端口，步骤如下：

  1. 本地执行 SSH 隧道命令（本地电脑终端执行，非服务器）：

    bash 复制代码 
    ssh -N -L 18789:127.0.0.1:18789 服务器用户名@服务器公网IP

    输入服务器登录密码，完成端口映射（保持终端窗口打开，不可关闭）；

  2. 获取 Web UI 授权链接（服务器终端执行）：

    bash 复制代码 
    openclaw dashboard

  3. 本地浏览器访问 ：复制控制台输出的 Dashboard URL（含授权 token），在本地浏览器打开，即可进入 OpenClaw 可视化管理面板，查看聊天记录、配置服务。

4.3 初始化 AI 助手名称

在 TUI 界面或 Web UI 聊天框首次输入 Hello 后，OpenClaw 会提示设置名称，按以下格式输入即可：

复制代码 
Name: OpenClaw      # 配置AI助手的名称
My Name: Boss       # 配置AI助手对自己的称呼

配置后，AI 助手会按该名称进行交互。

五、飞书机器人对接（核心步骤）

5.1 配置 OpenClaw 飞书通道

  1. 重新进入配置向导：服务器端执行以下命令，打开通道配置界面：

    bash 复制代码 
    openclaw onboard

  2. 选择飞书通道 ：在通道列表中找到并选择 Feishu/Lark (飞书)；

  3. 安装飞书官方插件 ：控制台提示 Install Feishu plugin?，选择 Download from npm (@openclaw/feishu) 并回车，自动安装飞书对接所需插件；

  4. 插件安装报错处理 ：若出现 Cannot find module 'zod' 错误，说明缺失依赖，执行以下命令修复后，重新配置飞书通道：

    bash 复制代码 
    # 全局安装zod依赖包
npm install -g zod
# 删除旧的飞书扩展文件，避免冲突
rm -rf ~/.openclaw/extensions/feishu

5.2 飞书开放平台配置（获取应用凭证）

  1. 登录飞书开放平台 ：访问 https://open.feishu.cn，使用企业飞书账号登录，进入「开发者后台」；
  2. 创建企业自建应用 ：点击「创建应用」→ 选择「企业自建应用」→ 填写应用名称（如 OpenClaw-AI）→ 点击「创建」；
  3. 获取核心凭证 ：进入应用的「凭据管理」页面，复制 App ID 和 App Secret（妥善保存，后续需回填到 OpenClaw，不可泄露）；
  4. 添加机器人组件：在应用配置页的「功能模块」中，找到并添加「机器人」组件，完成机器人基础名称配置。

5.3 回填飞书凭证到 OpenClaw

控制台会依次弹出输入框，按提示完成信息填写，所有步骤按以下选择执行：

  • 粘贴飞书开放平台获取的 App ID，回车；
  • 粘贴飞书开放平台获取的 App Secret，回车；
  • 飞书域名选择 ：选择 Feishu (feishu.cn) - China（国内版飞书，企业版均选此项）；
  • 群聊触发策略 ：选择 Open - respond in all groups (requires mention)（所有群聊可 @机器人触发对话，推荐企业使用）；
  • 通道配置完成 ：在通道列表中选择 Finished (Done)，完成飞书通道基础配置；
  • 私信权限配置 ：
    • 控制台提示 Configure DM access policies now?，选择 Yes；
    • 私信策略选择 Open (public inbound DMs)（允许所有人向机器人发私信，按需选择）；
  • 显示名称配置 ：选择 No（暂不配置，后续可在飞书开放平台修改）。

5.4 验证飞书配置文件

配置完成后，可通过查看 OpenClaw 配置文件，确认飞书通道是否开启：

bash 复制代码 
# 查看配置文件内容
cat ~/.openclaw/openclaw.json

飞书配置段需包含以下核心内容，确保 enabled: true（表示飞书通道已开启）：

json 复制代码 
{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的飞书App ID",
      "appSecret": "你的飞书App Secret",
      "domain": "feishu",
      "groupPolicy": "open",
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

5.5 重启 OpenClaw 服务（使配置生效）

bash 复制代码 
openclaw gateway restart

重启完成后，控制台会提示 Gateway restarted successfully，表示飞书通道配置已生效。

5.6 飞书应用最终配置（开放平台端）

飞书机器人需完成事件配置、权限开通、版本发布，才能正常接收消息，步骤如下：

  1. 开启长连接模式：飞书开放平台应用页 → 「事件和回调」 → 选择「长连接模式」，页面提示「连接成功」即完成；

  2. 添加消息接收事件：在「事件和回调」 → 「添加事件」，搜索并选择「接收消息」事件，添加到应用中；

  3. 开通必备权限：进入「权限管理」页面，勾选以下权限（全部开启，缺一不可），并提交审批（企业自建应用审批自动通过）：

    权限名称 权限作用
    contact:user.base:readonly 允许机器人获取用户基础信息
    im:message 允许机器人发送和接收所有消息（含子权限）

  4. 发布应用版本：所有配置完成后，进入「版本管理与发布」 → 「创建版本」 → 填写版本描述 → 「发布」；

关键提醒：每次修改飞书应用配置（事件/权限）后，都需要重新创建并发布版本，否则配置不生效。

5.7 飞书机器人测试

  • 飞书客户端中，在「工作台」找到已发布的 OpenClaw 应用，打开聊天窗口；
  • 发送 Hello，若收到机器人的回复，说明飞书对接完全成功；
  • 群聊中需 @机器人 并发送消息，机器人才会回复（与群聊策略配置一致）。

六、OpenClaw 常用命令速查

命令 功能说明
openclaw status 查看服务运行状态
openclaw onboard 重新进入配置向导（修改通道/模型）
openclaw gateway start 启动 OpenClaw 核心服务
openclaw gateway stop 停止 OpenClaw 核心服务
openclaw gateway restart 重启核心服务（配置修改后必用）
openclaw update 升级 OpenClaw 到最新版本
openclaw health 执行服务健康检查，排查基础问题
openclaw doctor 深度诊断部署/运行问题，给出修复建议
openclaw dashboard 获取 Web UI 授权访问链接（含 token）
openclaw security audit --deep 执行深度安全审计，检查权限/风险
openclaw uninstall 卸载 OpenClaw（删除所有配置和程序）

说明 ：OpenClaw 更名前的旧命令 clawdbot 仍可使用，与 openclaw 功能完全一致，官方推荐新用户使用 openclaw 命令。

七、成本说明与模型推荐

OpenClaw 本身完全免费开源，无任何软件授权费用，仅可能产生以下两类成本，入门阶段可实现 0 成本使用：

7.1 服务器成本

最低配置的云服务器（1 核 2G）即可满足运行要求，月均费用较低；若使用本地电脑/服务器部署，无此成本。推荐阿里云一键部署方案，省去环境配置时间，云服务器可按需选择配置。

7.2 AI 模型 API 调用成本

OpenClaw 需对接 AI 模型才能实现交互，各服务商均提供免费额度，入门推荐通义千问，免费额度充足，无需充值，具体模型对比：

模型服务商 免费额度 适合场景
通义千问（Qwen） 充足（长期有效） 入门首选、中文场景、日常办公/代码编写
小米 MiMo 免费试用额度 成本敏感用户、轻量聊天场景
KIMI (Moonshot) 每日免费额度 中文理解能力强、长文本处理（如文档总结）
GLM 4.7 (Z.AI) 免费额度 性价比高、企业办公/数据查询场景
OpenAI GPT 新用户试用额度（后续付费） 英文场景、高精度代码编写
Anthropic Claude 付费（无免费额度） 复杂任务处理、专业代码开发

八、常见问题 FAQ

8.1 安装时提示 npm install failed？

原因 ：服务器内存不足（新版本 OpenClaw 对内存要求提升，2G 内存易出现 OOM 内存溢出）；
解决方案：配置 swap 交换空间，将硬盘空间作为虚拟内存使用，执行以下命令：

bash 复制代码 
# 创建2G大小的swap文件（可根据需要调整，如4G则改为4G）
sudo fallocate -l 2G /swapfile
# 设置文件权限，避免非授权访问
sudo chmod 600 /swapfile
# 格式化swap文件
sudo mkswap /swapfile
# 启用swap文件
sudo swapon /swapfile
# 设置开机自动启用swap，避免重启后失效
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

8.2 飞书机器人配置后无法收到消息？

按以下优先级顺序排查，90% 的问题可解决：

  1. 确认 OpenClaw 飞书通道已开启（配置文件中 enabled: true）；
  2. 检查 App ID 和 App Secret 是否填写正确（无空格/输错）；
  3. 确认飞书开放平台已添加「接收消息」事件，且开启长连接模式；
  4. 检查 contact:user.base:readonly 和 im:message 权限是否全部开通并审批；
  5. 确认应用已发布新版本（配置修改后未发布是最常见问题）；
  6. 执行 openclaw gateway restart 重启服务，飞书客户端退出重新进入。

8.3 服务器终端提示 openclaw命令找不到？

原因 ：NVM 环境变量未加载，导致命令无法识别；
解决方案：

  • 关闭当前服务器终端，重新打开后再次尝试；
  • 手动重新加载环境变量：source ~/.bashrc；
  • 若仍无效，执行 openclaw doctor 诊断问题，按提示修复；
  • 最后尝试重启服务器，彻底加载环境变量。

8.4 安装过程中控制台卡住不动？

  • 按 Ctrl + C 中断当前操作，避免占用服务器资源；
  • 执行 openclaw doctor 检查环境/网络问题，按控制台提示修复；
  • 排查服务器网络：确保能正常访问 GitHub、npm 仓库（国内服务器需配置代理）；
  • 重新执行 openclaw onboard，重新进入配置向导。

8.5 端口 18789 被占用，无法启动 Web UI？

使用 --port 参数指定其他端口启动服务，示例如下（端口可自定义，如 18790/18791）：

bash 复制代码 
# 用18790端口启动OpenClaw网关服务
openclaw gateway --port 18790

# 对应SSH隧道命令也需修改端口（本地电脑执行）
ssh -N -L 18790:127.0.0.1:18790 服务器用户名@服务器公网IP

8.6 OpenClaw 的数据是否安全？

  • 核心安全：OpenClaw 运行在自有服务器/电脑，所有聊天记录、操作数据均本地存储，不会上传到第三方云端，数据隐私完全可控；
  • 注意事项：因 OpenClaw 具备系统级权限（可执行 Shell 命令、读写文件），建议在独立的服务器/虚拟机部署，避免在生产环境、存储重要数据的机器上运行，降低风险。

8.7 除飞书外，OpenClaw 还支持哪些平台？

支持主流的国内外聊天/协作平台，每个平台需安装对应的专属插件，包括：WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Lark（国际版飞书）等。

8.8 OpenClaw 能实现哪些实际工作功能？

OpenClaw 并非单纯的聊天机器人，可直接操作服务器完成自动化任务，典型使用场景：

  • 文件管理：按类型/时间分类本地文件、批量重命名/删除文件；
  • 网页处理：提取 URL 内容生成摘要、自动填写网页表单、爬取公开数据；
  • 代码开发：编写 Python/Shell/Java 脚本、直接在服务器运行代码并返回结果；
  • 数据查询：连接本地 MySQL/Redis 等数据库，执行查询并返回格式化结果；
  • 日程管理：定时发送提醒、自动回复邮件、生成每日工作简报；
  • 系统运维：执行服务器监控命令、查看系统日志、自动化部署轻量项目。

九、总结

本教程详细完成了 OpenClaw 的两种安装方式（一键部署/手动安装）及飞书机器人的对接、配置、测试全流程，按步骤操作后，即可拥有专属的本地 AI 助手，实现 「飞书聊天窗口下达指令，服务器自动执行任务」 的高效协作模式。

相关推荐
lcreek1 小时前
LeetCode2208. 将数组和减半的最少操作次数、LeetCode2406.将区间分为最少组数
python·算法
chilavert3181 小时前
程序员面试经典问题解答:java篇-2
开发语言·python
Sinokap2 小时前
OpenClaw 大更新：支持 GPT-5.4、记忆热插拔，GitHub Star 突破 28 万
openclaw·gpt-5.4
John Song4 小时前
Python创建虚拟环境的方式对比与区别？
开发语言·python
geovindu4 小时前
python: Bridge Pattern
python·设计模式·桥接模式
搞程序的心海4 小时前
Python面试题（一）：5个最常见的Python基础问题
开发语言·python
宝贝儿好7 小时前
【强化学习实战】第十一章：Gymnasium库的介绍和使用(1)、出租车游戏代码详解(Sarsa & Q learning)
人工智能·python·深度学习·算法·游戏·机器学习
程序媛一枚~10 小时前
✨✨✨使用Python，OpenCV及图片拼接生成❤️LOVE❤️字样图，每张小图加随机颜色边框，大图加随机大小随机颜色边框
图像处理·python·opencv·numpy·图像拼接
MediaTea11 小时前
Python：collections.Counter 常用函数及应用
开发语言·python
热门推荐
01GitHub 镜像站点02OpenClaw 使用和管理 MCP 完全指南03本地部署 OpenClaw + DeepSeek-R1 完全指南04得物前端部门，没了05OpenClaw 飞书机器人不回复消息？3 小时踩坑总结06OpenClaw macOS 完整安装与本地模型配置教程（实战版）07OpenClaw 连接飞书完整指南：插件安装、配置与踩坑记录08Window 10部署openclaw报错node.exe : npm error code 12809OpenClaw 接入 QQ Bot 完整实践指南10OpenClaw-VSCode：在 VS Code 里玩转 OpenClaw，远程管理+SSH 双剑合璧