OpenClaw保姆级安装与常见问题解决(MAC&WIN)

原创 2026-03-03 14:36:51 6.3k 阅读 AI写同款

刘大望

896粉丝61篇原创

关注

为什么我的OpenClaw安装后无法启动？Gateway服务故障排查全攻略 OpenClaw是一款功能强大的自动化工具，但其安装和运行依赖于多个服务组件，其中Gateway服务是核心组件之一。如果Gateway服务无法启动，整个OpenClaw系统将无法正常运行。本文将详细介绍OpenClaw安装后无法启动的常见原因及故障排查方法，帮助你快速定位并解决问题。阅读详情

AI摘要

本文详细介绍了OpenClaw在macOS和Windows系统上的保姆级安装流程，涵盖Node.js环境配置、OpenClaw CLI初始化、模型供应商（如通义千问）选择、飞书App ID/密钥申请、权限配置、事件回调设置及Brave搜索引擎API接入。重点解决Windows兼容性问题、中文路径导致网关启动失败、飞书未建立连接等高频故障，并提供Web UI验证与终端调试方法。

前言

本文章的安装适用于windows用户和 MacOS用户放心食用制作不易劳烦您点个赞＋收藏感谢

一.环境配置

如果已经安装可跳过

1.安装node.js（openclaw的运行环境）

链接

https://nodejs.org/zh-cn?spm=a2ty02.30260236.d_text_model_experience.6.58fd74a1PEO7zF

安装流程

双击安装文件
按向导提示进行安装
务必勾选 “Add to PATH” 选项（Windows 用户尤其注意）
完成安装

2.验证安装结果

打开终端（Terminal）或命令提示符（Command Prompt），依次输入以下命令：

二.OpenClaw的安装

1.打开官网

https://openclaw.ai/

2.找到以下命令并运行

打开终端运行

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

3.安装中依次选择配置如下

3.1模型供应商选择(我选的是千问)

3.2弹出登录页面并且登录

3.3回到终端依次选择如下

3.4这个选择是通过什么通信方式控制你的电脑

我使用的飞书

3.5安装飞书插件

如果是Windows的话建议先跳过（因为下载的话会报错 Windows 系统的兼容性 Bug）

执行的npm 在Windows 上，实际上执行的程序叫 npm.cmd

windows用户另外启动一个终端运行以下命令

1.安装飞书插件

npm install @openclaw/feishu

2.启动飞书插件

openclaw plugins enable feishu

3.查看插件启动情况

openclaw plugins list

3.5配置skill

也可以跳过后期都可以自行配置

3.7选择钩子

可以随便选建议选上后两个

3.8配置网关

选install或者reinstall

如果你的openclaw下载路径有中文的话比如你的用户名网关会启动失败

解决方法

win + R 输入以下命令

进入管路然后更改系统区域设置

勾选如图选项随后重启电脑

之后运行以下命令重新过一遍上述步骤

openclaw onboard

3.9成功之后进入以下web UI 界面

测试能否正常对话

4.配置飞书

4.1依次运行以下命令和选择配置

openclaw config

windows安装还是会报错(windows下的bug)

4.2正常情况下会让你输入app id和密钥

windows下如何进行接下来的配置呢？

来到web管理界面的频道可以配置

所以windows用户可以跳过

4.3申请飞书app id和密钥

进入以下链接

https://open.feishu.cn/app?lang=zh-CN

创建应用

随后一定要点击添加机器人按钮

点击左侧栏会有app id 和密钥了

来到openclawd的web管理端然后复制粘贴进去id和密钥选择以下配置然后保存

最后一步选continue

4.4开通权限

回到飞书开放平台点击批量导入

4.5导入以下权限

{
  "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"
    ]
  }
}

具体可见github 链接https://github.com/AlexAnys/openclaw-feishu