AI创想

标题: OpenClaw！安装教程 [打印本页]
作者: 米落枫    时间: 昨天 21:52
标题: OpenClaw！安装教程
作者：generallizhong
概述

⚠️ 小贴士：在开始之前，有一个非常重要的提醒：由于此类工具涉及自动化操作和环境配置，如果你的电脑存有重要的商业/资产或个人隐私信息，强烈建议弄一台干净的备用设备，或者直接租用一个云端虚拟机（VPS）来运行。 这样既能保护隐私，也能避免环境冲突。
最近 OpenClaw 热度很高，但官方对 Windows 原生环境并不算友好，很多人会卡在 Node 环境、权限、路径、插件安装等问题上。下面我把自己完整跑通的流程整理成一篇“照做就能成”的教程：从环境准备 → OpenClaw 安装 → 初始化配置 → 接入飞书机器人，最后再补一份常用排错命令。
一、环境准备

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

Windows 用户到 GitHub Releases 下载 nvm-setup.exe：https://github.com/coreybutler/nvm-windows/releases
(, 下载次数: 0)


安装过程一路 Next 即可。安装成功后建议你用 管理员权限打开 PowerShell：
(, 下载次数: 0)


2）安装 node.js 22.22.0 版本

按照顺序分别在 powershell 中运行下列指令。
代码语言：PowerShell
AI代码解释
  1. # 安装指令
  2. nvm install 22
  4. # 使用指令
  5. nvm use 22.22.0
复制代码
(, 下载次数: 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
(, 下载次数: 0)


2）初始化配置

安装完成后通常会自动进入配置流程。
如果你不小心关闭了 PowerShell，重新打开后执行：
代码语言：PowerShel
  1. openclaw onboard --flow quickstart
复制代码
第一个风险提示：
I understand this is powerful and inherently risky. Continue?
选择 Yes。
(, 下载次数: 0)


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

(, 下载次数: 0)


之后按提示选择模型。我这里示例用的是 Kimi，你也可以按自己习惯选择。
(, 下载次数: 0)


可以看下配置，主要输入API key，其他都可以默认。
(, 下载次数: 0)


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


skill也先跳过，后续咱们在使用过程中根据自己的工作流慢慢迭代自己的skill。
(, 下载次数: 0)


安装启动网关后，它会自动新开一个 PowerShell 窗口，都不要关闭。
(, 下载次数: 0)


(, 下载次数: 0)


浏览器会自动打开控制台。后续你也可以直接访问：http://127.0.0.1:18789/
(, 下载次数: 0)


发消息测试，有回复就说明安装成功：
(, 下载次数: 0)


三、配置连接飞书

整体思路是两步：
1）安装飞书插件

你可以在控制台里让它帮你执行安装命令：
代码语言：PowerShell
自动换行
AI代码解释
  1. openclaw plugins install @m1heng-clawd/feishu
复制代码
(, 下载次数: 0)


(, 下载次数: 0)


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

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


然后把 App ID 和 App Secret 复制出来备用：
(, 下载次数: 0)


把这两项提供给 OpenClaw ，让它完成配置：
(, 下载次数: 0)


3）事件订阅
进入「事件与回调」页面：
(, 下载次数: 0)


如果提示“没有建立长连接”：
4）添加接收消息事件

在「事件配置」页面点击「添加事件」，搜索并添加：
(, 下载次数: 0)


不添加这个事件，机器人就无法收到你的消息。
6）发布版本

进入「版本管理与发布」：
只有发布后，前面的配置才会真正生效。
(, 下载次数: 0)


然后在飞书里找到你刚创建的机器人，发送一条消息，它会自动回复一个配对码
(, 下载次数: 0)


复制这个配对码，打开 Clawdbot 的 Web UI（就是前面那个控制台），把配对码发给它，Clawdbot 会自动完成绑定。
(, 下载次数: 0)


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

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


(, 下载次数: 0)

基础命令
  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 statusGateway 系统服务状态不同于 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



欢迎光临 AI创想 (http://llms-ai.com/) Powered by Discuz! X3.4