OpenClaw 智能体本地部署和使用并与飞书连接

一、环境配置

1、环境要求

node、npm
2、node 安装

方式一：brew 安装

1. brew install node

复制代码

方式二：nvm 安装

1. brew install nvm
2. mkdir ~/.nvm

复制代码

1. vim ~/.zshrc

复制代码

在里面添加，按i，到最后一行添加

1. export NVM_DIR="$HOME/.nvm"
2. source $(brew --prefix nvm)/nvm.sh

复制代码

添加完成，按esc，shift+：，输入wq，按enter

1. source ~/.zshrc

复制代码

安装node

1. nvm install node
2. nvm use node

复制代码

验证

1. node -v
2. npm -v

复制代码

二、安装OpenClaw

打开管理员终端执行以下命令一键安装

1. # 在 PowerShell 中运行
3. iwr -useb https://clawd.org.cn/install.ps1 | iex

复制代码

• 安装过程会自动下载 Node.js、依赖等，耗时几分钟。
  
• 安装完成后会自动进入配置向导，或提示你继续下一步，这时候不需要管，重新打开一个管理员终端。
  

1. openclaw-cn onboard

复制代码

• 第一步通常会问是否继续 → 选择 YES。
  
• 安装模式选择“快速开始”（QuickStart）
  
• 模型厂家选择-选择自己使用的对应的，例如Qwen\DeepSeek...
  
• 认证方式选择 API key , 根据提示输入 API KEY
  
• 默认模型选择当前
  
• 通道设置（Select channel）连接飞书则选择 飞书 （FeiShu），这一步可以先跳转到第三节，第1步，配置好飞书应用机器人，拿到飞书应用appid 和 appsecret 后在进行下一步。
  
  
  
• 配置技能选择 No
  
• 启动方式选择：Open the Web UI
  
• 接下来会跳转到一个网页，如果前面配置好了模型的 api key，这时候就可以正常聊天了
  

 三、连接飞书

1、飞书开放平台新建机器人应用

访问飞书开放平台
创建企业自建应用 → 选择机器人类型 → 填写基本信息 → 创建

 选择机器人，继续下一步

 输入内容（自定义）

 在权限管理/批量导入/导出权限中清空原有权限，粘贴复制下方内容

1. {
2.   "scopes": {
3.     "tenant": [
4.       "aily:file:read",
5.       "aily:file:write",
6.       "application:application.app_message_stats.overview:readonly",
7.       "application:application:self_manage",
8.       "application:bot.menu:write",
9.       "cardkit:card:write",
10.       "contact:contact.base:readonly",
11.       "contact:user.employee_id:readonly",
12.       "corehr:file:download",
13.       "docs:document.content:read",
14.       "event:ip_list",
15.       "im:chat",
16.       "im:chat.access_event.bot_p2p_chat:read",
17.       "im:chat.members:bot_access",
18.       "im:message",
19.       "im:message.group_at_msg:readonly",
20.       "im:message.group_msg",
21.       "im:message.p2p_msg:readonly",
22.       "im:message:readonly",
23.       "im:message:send_as_bot",
24.       "im:resource",
25.       "sheets:spreadsheet",
26.       "wiki:wiki:readonly"
27.     ],
28.     "user": [
29.       "aily:file:read",
30.       "aily:file:write",
31.       "contact:contact.base:readonly",
32.       "im:chat.access_event.bot_p2p_chat:read"
33.     ]
34.   }
35. }

复制代码

 
在「凭证与基础信息」中复制 App ID 和 App Secret。（如果是从第二步跳过来的，到这一步先返回OpenClaw的配置指引，继续配置指引操作）。
指定位置输入刚才复制的飞书机器人App ID 和 App Secret，继续下一步直到向导完成

 配置完成后，启动 OpenClaw 的网关（负责 WebSocket  长连接）：

1. openclaw-cn gateway

复制代码

• 看到类似 “Listening on http://127.0.0.1:18789” 或 “Gateway ready” 即启动成功。
  
• 保持这个窗口运行（或用 nohup / pm2 后台运行）。
  

进入「事件与回调」：
订阅方式选择 长连接订阅方式（不可选 HTTP 回调）。
添加事件：至少包含 im.message.receive_v1（接收消息）。
保存设置。
注意：事件订阅和回调配置建议在openclaw部署完成后统一在飞书后台设置，避免向导卡住。

2、访问管理后台并验证连接

浏览器打开命令中提示的网址，或者运行OpenClaw 后自动打开的网页（通常是 http://127.0.0.1:18789 或 http://localhost:18789，可能带 token 参数）。
 确认飞书渠道已连接：

• 检查事件订阅是否为 长连接模式。
  
• 确认已添加的事件列表完整。
  

 测试部署是否成功

• 将机器人拉入飞书群或私聊。
  
• 发送消息（如 @机器人 你好）。
  
• 如果机器人正常回复（可能简单问候或调用百炼模型生成回答），则部署成功！
  

 如果有问题检查管理后台的通道里飞书配置是否准确

 四、步骤总结

1、检查环境，安装node、npm
2、安装OpenClaw（管理员终端）
3、安装好后新打开管理员终端进入入配置向导

• 第一步通常会问是否继续 → 选择 YES。
  
• 安装模式选择“快速开始”（QuickStart）
  
• 模型厂家选择-选择自己使用的对应的，例如Qwen\DeepSeek...
  
• 认证方式选择 API key , 根据提示输入  API KEY
  
• 默认模型选择当前
  
• 前往飞书开放平台新建飞书机器人应用，获取飞书应用 appid 和 appsecret
  
• 回到向导输入飞书 appid 和 appsecret，进行下一步，安装飞书插件或者使用本地飞书插件，连接方式选择长连接模式（WebSocket）
  
• 配置技能选择No
  
• 网关启动如果有重新安装则选择重新安装，否则选择重启选项
  
• 启动后会自动跳转到OpenClawa网页管理后台，这时候可以在网页进行AI对话
  
• 回到飞书开放平台，配置权限管理、进行事件配置
  
• 验证飞书连接
  

五、OpenClaw 命令

1、启动

1. openclaw-cn gateway

复制代码

 

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！