手把手教你用 OpenClaw+飞书打造专属 AI 机器人

2026-03-09 14:18:23 脚本之家

你有没有想过，在飞书里直接跟 AI 对话，就像跟同事聊天一样自然？

今天这篇文章，带你从零开始，用 OpenClaw 搭建一个飞书 AI 机器人。全程命令行操作，10 分钟搞定。

一、准备工作

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.js v22.2.1 官方安装版+绿色解压版 64位

类型：编程控件
大小：96.4MB
语言：简体中文
时间：2026-01-05

查看详情

1.2 安装 OpenClaw

进入 OpenClaw 官网 https://openclaw.ai/ ，我们通过 npm 全局安装：

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

加了 --install-daemon 后，Gateway 会作为系统守护进程自动启动（macOS 用 LaunchAgent，Linux 用 systemd），重启电脑也不会丢。如果不加，后面启动 openclaw gateway 时关掉终端机器人就断了。

GitHub 地址：https://github.com/openclaw/openclaw

二、配置 AI 模型

OpenClaw 需要接入一个大语言模型作为"大脑"。你可以使用 Anthropic、OpenAI 等官方 API，也可以通过第三方中转服务获取。

这里以 Claude Haiku 为例。Haiku 是 Anthropic 的轻量级模型，响应快、成本低，非常适合日常对话场景。如果你需要更强的推理能力，也可以换成 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 开启权限

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