新手教程机器人

手把手教你用OpenClaw+飞书从零开始打造专属AI机器人的详细实战指南

2026-06-03

阅读 0

热度 0

作者菜鸟AI编辑部

摘要

在飞书内直接与AI进行即时交互，就像和同事随口聊天一样顺畅自然——这并非概念演示，

在飞书内直接与AI进行即时交互，就像和同事随口聊天一样顺畅自然——这并非概念演示，本文将手把手带你完成部署。

全程仅需命令行操作，约10分钟即可完成。核心工具是OpenClaw，一个开源的AI网关，配合飞书作为聊天前端，整个集成体验非常流畅。

一、环境准备

1.1 安装Node.js（版本 ≥ 22）

OpenClaw基于Node.js运行，因此需确保Node版本不低于22。推荐使用nvm管理Node版本，可避免环境冲突。在终端中依次执行以下命令：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# 加载nvm（无需重启终端）
. "$HOME/.nvm/nvm.sh"
# 安装Node.js 24
nvm install 24
# 验证安装
node -v  # 应输出 v24.13.1
npm -v   # 应输出 11.8.0

Node版本确认界面

1.2 安装OpenClaw

Node.js就绪后，通过npm全局安装OpenClaw：

# 安装OpenClaw
npm i -g openclaw
# 运行引导向导（添加 --install-daemon 以安装守护进程，确保网关持续后台运行）
openclaw onboard --install-daemon

关键细节：加上--install-daemon参数后，网关将作为系统守护进程自动启动（macOS使用LaunchAgent，Linux使用systemd），即使重启机器也不会中断。若不添加此参数，在启动openclaw gateway后关闭终端，机器人便会停止运行。

OpenClaw安装完成界面

二、配置AI模型

OpenClaw需要一个LLM作为“大脑”。你可以使用Anthropic、OpenAI等官方API，也可以通过第三方中转服务。这里以Claude Haiku为例——响应速度快、成本低，足以胜任日常对话。若需更强推理能力，可替换为claude-sonnet或claude-opus。

在终端中依次执行以下配置：

# 1. 设置API地址
openclaw config set -- models.providers.my_api.baseUrl "你的API地址"
# 2. 设置API类型
openclaw config set -- models.providers.my_api.api "openai-completions"
# 3. 设置API Key
openclaw config set -- models.providers.my_api.apiKey "你的API密钥"
# 4. 设置默认模型（可按需替换其他模型）
openclaw config set -- agents.defaults.model.primary "my_api/claude-haiku-4-5-20251001"

请注意：config set与路径之间的--是两个英文半角短横线，建议手动输入键盘上的减号键两次，以避免复制粘贴导致格式错误。

若你更偏好图形化操作，可在启动网关后通过Dashboard配置：浏览器访问http://127.0.0.1:18789/，点击顶部Config标签页，切换到Raw JSON编辑器，找到models.providers部分直接编辑JSON。保存后网关会自动热加载，无需重启。需要注意的是，Dashboard的Form表单视图对自定义Provider支持有限，建议直接使用Raw JSON编辑器进行修改。

三、创建飞书应用

3.1 进入飞书开放平台

访问https://open.feishu.cn/app，若无账号使用手机号注册即可。

3.2 创建企业自建应用

按以下步骤操作（四张图展示了完整流程）：

创建应用步骤1 创建应用步骤2 创建应用步骤3 创建应用步骤4

创建完成后点击发布。

3.3 记录App ID和App Secret

这两个值后续配置OpenClaw时必不可少，请妥善保存。

App ID与Secret界面

四、连接OpenClaw与飞书

回到终端，将飞书应用的凭证写入OpenClaw配置：

# 设置飞书App ID
openclaw config set -- channels.feishu.appId "你的AppID"
# 设置飞书App Secret
openclaw config set -- channels.feishu.appSecret "你的AppSecret"
# 启动OpenClaw Gateway
openclaw gateway

新版OpenClaw已内置飞书支持，无需额外安装插件。

五、配置飞书机器人权限

回到飞书开放平台，为应用添加必要的权限和事件订阅。在「权限管理」页面，搜索im，将im相关的权限全部勾选（包括消息读取、发送、群组管理等），确保机器人能够正常收发消息。

OpenClaw使用WebSocket模式连接飞书，因此无需配置事件订阅的回调地址（Request URL），保持为空即可。

权限配置1 权限配置2 权限配置3

修改完权限后，需要重新发布一个版本：

重新发布版本

六、首次使用：授权配对

在手机飞书上给机器人发送一条消息，你会收到类似下面的提示：

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

这是OpenClaw的安全防护机制，用于防止陌生人滥用你的机器人。需要完成两步操作：

6.1 开启权限

在终端中点击提示中的链接，开启相关权限。

开启权限界面