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

一、环境配置

1、环境要求

node、npm

2、node 安装

方式一：brew 安装

brew install node

方式二：nvm 安装

brew install nvm
mkdir ~/.nvm
vim ~/.zshrc

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

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

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

source ~/.zshrc

安装node

nvm install node
nvm use node

验证

node -v
npm -v

二、安装OpenClaw

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

# 在 PowerShell 中运行
 
iwr -useb https://clawd.org.cn/install.ps1 | iex
  • 安装过程会自动下载 Node.js、依赖等，耗时几分钟。
  • 安装完成后会自动进入配置向导，或提示你继续下一步，这时候不需要管，重新打开一个管理员终端。
openclaw-cn onboard
  • 第一步通常会问是否继续 → 选择 YES。
  • 安装模式选择“快速开始”（QuickStart）
  • 模型厂家选择-选择自己使用的对应的，例如Qwen\DeepSeek...
  • 认证方式选择 API key , 根据提示输入 API KEY
  • 默认模型选择当前
  • 通道设置（Select channel）连接飞书则选择 飞书 （FeiShu），这一步可以先跳转到第三节，第1步，配置好飞书应用机器人，拿到飞书应用appid 和 appsecret 后在进行下一步。

    image

  • 配置技能选择 No
  • 启动方式选择：Open the Web UI
  • 接下来会跳转到一个网页，如果前面配置好了模型的 api key，这时候就可以正常聊天了

image

三、连接飞书

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

访问飞书开放平台

创建企业自建应用 → 选择机器人类型 → 填写基本信息 → 创建

image

 选择机器人，继续下一步

image

 输入内容（自定义）

image

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

{
  "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:contact.base:readonly",
      "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",
      "contact:contact.base:readonly",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

image

 

在「凭证与基础信息」中复制 App ID 和 App Secret。（如果是从第二步跳过来的，到这一步先返回OpenClaw的配置指引，继续配置指引操作）。

指定位置输入刚才复制的飞书机器人App ID 和 App Secret，继续下一步直到向导完成

image

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

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

image

进入「事件与回调」：

订阅方式选择 长连接订阅方式（不可选 HTTP 回调）。

添加事件：至少包含 im.message.receive_v1（接收消息）。

保存设置。

注意：事件订阅和回调配置建议在openclaw部署完成后统一在飞书后台设置，避免向导卡住。

image

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

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

 确认飞书渠道已连接：

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

image

 测试部署是否成功

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

image

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

image

四、步骤总结

1、检查环境，安装node、npm

2、安装OpenClaw（管理员终端）

3、安装好后新打开管理员终端进入入配置向导

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

五、OpenClaw 命令

启动模式分为两种：

  • 启动网关服务：gateway，OpenClaw 网关服务的相关命令，网关是系统的核心组件，负责处理消息路由、会话管理以及与外部平台（如 Telegram、WhatsApp 等）的通信。如果只是想更新网关配置或修复网关相关问题，使用 gateway 相关命令即可。
  • 启动守护线程：daemon ， OpenClaw 系统的守护进程，它不仅会重启网关服务，还可能涉及其他后台服务或组件的重启，例如任务调度器、插件管理器等。若需重载整个系统配置或排查更复杂的系统性问题，则应使用 daemon 相关命令。

1.1、（gateway）在前台启动网关服务，关闭终端窗口即停止

openclaw-cn gateway

1.2、（gateway）在后台启动网关服务

openclaw-cn gateway start

1.3、（gateway）停止后台运行的网关服务

openclaw-cn gateway stop

1.4、（gateway）重启网关服务

openclaw-cn gateway restart

1.5、（gateway）安装网关服务为系统守护进程，实现开机自启

openclaw-cn gateway instal

2.1、（daemon）安装并启动守护线程

openclaw-cn onboard --install-daemon

openclaw-cn daemon start

2.2、（daemon）重启守护进程以应用配置更改

openclaw-cn daemon restart

2.3、（daemon）查看守护进程状态

openclaw-cn daemon status

 2.4、（daemon）停止进程

openclaw-cn daemon stop

3.1、状态，查看当前配置的所有通道和状态

openclaw-cn status

3.2、诊断，【强力推荐】 自动扫描并修复不合法的配置文件

openclaw-cn doctor --fix

3.3、配置管理，想换模型、换 Key 或重新初始化时使用

openclaw onboard

六、Chrome 扩展程序

官方文档：https://docs.openclaw.ai/tools/chrome-extension

1、将扩展程序安装到稳定的本地路径：

openclaw-cn browser extension install

执行完成路径会自动复制到剪切板

image

也可以通过以下命令查看已安装扩展程序的目录路径。

2、打印已安装扩展程序的目录路径：

openclaw-cn browser extension path

3、Chrome

chrome://extensions
  • 启用“开发者模式”；
  • “加载已解压的目录” - 选择上方显示的目录；
  • 固定扩展程序。

4、更新

升级 OpenClaw 后：

  • 重新运行 openclaw-cn browser extension install 以刷新 OpenClaw 状态目录下的已安装文件。
  • Chrome - chrome://extensions → 点击扩展上的”重新加载”。

5、解释

5.1 附加/分离（工具栏按钮）

  • 打开希望 OpenClaw 控制的标签页。
  • 点击扩展图标
    • 　　附加时徽章显示 ON。
  • 再次点击以分离

5.2 它控制哪个标签？

  • 它不会自动控制你正在查看的任何标签页。
  • 它仅控制你通过点击工具栏按钮 明确附加的标签页。
  • 要切换：打开另一个标签页并在那里点击扩展图标。

5.3 徽章+常见错误

  • ON：已附加；OpenClaw 可以驱动该标签页。
  • …：正在连接到本地中继。
  • !：中继不可达（最常见：浏览器中继服务器未在此机器上运行）。

如果你看到 !：

  • 确保 Gateway 网关在本地运行（默认设置），或者如果 Gateway 网关在其他地方运行，在此机器上运行一个节点主机。
  • 打开扩展选项页面；它会显示中继是否可达。
posted @ 2026-03-06 13:21  凉年技术  阅读(277)  评论(0)    收藏  举报