想快速搭建基于 OpenClaw 的飞书智能机器人？本文带来作者亲测的 OpenClaw 全流程部署指南！从基础环境搭建，到飞书应用创建、API 密钥配置，再到 OpenClaw 一键安装与网关调试，每一步都附带具体命令、参数示例及截图指引，甚至针对部署中可能出现的系统服务报错提供了精准解决指令。无论你是新手还是有一定运维经验，按照本文步骤执行均可确保部署一次成功，同时还能轻松扩展 tavily-search、humanizer 等实用 Skill，让飞书机器人具备更丰富的 AI 能力。无需反复踩坑，跟着做就能快速拥有专属的飞书 AI 机器人！

一、部署环境清单

环境类别	具体配置	说明
操作系统	Debian 12	建议纯净系统，避免依赖冲突
运行环境	Node.js v24.14.0	需配置全局环境变量
OpenClaw	2026.3.2	通过 npm 自动安装
模型	kimi-k2.5	需提前准备有效 API Key
消息渠道	飞书	需完成企业自建应用创建及授权

二、基础环境搭建

2.1 Node.js 安装与配置

# 下载安装包
wget https://nodejs.org/dist/v24.14.0/node-v24.14.0-linux-x64.tar.xz

# 解压至临时目录
tar -xvf node-v24.14.0-linux-x64.tar.xz

# 移动到/usr/local安装
mv node-v24.14.0-linux-x64 /usr/local/node-v24.14.0-linux-x64
cd /usr/local/node-v24.14.0-linux-x64

# 建立软链接
ln -s /usr/local/node-v24.14.0-linux-x64/bin/node /usr/local/bin/node
ln -s /usr/local/node-v24.14.0-linux-x64/bin/npm /usr/local/bin/npm

# 配置环境变量（永久生效）
vim /etc/profile

# 在文件末尾添加以下内容
export NODE_HOME=/usr/local/node-v24.14.0-linux-x64
export PATH=$PATH:$NODE_HOME/bin
export NODE_PATH=$NODE_HOME/lib/node_modules

# 使环境变量生效
source /etc/profile

# 验证安装结果（输出对应版本号即成功）
node -v
npm -v

2.2 Kimi API Key 准备

1. 访问 Kimi 开放平台：Moonshot AI 开放平台 - Kimi K2.5 大模型 API 服务
2. 登录后创建 API Key（注意区分 .cn 域名专用）
3. 验证账号余额：确保余额充足，避免调用模型时鉴权失败
4. 保存 API Key：建议临时记录在安全位置，配置 OpenClaw 时需手动粘贴

2.3 飞书应用创建

访问飞书开放平台：https://open.feishu.cn/app

选择「创建应用」→「企业自建应用」，填写应用名称

添加「机器人」能力（核心功能）

开通消息相关权限

记录关键信息：App ID 和 App Secret（后续 OpenClaw 配置必填）

事件配置，事件配置若提示保存失败，可先完成 OpenClaw 网关配置后重试，大概率是回调地址未生效导致。

添加事件

开通通讯录权限

应用发布

三、OpenClaw 安装与核心配置

官网：https://openclaw.ai/

3.1 OpenClaw 安装

# 全局安装 OpenClaw
npm i -g openclaw

3.2 交互式配置流程

执行以下命令启动配置向导，按提示完成每一步选择：

openclaw onboard

关键配置步骤（精准指引）

配置项	推荐选择 / 操作
协议确认	选择「Yes」继续
部署模式	选择「QuickStart」（快速启动，适配新手）
模型提供商	选择「Moonshot AI (Kimi K2.5)」
Kimi 鉴权方式	选择「Kimi API key (.cn)」
API Key 提供方式	选择「Paste API key now」，粘贴已准备的 Kimi API Key
默认模型	选择「Keep current (moonshot/kimi-k2.5)」
消息渠道	选择「Feishu/Lark (飞书)」
飞书插件安装	选择「Download from npm (@openclaw/feishu)」（自动安装官方插件）
飞书 App Secret/ID 提供方式	依次选择「Enter App Secret」「Enter App ID」，粘贴飞书应用的对应信息
飞书连接测试	等待验证，显示「Connected as xxx」即连接成功
飞书连接模式	选择「WebSocket (default)」（稳定优先）
飞书域名	选择「Feishu (feishu.cn) - China」（适配国内版飞书）
群聊响应策略	选择「Open - respond in all groups (requires mention)」（@机器人才响应）
技能配置	先选「No」（基础部署完成后再扩展）
Hooks 启用	选择「Skip for now」（暂不启用）
网关运行时	默认 Node 环境（无需修改）
机器人启动方式	选择「Open the Web UI」（生成 Web 管理界面链接）

原始操作记录

◇  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  Yes

◇  Onboarding mode
│  QuickStart

◇  Model/auth provider
│  Moonshot AI (Kimi K2.5)

◇  Moonshot AI (Kimi K2.5) auth method
│  Kimi API key (.cn)

◇  How do you want to provide this API key?
│  Paste API key now

◇  Enter Moonshot API key (.cn)
│  sk-kmGyXm5Ca8rcO6lRASTaGNCrdK4wKeZzt1efYFPOG7YK1tDN

◇  Default model
│  Keep current (moonshot/kimi-k2.5)

