【OpenClaw】OpenClaw 在windows下的安装及飞书的接入

一、openclaw安装

openclaw官网：https://docs.openclaw.ai/zh-CN

(一)、windows下安装

1.安装 Node.js

1.访问 Node.js 官网：https://nodejs.org/zh-cn/download

2.下载 LTS 版本（长期支持版）的 Windows 安装包

3.双击安装，一路 Next 即可

验证安装：打开命令行（Win + R，输入 cmd），执行：

shell 复制代码

node -v

显示版本号即安装成功。

2.安装 Git

OpenClaw 的部分功能依赖 Git，需要提前安装。

1.访问 Git 官网：https://git-scm.com/install/windows

2.点击下载最新版本

3.双击安装，一路 Next 即可（保持默认选项）

3.配置 PowerShell 脚本执行权限

Windows 默认会拦截安装脚本，需要先放开权限。

1：以管理员身份打开 PowerShell

右键点击「开始」菜单 → 选择「Windows PowerShell (管理员)」

2：查看当前权限

shell 复制代码

Get-ExecutionPolicy -List

如果 CurrentUser 显示 Restricted，说明不允许运行脚本。

3：修改权限

shell 复制代码

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

RemoteSigned 的意思是：本地脚本可以运行，从网上下载的脚本需要有签名。

4.准备 MiniMax API Key（推荐国产模型）

1.访问 MiniMax 开放平台：https://platform.minimaxi.com/

2.注册/登录账号

3.进入「用户中心」→「接口密钥」→ 创建新的 API Key

4.复制 API Key 备用

5.安装openclaw

1.打开 OpenClaw 官网：https://openclaw.ai/

2.复制 Windows 安装命令

3.打开 PowerShell，粘贴以下命令并回车：

shell 复制代码

iwr -useb https://openclaw.ai/install.ps1 | iex

4.完成初始化并启动 Gateway

按提示完成后续配置后，执行以下命令启动 Gateway：

shell 复制代码

openclaw gateway

启动成功后，会提示本地访问地址（默认 http://localhost:18789）。

5.启动 Dashboard 并获取 Token

新开一个 PowerShell 窗口（保持 Gateway 窗口运行），执行：

shell 复制代码

openclaw dashboard --no-open

如果页面显示 health ok，说明连接成功了！

二、飞书接入

飞书是国内使用 OpenClaw 的最佳聊天工具选择，配置完成后可以用手机随时给 AI 下达指令。

1.创建飞书应用

步骤 1：打开飞书开放平台

https://open.feishu.cn/app

步骤 2：创建企业应用

点击「创建企业自建应用」
填写应用名称（如：OpenClaw Bot）
填写应用描述

步骤 3：添加机器人能力

左侧菜单点击「添加应用能力」
选择「机器人」

步骤 4：配置权限

左侧菜单 →「权限管理」→「添加权限」，搜索并添加以下权限：

权限名称	权限标识
获取与上传图片或文件资源	im:resource
获取用户基本信息	contact:user.base:readonly
获取群组信息	im:chat:readonly
获取与发送单聊、群组消息	im:message
接收群聊中@机器人消息事件	im:message.group_at_msg:readonly
获取群组中所有消息（敏感权限）	im:message.group_msg
读取用户发给机器人的单聊消息	im:message.p2p_msg:readonly
查看消息表情回复	im:message.reactions:read
获取单聊、群组消息	im:message:readonly
以应用的身份发消息	im:message:send_as_bot
更新消息	im:message:update

或者直接导入如下权限

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：获取凭证

左侧菜单 →「凭证与基础信息」，复制以下信息备用：

App ID

App Secret

步骤 6：第一次发布

左侧菜单 →「版本管理与发布」：

填写版本号（如：1.0.0）

点击「创建版本」

提交发布

2.在 OpenClaw 中配置飞书

打开 PowerShell，依次执行以下命令：

第 1 步：安装飞书插件

shell 复制代码

openclaw plugins install @m1heng-clawd/feishu

注：新版本自带openclaw插件，不需要额外安装

列出所有插件指令

复制代码

openclaw plugins list

第 2 步：配置飞书参数

shell 复制代码

# 设置连接模式为 websocket
openclaw config set channels.feishu.connectionMode websocket

# 配置 App ID（替换为你自己的）
openclaw config set channels.feishu.appId "你的App ID"

# 配置 App Secret（替换为你自己的）
openclaw config set channels.feishu.appSecret "你的App Secret"

# 启用飞书通道
openclaw config set channels.feishu.enabled true

第 3 步：重启 OpenClaw

shell 复制代码

openclaw gateway stop
openclaw gateway

3.回到飞书配置事件订阅 + 第二次发布

步骤 1：配置事件订阅

回到飞书开放平台，左侧菜单 →「事件与回调」：

点击「配置订阅方式」，选择「使用长连接接收事件」

点击铅笔图标 →「添加事件」→ 勾选「接收消息 v2.0」

步骤 2：第二次发布

左侧菜单 →「版本管理与发布」：

点击顶部「创建版本」

填写新版本号（如：1.0.1）

提交发布

4.测试飞书机器人

打开飞书手机 APP

搜索「开发者助手」或直接搜索你创建的应用名称

点击「打开应用」

发送「你好」测试

如果收到回复，说明配置成功!

三、常用命令

命令	功能
openclaw onboard	初始化配置向导
openclaw gateway	启动主程序（Gateway）
openclaw gateway stop	停止主程序
openclaw tui	打开终端对话界面
openclaw dashboard	打开网页版控制台
openclaw dashboard --no-open	启动控制台但不自动打开浏览器
openclaw channels login	重新登录聊天通道
openclaw channels logout	退出聊天通道
openclaw config	进入配置菜单
openclaw plugins install <插件名>	安装插件