OpenClaw！安装教程

作者：generallizhong
概述

⚠️ 小贴士：在开始之前，有一个非常重要的提醒：由于此类工具涉及自动化操作和环境配置，如果你的电脑存有重要的商业/资产或个人隐私信息，强烈建议弄一台干净的备用设备，或者直接租用一个云端虚拟机（VPS）来运行。 这样既能保护隐私，也能避免环境冲突。

最近 OpenClaw 热度很高，但官方对 Windows 原生环境并不算友好，很多人会卡在 Node 环境、权限、路径、插件安装等问题上。下面我把自己完整跑通的流程整理成一篇“照做就能成”的教程：从环境准备 → OpenClaw 安装 → 初始化配置 → 接入飞书机器人，最后再补一份常用排错命令。
一、环境准备

1）安装 nvm for Windows（建议用最新版）

Windows 用户到 GitHub Releases 下载 nvm-setup.exe：https://github.com/coreybutler/nvm-windows/releases

安装过程一路 Next 即可。安装成功后建议你用 管理员权限打开 PowerShell：

按 Win 键 + S
搜索 PowerShell
鼠标右键 → 以管理员身份运行

2）安装 node.js 22.22.0 版本

按照顺序分别在 powershell 中运行下列指令。
代码语言：PowerShell
AI代码解释

1. # 安装指令
2. nvm install 22
4. # 使用指令
5. nvm use 22.22.0

复制代码

成功后会看到类似提示：Now using node v22.22.0

如果你仍然下载失败，或者公司网络拦截了下载，也可以手动去官网下载安装：https://nodejs.org/zh-cn/download

二、安装 + 配置 OpenClaw

1）一键安装（PowerShell）

在 管理员 PowerShell 中运行：
代码语言：PowerShell
自动换行
AI代码解释

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

复制代码

如果遇到执行策略报错（常见于首次运行脚本），在 PowerShell 输入：
代码语言：PowerShell

2）初始化配置

安装完成后通常会自动进入配置流程。
如果你不小心关闭了 PowerShell，重新打开后执行：
代码语言：PowerShel

1. openclaw onboard --flow quickstart

复制代码

第一个风险提示：

I understand this is powerful and inherently risky. Continue?

选择 Yes。

如果有小伙伴遇到这个问题：系统不知道它被安装在哪里了。处理方式通常很简单：

关闭当前 PowerShell
重新用管理员方式打开 PowerShell
一般 nvm/环境变量会自动刷新路径，问题即可消失

之后按提示选择模型。我这里示例用的是 Kimi，你也可以按自己习惯选择。

可以看下配置，主要输入API key，其他都可以默认。

接着配置通讯工具，虽然官方这里直接可以选飞书，但官方文档明确建议 Windows 通过 WSL2 运行，并且提到原生 Windows 未测试、更容易出问题。并且我实测这里下载插件会报错，所以我们这里先跳过，后续再安装。

skill也先跳过，后续咱们在使用过程中根据自己的工作流慢慢迭代自己的skill。

安装启动网关后，它会自动新开一个 PowerShell 窗口，都不要关闭。

浏览器会自动打开控制台。后续你也可以直接访问：http://127.0.0.1:18789/

发消息测试，有回复就说明安装成功：

三、配置连接飞书

整体思路是两步：

在 OpenClaw 里安装飞书插件
在飞书开放平台创建应用 → 配权限/事件 → 发布版本 → 回到 OpenClaw 填 AppID/Secret

1）安装飞书插件

你可以在控制台里让它帮你执行安装命令：
代码语言：PowerShell
自动换行
AI代码解释

1. openclaw plugins install @m1heng-clawd/feishu

复制代码

插件安装可能要等一会儿，这段时间你可以去飞书开放平台把应用先建好。

2）飞书开放平台创建应用

进入飞书开放平台：https://open.feishu.cn/，创建一个应用，并添加机器人应用能力。

然后把 App ID 和 App Secret 复制出来备用：

把这两项提供给 OpenClaw ，让它完成配置：

3）事件订阅
进入「事件与回调」页面：

「事件配置」→「订阅方式」
选择：使用长连接接收事件
保存

如果提示“没有建立长连接”：

先别慌，通常等 1～2 分钟再点保存就好
如果等很久仍不行，优先检查 OpenClaw 网关是否正常运行，并查看日志（下面第四部分给了命令）

4）添加接收消息事件

