乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > 【人工智能】|OpenClaw 安装指南(Windows 版)

【人工智能】|OpenClaw 安装指南(Windows 版)

当前时间： 1970-01-01 08:00:00 分类：办公文件 评论(0)
【人工智能】|OpenClaw 安装指南(Windows 版)

OpenClaw 安装指南（Windows 版）

💡安装准备

系统要求

  • Windows 10 或 Windows 11（64位）

  • 能访问 GitHub 的网络环境

    •  ⚠️安全小提示

  • 建议在备用机或干净的电脑上安装运行。

    第一步：安装 Node.js

    Node.js 是 OpenClaw 的运行环境，装一次就够了。

    ⚠️ OpenClaw 要求 Node.js 22 或以上，低于这个版本会安装失败。

    先检查有没有装过

    在系统搜索栏搜索 PowerShell打开，输入：

    node-v

    • 看到 v22.x.x 或更高 → 已满足要求，直接跳到第二步

    • 看到 v20.x.x 或更低 → 版本太旧，需要重新安装

    • 提示"找不到命令" → 还没装过，继续往下

官网下载安装包

打开这个链接：👉 https://nodejs.org/zh-cn/download

下载 Windows 安装程序（.msi 文件），然后：

  1. 双击打开安装包

  2. 勾选同意协议

  3. 一路点击 Next

  4. 点击 Install，等待进度条走完

  5. 点击 Finish

✅ Node.js 安装完成。

第二步：安装 Git

Git 是 OpenClaw 安装脚本拉取依赖时需要用到的工具，无版本硬性要求，装最新版就行。

先检查有没有装过

在 PowerShell 里输入：

git--version
  • 看到 git version 2.x.x → 已安装，直接跳到第三步
  • 提示"找不到命令" → 还没装过，继续往下
官网下载安装包
打开这个链接：👉 https://git-scm.com/install/windows
下载 Windows 安装程序，然后：
  1. 双击打开安装包
  2. 一路点击 Next（所有选项保持默认）
  3. 点击 Install，等待进度条走完
  4. 点击 Finish
✅ Git 安装完成。
第三步：安装 OpenClaw
  1. 准备安装
在系统搜索栏搜索 PowerShell，右键选择 以管理员身份运行
在蓝色窗口里依次输入以下两条命令，每输完一条就按回车：
第一条：
Set-ExecutionPolicy-ExecutionPolicyRemoteSigned-ScopeCurrentUser
如果出现询问，输入 Y 然后回车。
第二条：
iwr-usebhttps://openclaw.ai/install.ps1|iex
等待安装过程，大约需要2-10分钟，速度取决于网络。
  1. 跟着向导操作
用键盘上下箭头选择，回车确认：
步骤看到的问题推荐选择说明截图
1安全警告Yes了解风险，继续安装
2安装模式QuickStart快速开始，适合新手
3选择 AI 模型 + 输入 API Key/如没有 API Key 的话，后续就没办法跟 AI 对话
💡后续我们会出一份 API Key 对比文档，帮大家找最划算的选择，也欢迎铁铁们来补充～
6选择聊天渠道feishu可以先直接设置飞书，如不选可跳过
6.1是否安装飞书插件Download from npm (@openclaw/feishu)
6.2提供APP Secret和APP ID提供相应信息进入飞书应用中心：开发者后台 - 飞书开放平台使用飞书账号登录。Lark（国际版）请使用 
https://open.larksuite.com/app，并在配置中设置 domain: "lark"。创建自建应用创建版本更新应用 Token回到 凭证与基础信息 页面，将App ID / App Secret 同步更新到 OpenClaw 配置中。
6.3连接方式WebSocket默认就行，不用改
6.4群聊响应策略OpenAllowlist（当前选中） 只在你指定的特定群里响应Open 在所有群都会响应，但需要有人 @ 它才触发Disabled 完全不在群里响应，只处理私聊
7联网搜索Skip for now需要额外的API Key，可先跳过
8配置技能Yes/No只想先跑通基础聊天先选 No，后续可以随时安装
9hooks（自动化功能）全选安装都是非常实用的技能
到这里，程序会自动启动网关，屏幕上会弹出一个新的命令窗口。⚠️ 原先的 PowerShell 窗口和新弹出的窗口都不要关，回到最开始的 PowerShell 窗口继续操作。
10启动方式Web UI网页图形界面会更加直观和操作友好一些
回车后会提示有网页自动打开，进入 http://127.0.0.1:18789/。
  1. 发送消息
在聊天界面发一条消息，收到小龙虾的回复，说明配置完成 🎉
后续打通飞书，在飞书上使用机器人的操作步骤
  1. 配置应用权限
进入飞书应用中心：开发者后台 - 飞书开放平台
在刚才已有机器人的权限管理页面，点击批量导入按钮，粘贴以下 JSON 配置一键导入所需权限。
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
    ],
"user": [
"contact:user.employee_id:readonly",
"offline_access","base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
    ]
  }
}
  1. 设置事件回调（Callback）
⚠️ 重要提醒：在配置事件订阅前，请务必确保已完成以下步骤：
  1. 运行 openclaw channels add 添加了 Feishu 渠道
  2. 网关处于启动状态（可通过 openclaw gateway status 检查状态）
    1.  在 事件订阅页面：
  3. 选择 使用长连接接收事件（WebSocket 模式）
    1. ⚠️ 注意：如果网关未启动或渠道未添加，长连接设置将保存失败。
  1. 添加事件：im.message.receive_v1（接收消息）
  1. 发布应用
  1. 创建新版本
  1. 提交审核并发布 
  2. 等待管理员审批（企业自建应用通常自动通过）
  1. 发送测试消息
审批通过后，在飞书中搜索我们刚创建好的机器人的名字，发送一条消息。
  1. 配对授权
默认情况下，机器人会回复一个配对码。你需要批准此代码（此时已经可以在 WebUI 中直接和🦞对话，让它帮忙完成这步）：
openclaw pairing approve feishu <配对码>
批准后即可正常对话啦！
教程来源：秋芝2046