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

复制代码