OpenClaw 本地 AI 助手部署与飞书对接教程
OpenClaw 是一款支持本地部署的开源 AI 智能体,可运行于 Linux 服务器并通过飞书等工具交互。教程涵盖环境准备、Git 与 Node.js 安装、OpenClaw 脚本部署及配置流程。重点说明如何安装飞书插件、获取应用凭证、配置回调地址与权限,以及发布应用版本以实现消息收发。包含常见问题解答,如内存不足处理、模型选择及命令兼容性说明。

OpenClaw 是一款支持本地部署的开源 AI 智能体,可运行于 Linux 服务器并通过飞书等工具交互。教程涵盖环境准备、Git 与 Node.js 安装、OpenClaw 脚本部署及配置流程。重点说明如何安装飞书插件、获取应用凭证、配置回调地址与权限,以及发布应用版本以实现消息收发。包含常见问题解答,如内存不足处理、模型选择及命令兼容性说明。

OpenClaw 是一款开源的本地 AI 助手,支持在服务器上部署,通过飞书、WhatsApp、Telegram 等聊天工具交互。与云端 SaaS 服务不同,OpenClaw 让用户完全掌控数据隐私,可执行系统命令、浏览网页、管理文件及编写代码。本教程介绍在 Linux 系统下安装 OpenClaw 并对接飞书机器人,打造专属智能助理。
注意:本教程基于 Linux 系统环境。
OpenClaw(原名 Clawdbot,后更名为 Moltbot)是一个运行在本地环境的高权限 AI 智能体。核心特性包括:
准备一台闲置的云服务器或 VPS(推荐使用独立节点)。由于 OpenClaw 运行时权限较大,出于安全考虑,不建议在本地或工作机上安装,推荐在独立空服务器上部署。登录到服务器。
sudo apt update
sudo apt install git -y
使用 NVM 管理 Node.js 版本。
# 国内使用 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
# 重新加载环境变量
source ~/.bashrc
# 安装 Node.js 22
nvm install 22
# 查看 nodejs 版本
node -v # 输出 v22 即可
使用官方脚本安装:
curl -fsSL https://openclaw.bot/install.sh | bash
服务器在国内,如果安装失败可能需要解决网络问题。
其他平台安装方式请参考官方文档。
安装过程可能耗时较长。若遇到 npm install failed 错误,通常是服务器内存不足导致 OOM。建议配置 swap 交换空间,将硬盘空间作为虚拟内存使用。
安装成功后会进入配置向导:
yes 确认已知风险。QuickStart 快速开始。Qwen(通义千问),免费额度充足。No。No。TUI 终端界面。若看到 TUI 聊天界面,说明安装成功,可输入 Hello 测试。完成后按 Ctrl+C 关闭。
clawdbot status
显示服务启动即表示正常。
服务监听在 http://127.0.0.1:18789/ 端口。通过 SSH 隧道访问:
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器 IP
在浏览器打开 http://127.0.0.1:18789/ 查看 Dashboard。若显示未授权,回到服务器执行:
clawdbot dashboard
复制输出的 Dashboard URL 到浏览器打开即可查看聊天记录。
首次输入 Hello,Bot 会询问名称设置,例如:
Name: Openclaw My Name: Boss
clawdbot plugins install @m1heng-clawd/feishu
登录飞书开放平台,创建企业自建应用:
contact:user.base:readonly (用户信息)im:message (发送和接收消息)clawdbot config set channels.feishu.appId "飞书 app id"
clawdbot config set channels.feishu.appSecret "飞书 app secret"
clawdbot config set channels.feishu.enabled true
clawdbot config set channels.feishu.connectionMode websocket
clawdbot config set channels.feishu.dmPolicy pairing
clawdbot config set channels.feishu.groupPolicy allowlist
clawdbot config set channels.feishu.requireMention true
配置完成后重启网关:
clawdbot gateway restart
重启完成后,在飞书客户端打开应用,向机器人发送 Hello 即可收到回复。
OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot,后因商标问题更名为 Moltbot,最终定名为 OpenClaw。三者是同一项目的不同阶段命名。
支持 Anthropic Claude、OpenAI GPT、通义千问(Qwen)、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足。
通常是服务器内存不足。新版本脚本对内存要求较高,2G 内存可能出现 OOM。建议配置 swap 交换空间。
可以。支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例,其他系统参考官方文档。
检查以下几点:
运行在本地服务器,数据本地存储。但具有系统级权限,建议在独立服务器上部署,避免在生产环境或重要数据的机器上运行。
支持 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需安装对应插件。
邮件管理和自动回复、日程安排和提醒、浏览网页和数据提取、文件读写和管理、执行 Shell 命令、编写和运行代码、数据查询和分析。
使用以下命令更新:
openclaw update
更名后官方推荐使用 openclaw 命令,但为了兼容性,clawdbot 命令仍然可用。两者功能完全相同,建议新用户直接使用 openclaw 命令。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online