想象一下，在飞书里直接跟AI对话。 整个过程就跟找同事聊两句一样自然。这不是科幻，今天就带你亲手搭一个。

全程命令行操作，10分钟就能搞定。用到的工具叫OpenClaw，这是一个开源AI Gateway。配合飞书当聊天界面，整个过程相当丝滑。

一、准备工作

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

OpenClaw基于Node.js运行，所以先确认Node版本不低于22。推荐用nvm管理版本，不容易踩坑。

终端里直接跑这几行：

# 安装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

1.2 安装OpenClaw

装好Node.js后，用npm全局安装OpenClaw：

# 安装OpenClaw
npm i -g openclaw
# 运行引导向导（加 --install-daemon 安装守护进程，让Gateway在后台持续运行）
openclaw onboard --install-daemon

这里有个小技巧：加了--install-daemon，Gateway会作为系统守护进程自动启动。macOS用LaunchAgent，Linux用systemd。

这样即使重启电脑也不会断。如果不加这个参数，后面启动openclaw gateway时，一旦关掉终端，机器人就停了。

二、配置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配置。启动Gateway后，浏览器打开http://127.0.0.1:18789/。

点击顶部Config标签页，切换到Raw JSON编辑器，找到models.providers部分直接编辑JSON。保存后Gateway会自动热加载，无需重启。

但要注意，Dashboard的Form表单视图对自定义Provider支持有限，建议直接用Raw JSON编辑器修改。

三、创建飞书应用

3.1 进入飞书开放平台

访问https://open.feishu.cn/app。没有账号的话，用手机号注册即可。

3.2 创建企业自建应用

按以下步骤操作。四张图示意了完整流程：

创建完成后，点击发布。

3.3 记录App ID和App Secret

这两个值后面配置OpenClaw时要用到，务必保存好。

四、连接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），保持为空即可。

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

六、首次使用：授权配对

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

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 开启权限

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

6.2 授权配对

在终端执行配对命令，将你的飞书账号绑定为授权用户：

具体命令：openclaw pairing approve feishu RYXBPRNJ。将RYXBPRNJ替换为你实际收到的配对码。

要注意：每创建一个新的飞书机器人应用，都需要重新走一遍这个配对流程。

七、开始使用

一切就绪，现在可以在飞书里愉快地和AI对话了。

写在最后

整个流程总结下来就三件事：

• 装OpenClaw：npm一行命令搞定
• 建飞书应用：拿到App ID和Secret
• 连起来：配置好模型和飞书凭证，启动Gateway

动手试试吧，这应该是最快的飞书AI机器人搭建方案了。