在「事件配置」页面点击「添加事件」，搜索并添加：

im.message.receive_v1

不添加这个事件，机器人就无法收到你的消息。

6）发布版本

进入「版本管理与发布」：

创建版本
发布

只有发布后，前面的配置才会真正生效。

然后在飞书里找到你刚创建的机器人，发送一条消息，它会自动回复一个配对码

复制这个配对码，打开 Clawdbot 的 Web UI（就是前面那个控制台），把配对码发给它，Clawdbot 会自动完成绑定。

绑定成功后，你就可以在飞书里跟 Clawdbot 愉快交流了，也可以把机器人拉到公司群里，让所有小伙伴都能用。
四、常用命令（排查/修复必备）

下面这些命令非常实用：配置过程中遇到卡死、插件异常、网关没起等问题，优先用它们自查。
展开
代码语言：PowerShell

基础命令

1. # 启动网关
2. openclaw gateway start
4. # 重启网关（刷新机器人状态）
5. openclaw gateway restart
7. # 重置/更改 API 等配置
8. openclaw config
10. # 诊断检查
11. openclaw doctor
13. # 实时查看日志（强烈推荐：出 bug 基本都靠它定位）
14. openclaw logs follow

复制代码

这就是整个安装和配置流程。
常用命令

OpenClaw 常用命令如下：

命令	作用	备注 / 参数
openclaw status	查看 Gateway 当前运行状态	包含健康度与上下文信息
openclaw health	健康检查	检测 core、依赖与运行环境
openclaw doctor	综合诊断与修复建议	支持 --deep 深度检查
openclaw onboard	交互式初始化向导	首次使用推荐
openclaw onboard --install-daemon	安装系统守护进程	后台常驻运行 Gateway
openclaw onboard --uninstall-daemon	卸载守护进程	不删除数据
openclaw configure	交互式配置向导	模型、通道、凭据等
openclaw config get <path>	获取配置值	JSON Path
openclaw config set <path> <value>	设置配置项	支持 JSON5 / raw 文本
openclaw config unset <path>	清除配置项	移除单个键值
openclaw channels list	列出已登录通道	WhatsApp / Telegram / Discord 等
openclaw channels login	登录新的通道账号	扫码或授权流程
openclaw channels add	添加通道	Telegram / Discord / Slack
openclaw channels status --probe	通道健康检查	检测连接可达性
openclaw skills list	列出技能	已安装 / 可用技能
openclaw skills info <skill>	技能详情	参数、版本信息
clawhub install <slug>	从 ClawHub 安装技能	官方技能市场
openclaw hooks list	列出 Hook 列表	事件钩子机制
openclaw plugins list	列出插件	查看已安装插件
openclaw plugins install <id>	安装插件	例如 @openclaw/voice-call
openclaw plugins enable <id>	启用插件	通常需要重启 Gateway
openclaw models list	列出可用模型	包含鉴权状态
openclaw models status	模型状态	当前可用性
openclaw models auth setup-token	模型鉴权配置	Cheatsheet 推荐方式
openclaw memory search "X"	搜索长期记忆	向量搜索
openclaw memory index	重建记忆索引	修复 memory 异常
openclaw logs	查看日志	默认聚合输出
openclaw logs --follow	实时日志	--json / --plain / --limit
openclaw gateway install	安装 Gateway 系统服务	注册为系统守护进程
openclaw gateway start	启动 Gateway 服务	system service 模式
openclaw gateway stop	停止 Gateway 服务
openclaw gateway restart	重启 Gateway 服务	配置变更后使用
openclaw gateway status	Gateway 系统服务状态	不同于 openclaw status
openclaw browser start	启动浏览器代理	Automation 能力
openclaw browser screenshot	网页截图
openclaw subagents list	列出子代理
openclaw cron list	列出定时任务
openclaw cron run <id>	执行定时任务
openclaw uninstall	卸载 Gateway 服务及数据	官方推荐
openclaw uninstall --all --yes --non-interactive	全自动卸载	状态 / workspace / 插件
openclaw uninstall --state	删除状态文件	不删除 workspace
openclaw uninstall --workspace	删除工作区	agent / workspace 数据
openclaw uninstall --service	仅卸载系统服务	不删除数据
openclaw uninstall --dry-run	模拟卸载	仅展示结果

原文地址：https://blog.csdn.net/generallizhong/article/details/158696488