当前位置：首页 > news >正文

OpenClaw本地部署及接入飞书

news 2026/5/11 22:43:01

前置准备

一台windows电脑，避免使用工作电脑，以防openclaw误执行危险操作
下载安装git：https://git-scm.com/
下载安装nodejs：https://nodejs.org/zh-cn/download
一个可用的大模型API KEY（可用千问https://bailian.console.aliyun.com/或智谱https://bigmodel.cn/console/overview的免费大模型，前往官网注册获取）
- 千问
- 智谱

部署命令

下载及编译

完成git和nodejs安装后（并配置好git和nodejs环境变量），参考官方github说明打开git bash或powershell执行如下命令进行编译，官方github地址https://github.com/openclaw/openclaw

git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # auto-installs UI deps on first run pnpm build

配置环境变量

在windows powershell中，遇到openclaw不是系统命令，需要将路径“C:\Users\你的用户名\AppData\Roaming\npm”配置到环境变量path中

快速配置并运行

接着上一步的编译命令，执行以下命令进行安装（参考知乎博主https://zhuanlan.zhihu.com/p/2002381750245037060）

pnpm openclaw onboard --install-daemon

就能看到安装页面了：

这里需要选择 Yes，才能继续安装，意思是你清楚它的强大且危险不，安装方式选择 QuickStart：

然后会让你选择，选择什么大模型的 API，支持 OpenAI、Anthropic、MiniMax、Qwen 等主流 API，这里我选择了Qwen以及Z.AI(智谱)，选择不同的模型API，会有不同的后续配置提示，会需要键入前置准备中申请的API KEY：

模型API配置完成，接着Select Channel 的意思是，选择什么对话工具，我们可以先 Skip for now 跳过，后面再配置。

然后让你安装 skill，这些技能也可以选择先不安装，后面用到的时候，会自行安装，所以也可以选择 Skip for now 跳过。

然后就是 Google、Gemini、OpenAI 的API，都可以选择 No，不设置。

然后会看到是否启动 hooks，这里可以把这 3 个都选上，启动下。

至此，初步安装就完成了，然后选择启动web ui即可进入openclaw的对话页面

接入飞书

飞书应用准备

访问飞书开发者平台（https://open.feishu.cn/app?lang=zh-CN）

创建企业自建应用

登录飞书，点击“创建企业自建应用”，填写应用信息，点击 “创建”。

字段名称	示例值
应用名称	“小龙虾机器人”
应用描述	“我是接入openclaw的智能助手”
应用图标	任意选择即可

添加机器人能力

在应用管理页左侧导航栏，找到并点击 “添加应用能力”，在弹出的列表中选择 “机器人”，点击 “添加”。

获取飞书应用凭证

在飞书应用管理页，左侧导航栏找到 “凭据与基础信息” 栏目，点击进入；

在页面中找到 “App ID” 和 “App Secret” 两个参数，分别点击右侧 “复制” 按钮，按照个人需求将其保存到记事本或备忘录中。

添加飞书channel配置

1、返回openclaw终端输入下方命令，安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

2、等待安装完成，再输入以下命令，添加飞书

openclaw channels add

3、选择“Yes”以及“飞书”，按Enter确认

4、输入上一步获取的App ID 和 App Secret

5、选择国内飞书（Feishu (feishu.cn) - China），以及不要在群内响应，按Enter

6、最后点击“Finished”完成添加飞书

7、其他可选项都选择“No”，后续按需求再配置

8、在终端启动网关，运行下方命令：

penclaw gateway restart

飞书机器人配置

1、事件配置

在飞书应用管理页，左侧导航栏找到 “事件与回调” 栏目，点击进入；点击订阅方式，选择“长连接”，点击保存。

2、添加事件

点击页面中的 “添加事件”，在弹出的事件列表中，选择 “消息与群组” 分类，勾选 “接收消息”，点击 “确定”，完成事件订阅。

3、权限配置

在飞书应用管理页，左侧导航栏找到 “权限管理” 栏目，点击进入。点击页面中的 “批量/导入权限” 按钮，弹出权限导入窗口，输入以下json命令：

{ "scopes": { "tenant": [ "contact:user.base:readonly", "im:chat", "im:chat:read", "im:chat:update", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:send_as_bot", "im:resource", "contact:contact.base:readonly" ], "user": [] } }

点击“确定”开通权限