准备

• Ubuntu系统(带桌面)
• Nodejs 22 +

开始安装
1、运行命令
首先设置npm镜像源，可以选择阿里、清华等，我这里以阿里为例

npm config set registry https://registry.npmmirror.com

npm install -g openclaw@latest

时间会比较久，等候安装即可
2、引导安装

openclaw onboard --install-daemon

这里选择本地基于vLLM

API key也是根据自己实际情况填写，随后填写模型名称

默认选择

~/.openclaw/openclaw.json

TIPS
在安装Feishu时，提示：

进入：

/home/will/.openclaw/extensions/feishu

修改package.json，将devDependencies中的workspace* 删除，删除后如下：

使用查看飞书是否安装完成

openclaw plugins list

配置appid和密钥

发送测试消息
默认情况下，机器人会回复一个 配对码。您需要批准此代码：

openclaw pairing approve feishu <配对码>

将上述信息填写进服务器即可

申请飞书机器人

第一步：创建飞书应用

1. 打开飞书开放平台

访问 飞书开放平台，使用飞书账号登录。

2. 创建应用

1. 点击 创建企业自建应用
2. 填写应用名称和描述

3. 选择应用图标

   
   

3. 获取应用凭证

在应用的 凭证与基础信息 页面，复制：

• App ID（格式如 cli_xxx）

• App Secret
  ❗ 重要：请妥善保管 App Secret，不要分享给他人。

  
  

4. 配置应用权限

在 权限管理 页面，点击 批量导入 按钮，粘贴以下 JSON 配置一键导入所需权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

5. 启用机器人能力

在 应用能力 > 机器人 页面：

• 开启机器人能力

• 配置机器人名称

  
  

6. 配置事件订阅

⚠️ 重要提醒：在配置事件订阅前，请务必确保已完成以下步骤：

1. 运行 openclaw channels add 添加了 Feishu 渠道

2. 网关处于启动状态（可通过 openclaw gateway status 检查状态）
   在 事件订阅 页面：
   选择 使用长连接接收事件（WebSocket 模式）
   添加事件：im.message.receive_v1（接收消息）
   ⚠️ 注意：如果网关未启动或渠道未添加，长连接设置将保存失败。
   

3. 发布应用

• 在 版本管理与发布 页面创建版本
• 提交审核并发布
• 等待管理员审批（企业自建应用通常自动通过）

手机或PC下载飞书，测试使用

配置使用浏览器插件

下载并安装chrome浏览器

选择插件

选择第一个

ok

openclaw browser extension install

2.打印已安装扩展的目录路径：

openclaw browser extension path

3.开启chrome插件

on

4.开启openclaw与浏览器的连接

openclaw browser --browser-profile openclaw start

5.查看是否已经在运行

openclaw browser --browser-profile openclaw status

必须是running为true才算配置完成

headline