windows安装openclaw流程

2026-05-06阅读 0热度 0
ai Agent OpenClaw

一、前置条件

动手之前,得先把这几样基础工具准备好,一步都不能少。

1. 安装 Node.js 的包管理器 npm。这是绝大多数现代前端和工具链的基石,没它几乎寸步难行。

2. 安装 Git,并前往 Git 代码托管平台(如 GitHub、GitLab)完成 SSH 密钥的配置。关于 SSH 密钥的生成方法,网上教程非常丰富,这里就不赘述了。

二、安装 OpenClaw

1. 安装 OpenClaw 核心包

打开你的命令行工具,执行下面的安装命令:

npm install -g openclaw@latest --omit=optional --legacy-peer-deps

这里需要解释一下后面两个参数:--omit=optional--legacy-peer-deps。它们的主要作用是跳过那些用于支持本地模型的插件。如果你的电脑配置不太够,这些插件很可能导致安装报错。不过,只要你不打算使用本地模型,跳过它们完全不影响后续功能。

2. 初始化 OpenClaw

这一步至关重要,请务必使用**管理员权限**打开的命令行窗口(Windows 上是“以管理员身份运行”CMD 或 PowerShell)来执行。否则,后续的服务很可能启动失败。

执行初始化命令:

openclaw onboard --install-daemon

第一个提示,直接选择 “Yes”

配置模式选择。对于首次接触的朋友,强烈建议选择 “QuickStart”。那个“高级配置”选项,还是留给对系统非常熟悉的老手吧。

接下来选择要集成的大模型。示例中选择了 Minimax,你可以根据自己拥有的 API 权限和偏好来选择(这决定了后续可以调用哪些模型)。

这里询问 API Key 的配置方式。选择 “现在粘贴” 最省事,可以一步到位,免去后续再找地方配置的麻烦。

看到这个输入框,直接把你对应大模型的 API Key 粘贴进去,按回车继续。

设置默认使用的大模型。这里的选项取决于你上一步的选择,之后系统会默认调用这个模型来响应请求。

选择消息接入平台。示例中以飞书为例,你可以按自己的需求选择(使用飞书需要提前准备好应用 App ID 和 Secret)。

插件安装方式。因为示例机器上已有插件,所以选择了“本地路径”。如果你的环境是全新的,直接选择通过 npm 在线下载即可。

填入飞书机器人的 Secret。

填入飞书机器人的 App ID。

选择飞书机器人的连接方式,这里使用 “WebSocket”

如果你的飞书是国内版(非国际版 Lark),请选择 “飞书中国”

权限范围配置,为了后续有最大的操作空间,建议选择 “Open”,给予最大权限。

联网搜索功能配置。这一步可以先跳过,选择不配置。等后续有需要时,再回来设置也不迟。

技能(Skills)配置同样是可选项,可以留待后续按需添加。

记忆(Memory)功能配置。使用空格键选中它,然后按回车确认。

当看到这个界面时,恭喜你,安装已基本完成。系统会自动开启一个新窗口来启动服务,耐心等待启动成功即可。

3. 使用与飞书配置

服务启动成功后,在浏览器中访问 http://127.0.0.1:18789/ 就能打开本地聊天界面进行对话了。

如果你想启用刚配置的飞书机器人,还需要在飞书开放平台完成最后几步:

  1. 在应用配置中,启用“机器人”能力。
  2. 启动“长连接模式”。
  3. 订阅或配置相关事件。
  4. 重要:完成上述配置后,务必“发布版本”或“重新发布”应用,否则更改不会生效。

配置生效后,在飞书聊天中 @ 你的机器人,它会回复一个**配对码**。

回到命令行,执行以下命令完成配对(将 `xxx` 替换为实际的配对码):

openclaw pairing approve feishu xxx

配对成功之后,你就可以在飞书中直接和机器人畅快聊天了。

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策