在人工智能加速赋能办公场景的今天，如何让大模型真正“走进”你的工作流？OpenClaw 是一个强大的开源网关工具，能够将主流大模型与企业级应用（如飞书、Slack 等）无缝对接，实现智能对话、自动化任务处理等能力。

本文将带你从零开始，一步步完成 OpenClaw 的安装、配置，并接入飞书机器人，打造属于你自己的 AI 助手。全程图文结合，小白也能轻松上手！

🛠️ 第一步：安装 NVM（Node Version Manager）

为了更好地管理 Node.js 版本，我们首先需要安装 NVM（Node Version Manager）。

✅ Windows 用户

👉 下载地址：

1	https://github.com/coreybutler/nvm-windows/releases/download/1.2.2/nvm-setup.exe

下载后双击安装，按提示一步步完成即可。

✅ Linux / macOS 用户

打开终端，执行以下命令：

1	wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh \| bash

安装完成后，加载环境变量：

1	source ~/.bashrc

💡 验证是否安装成功：

1	nvm version

🌱 第二步：安装 Node.js（v22.22.0）

OpenClaw 要求 Node.js 版本不低于 v22，推荐使用稳定版本。

在命令行中运行：

1	nvm install v22.22.0

设置为默认版本：

1	nvm use v22.22.0

✅ 验证版本：

node -v

🚀 第三步：全局安装 OpenClaw

使用 npm 安装 OpenClaw：

1	npm i -g openclaw@latest

安装完成后，可通过以下命令查看版本确认是否成功：

1	openclaw --version

🧭 第四步：初始化配置 OpenClaw（onboard）

运行初始化命令：

1	openclaw onboard

你会看到一系列交互式配置选项，以下是推荐选择：

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

◇  Onboarding mode
   → QuickStart

◇  Model/auth provider
   → Qwen (OAuth)

随后会自动跳转至通义千问 OAuth 授权页面：

👉 打开提示中的链接（如：https://chat.qwen.ai/authorize?user_code=XXXXXX）

👉 登录并授权，输入提供的 code 完成绑定

✅ 授权成功后，系统将自动配置默认模型为 qwen-portal/coder-model

后续选项建议如下：

Select channel (QuickStart) → Skip for now
Configure skills now? → Yes（推荐）
其余 API Key 设置（如 GOOGLE_PLACES_API_KEY、GEMINI_API_KEY 等）→ 按需选择 No（可后期补充）
Enable hooks? → Skip for now

⚙️ 第五步：修改大模型上下文参数（防报错关键步骤）

某些模型在处理长文本时容易因上下文超限报错，需手动调整配置文件。

配置文件路径：

Windows 10+：打开“我的电脑” → C盘 → 在地址栏输入 %USERPROFILE%.openclaw 回车
Linux / macOS：路径为 ~/.openclaw

进入目录后，编辑 openclaw.json 文件。

🔹 修改关键参数：

找到以下字段并修改为推荐值：


"models": {
  "providers": {
    "models": [
      {
        "contextWindow": 32000,
        "maxTokens": 8192
      }
    ]
  }
}

📌 说明：

contextWindow: 上下文窗口大小，提升至 32000 支持更长对话历史
maxTokens: 单次回复最大输出 token 数，避免截断

保存文件！

🖥️ 第六步：启动 OpenClaw 控制台（Dashboard）

运行命令启动服务：

1	openclaw gateway start

首次启动后会生成 Dashboard 地址：

1	Dashboard URL: http://127.0.0.1:18789/#token=xxxxx

📌 若提示 “No GUI detected”，请通过 SSH 隧道访问：

1 2	ssh -N -L 18789:127.0.0.1:18789 用户名@你的服务器IP

然后在本地浏览器打开：

1 2	http://localhost:18789/ http://localhost:18789/#token=xxxxx

📘 官方文档参考：

🐦 第七步：配置飞书机器人（Feishu Bot）

我们要让 OpenClaw 接入飞书，实现群聊智能应答。

1️⃣ 登录飞书开放平台

访问：https://open.feishu.cn 点击【开发者后台】→【创建企业自建应用】

2️⃣ 创建应用

应用名称：openclaw-bot
应用描述：openclaw bot

点击【创建】

3️⃣ 获取凭证

进入【凭据管理】，复制保存：

App ID
App Secret

⚠️ 这两个值将用于后续配置，请务必妥善保管！

4️⃣ 添加机器人能力

点击【添加应用能力】→【按能力选择】→ 搜索并添加【机器人】

5️⃣ 配置机器人名称

名字填写：clawbot
点击【保存】

🔧 第八步：配置 OpenClaw 连接飞书

回到 .openclaw/openclaw.json 文件，添加飞书频道配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的App ID",
      "appSecret": "你的App Secret",
      "domain": "feishu",
      "groupPolicy": "open",
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

📌 参数说明：

enabled: 启用飞书通道
groupPolicy / dmPolicy: 群聊和私聊策略设为 open，表示开放接入
allowFrom: 允许所有来源（生产环境建议限制）

保存后，重启网关：

1	openclaw gateway restart

🔔 第九步：设置事件回调与权限

1️⃣ 回到飞书开放平台 → 【事件和回调】

选择【长连接模式】→【保存】

2️⃣ 添加事件

点击【添加事件】→ 搜索 im:message:re → 选择【接收消息 im:message:receive_v1】→【确认添加】

3️⃣ 开通必要权限

进入【权限管理】→【开通权限】
搜索并勾选以下权限组：
- contact:user.base:readonly（用户基础信息只读）
- im:message 相关所有权限（消息读写、发送、接收）
点击【确认开通】

🎯 第十步：发布应用，开始对话！

所有配置完成后，点击【创建版本】按钮：

输入版本号（如：1.0.0）
填写版本描述
点击【发布】

发布成功后，返回飞书客户端，你会看到「openclaw-bot」应用已上线！

🔍 在聊天窗口 @clawbot 或直接私聊，即可开始与 AI 对话。

🎉 恭喜你，已成功搭建一个基于 OpenClaw 的飞书 AI 助手！

📝 温馨提示 & 后续优化建议

✅ 推荐优化项：

后续可配置 BOOT.md 实现启动引导流程（启用 hook）
为不同技能模块添加 API Key，拓展图像生成、语音识别等功能
生产环境建议关闭 allowFrom: [“*”]，限制访问来源

🔧 常见问题排查：

机器人无响应？检查网关是否运行、端口是否开放
授权失败？确认 OAuth 是否完成，token 是否过期
消息收不到？检查飞书事件订阅和权限是否全部开通

🌟 写在最后

OpenClaw + 飞书的组合，不仅是一个技术实践，更是智能化办公的起点。你可以在此基础上扩展：

自动会议纪要生成
代码辅助编写
工单自动回复
数据查询助手

让 AI 真正成为你工作的“副驾驶”。

赶紧动手试试吧！有任何问题欢迎留言交流，我们一起打造更聪明的办公生态 💬

📌 本文参考资料：

OpenClaw 官方文档：https://docs.openclaw.ai
飞书开放平台：https://open.feishu.cn

📌 关键词标签：#OpenClaw教程 #飞书机器人 #AI办公自动化 #大模型接入 #Qwen #Nodejs #开发者指南