◇  Select channel (QuickStart)
│  Feishu/Lark (飞书)
│
◇  Install Feishu plugin?
│  Download from npm (@openclaw/feishu)
│
◇  How do you want to provide this App Secret?
│  Enter App Secret
│
◇  Enter Feishu App Secret
│  Xu0fa6aLUANd9UGjQITLueBWo5NpXjGV
│
◇  Enter Feishu App ID
│  cli_ac2148cf57e15dc3
[info]: [ 'client ready' ]
│
◇  Feishu connection test ───────────────────────────╮
│                                                    │
│  Connected as ou_afc19e87e128014e638b3c1d95b6a71f  │
│                                                    │
├────────────────────────────────────────────────────╯
│
◇  Feishu connection mode
│  WebSocket (default)
│
◇  Which Feishu domain?
│  Feishu (feishu.cn) - China
│
◇  Group chat policy
│  Open - respond in all groups (requires mention)


◇  Configure skills now? (recommended)
│  No

◇  Enable hooks?
│  Skip for now

◇  Gateway service runtime ────────────────────────────────────────────╮
│                                                                      │
│  QuickStart uses Node for the Gateway service (stable + supported).  │
│                                                                      │
├──────────────────────────────────────────────────────────────────────╯
│
◐  Installing Gateway service…
Installed systemd service: /root/.config/systemd/user/openclaw-gateway.service
◇  Gateway service installed.

◇  How do you want to hatch your bot?
│  Open the Web UI

配置完成后关键操作

1. 记录 Web UI 访问链接（格式：http://localhost:18789/#token=xxx），浏览器打开可管理机器人；
2. 若出现网关服务报错：

systemctl is-enabled unavailable: Command failed: systemctl --user is-enabled openclaw-gateway.service

执行以下命令解决：

openclaw doctor --fix
systemctl --user is-enabled openclaw-gateway.service

四、机器人上线与验证

4.1 飞书内激活机器人

在飞书客户端找到已创建的应用，发送第一条消息

机器人会返回配对提示：

OpenClaw: access not configured.
Your Feishu user id: ou_b7e32bee9a312ecb087a795e51b6314d
Pairing code: 68S47429
Ask the bot owner to approve with:
openclaw pairing approve feishu 68S47429

在部署服务器执行配对命令（替换为实际配对码）：

openclaw pairing approve feishu 68S47429

再次向飞书机器人发送消息，若收到 AI 回复即验证成功。

4.2 常见问题排查

问题现象	排查方案
配对码提交后无响应	检查网关服务是否运行：openclaw gateway status，异常则重启：openclaw gateway restart
飞书消息发送后机器人无回复	验证 Kimi API Key 有效性、飞书应用权限是否完整、网关日志是否报错：openclaw gateway logs
Web UI 无法访问	检查服务器 18789 端口是否开放，防火墙 / 安全组需放行该端口

五、技能扩展（可选）

通过 Clawhub 扩展机器人能力，以下为常用技能安装示例：

5.1 Clawhub 安装

npm i -g clawhub

5.2 常用技能安装

在skill市场找到要安装的skill，https://clawhub.ai/

# 1. 网页搜索能力（tavily-search）
clawhub install tavily-search

# 2. 文本人性化处理（humanizer）
clawhub install humanizer

# 3. 机器人自学习能力（self-improving）
clawhub install self-improving

# 4. 技能发现与推荐（find-skills）
clawhub install find-skills

5.3 第三方技能 API 配置（以 tavily-search 为例）

1. 获取 Tavily API Key：Tavily API Platform
2. 配置环境变量（二选一）：
3. 验证技能生效：在飞书向机器人发送「使用 tavily 搜索 OpenClaw 最新文档」，查看是否返回搜索结果。

# 方式1：全局 bash 环境
echo 'export TAVILY_API_KEY="你的API Key"' >> ~/.bashrc
source ~/.bashrc

# 方式2：OpenClaw 专属环境（推荐）
echo 'TAVILY_API_KEY="你的API Key"' >> ~/.openclaw/.env
source ~/.openclaw/.env

六、常用运维命令

# 网关操作
openclaw gateway start    # 启动网关
openclaw gateway stop     # 停止网关
openclaw gateway restart  # 重启网关
openclaw gateway status   # 查看网关状态

# 技能管理
openclaw skills list      # 查看已安装技能

# 机器人配对
openclaw pairing list     # 查看已授权的飞书用户
openclaw pairing revoke   # 撤销指定用户的授权

# 卸载 OpenClaw
openclaw uninstall --all --yes --non-interactive

七、部署注意事项

1. 服务器安全：建议仅放行必要端口（如 18789 用于 Web UI、飞书回调端口），避免暴露过多端口；
2. API Key 保管：所有第三方 API Key 需妥善保管，避免泄露导致资产损失；
3. 版本兼容：严格按照文档指定的 Node.js 版本安装，高版本 / 低版本可能导致 OpenClaw 运行异常；
4. 飞书应用维护：若飞书应用信息变更（如 App Secret），需重新执行 openclaw onboard 更新配置；
5. 技能扩展：部分技能需额外配置环境变量，安装后需参考技能文档完成配置才能生效。

按照以上流程操作，即可快速完成 OpenClaw + Kimi + 飞书 AI 机器人的部署，且具备灵活扩展技能的能力，满足日常办公、智能问答等场景需求。
要端口（如 18789 用于 Web UI、飞书回调端口），避免暴露过多端口；
2. API Key 保管：所有第三方 API Key 需妥善保管，避免泄露导致资产损失；
3. 版本兼容：严格按照文档指定的 Node.js 版本安装，高版本 / 低版本可能导致 OpenClaw 运行异常；
4. 飞书应用维护：若飞书应用信息变更（如 App Secret），需重新执行 openclaw onboard 更新配置；
5. 技能扩展：部分技能需额外配置环境变量，安装后需参考技能文档完成配置才能生效。

按照以上流程操作，即可快速完成 OpenClaw + Kimi + 飞书 AI 机器人的部署，且具备灵活扩展技能的能力，满足日常办公、智能问答等场景需求。