简易教程|OpenClaw安装教程——Windows

前置准备：安装 Git、Node.js，并手动配置 Node.js 系统环境变量，避免 npm 安装报错。飞书渠道配置：在飞书开放平台创建企业自建机器人，导入指定权限 JSON，发布版本获取 App ID 与 App Secret。OpenClaw 安装：以管理员身份运行 PowerShell，执行官方安装脚本，按指引选择快速启动、飞书渠道，输入飞书凭证，采用 WebSocket 长连接完成配置。

凯凯呀~

936人浏览 · 2026-03-08 02:26:20

凯凯呀~ · 2026-03-08 02:26:20 发布

OpenClaw安装与配置教程——Windows

文章目录

OpenClaw安装与配置教程——Windows

一、安装前的准备工作

安装git并验证：
```
git -v
```
安装node.js（推荐22.22.1）并验证：
```
node -v
```
手动配置node.js的系统环境变量Path
- <node.js安装路径>\
- <node.js安装路径>\node_modules\npm
如（node.js默认安装路径）
C:\Program Files\nodejs
C:\Program Files\nodejs\node_modules\npm
这一步是为了防止后续安装时报错npm node.exe : npm error code 128

二、开通消息渠道（国内版飞书）

访问飞书开放平台，使用飞书账号登录.
点击 创建企业自建应用
在 添加应用能力 下找到 机器人 卡片点击添加

机器人配置请自己按需设置（非必须）

找到 权限管理 点击 批量导入/导出权限，粘贴以下 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: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"
    ]
  }
}

发布版本
- 在 版本管理与发布 中点击 创建版本
- 输入 应用版本号 和 更新说明 后点击保存，在弹出的确认框中点击 确认发布
- 等待管理员审批（企业自建应用通常自动通过）

OpenClaw飞书消息渠道的配置所需的App ID与App Secret在凭证与基础信息中

三、安装OpenClaw（官方）并完成配置

以管理员身份运行Windows PowerShell
- 前置操作：执行以下命令并输入Y回车
  这一步是为了防止后续安装出现各种奇奇怪怪的问题
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

执行以下官方的Windows安装命令：

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

安装完成后会自动进入配置选项：
- I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? 选择Yes
- Onboarding mode 选择QuickStart
- Model/auth provider 根据自己的实际情况配置
- Select channel (QuickStart) 选择Feishu/Lark (飞书)
- Install Feishu plugin? 选择Download from npm (@openclaw/feishu)
- How do you want to provide this App Secret? 选择Enter App Secret，然后输入开通消息渠道时的App Secret和App ID
- Feishu connection mode 选择WebSocket
- Which Feishu domain? 选择Feishu (feishu.cn) - China
- Group chat policy 选择Open
- Configure skills now? (recommended) 根据自己的实际情况配置
- Enable hooks? 根据自己的实际情况配置
- How do you want to hatch your bot? 选择Open the Web UI
配置完成后会自动启动openclaw-gateway网关服务，然后在飞书开放平台方才创建的自建应用中进行以下操作
- 在 事件与回调 中设置 事件配置 的 订阅方式 为 长连接，点击保存
- 在下方点击 添加事件，新增im.message.receive_v1（接收消息）
- 发布版本
飞书中的开发者小助手会提醒应用审批通过，点击打开应用与机器人首次对话，机器人会回复一个配对码。需要批准此代码：openclaw pairing approve feishu <配对码>

或安装完成后退出安装，执行openclaw onboard --install-daemon运行新手引导

为OpenClaw安装联网搜索的skills
- 访问OpenClaw的官方skills网站ClawHub，搜索 Tavily Web Search 和 Multi Search Engine，在OpenClaw Control WebUI的对话框让其自己安装skills，如果有配置API key，可让其一同配置。
- 修改OpenClaw的配置：在OpenClaw Control WebUI中找到配置，点击下方的 Raw，修改 tools: {} 为
```
 tools: {
    profile: 'full',
    web: {
      search: {
        enabled: false,
      },
    },
  },
```
  依次点击 save ⇒ reload
- 修改 .openclaw\workspace\TOOLS.md 添加提示词：
  
  ## Web Search
  Use the openclaw-tavily-search skill as the top-priority search tool when do web search.
  If the question requires searching for more relevant knowledge, use multi-search-engine skill as a alternative solution.
- 修改后重启网关服务：openclaw gateway restart
安装其他skills方法是一样的