保姆级教程:Windows部署OpenClaw AI智能体网关

本文详细介绍了在Windows系统上部署OpenClaw(开源AI智能体网关)的完整步骤,包含Node.js、Git安装,镜像源配置,初始化设置与常见问题解决,适合新手跟练。

保姆级教程:Windows部署OpenClaw AI智能体网关

OpenClaw 是什么?

OpenClaw 是一个自托管 Gateway 网关,可将你喜爱的聊天应用和渠道表面——包括内置渠道,以及内置或外部渠道插件(如 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等)——连接到像 Pi 这样的 AI 编码智能体。你只需在自己的机器(或服务器)上运行一个 Gateway 网关进程,它就会成为你的消息应用与始终可用的 AI 助手之间的桥梁。

它适合谁?适合开发者和高级用户,他们希望拥有一个可以随时随地发消息的个人 AI 助手——同时又不放弃对自己数据的控制,也不依赖托管服务。


安装

1. 安装nodejs

下载nodejs:https://nodejs.cn/download

选择长期支持版本24.14.0,下载

保姆级教程:Windows部署OpenClaw AI智能体网关

一路next安装即可

保姆级教程:Windows部署OpenClaw AI智能体网关

打开powershell

保姆级教程:Windows部署OpenClaw AI智能体网关

输入如下命令验证是否安装成功,如果成功看到了版本号代表安装成功

node -v
npm -v

修改Node为国内镜像地址

输入如下命令

npm config set registry https://registry.npmmirror.com
# 验证是否设置成功输入下面这个命令,如果返回了https://registry.npmmirror.com代表设置成功
npm config get registry
保姆级教程:Windows部署OpenClaw AI智能体网关

2. 安装git

打开官网:https://git-scm.com/install/windows,下载

保姆级教程:Windows部署OpenClaw AI智能体网关

一路next安装即可

保姆级教程:Windows部署OpenClaw AI智能体网关

重新打开powershell,输入 git -v,看到版本号证明安装成功

保姆级教程:Windows部署OpenClaw AI智能体网关

3. 安装OpenClaw

重新打开PowerShell窗口输入如下命令等待安装完成

git config --global url."https://github.com/".insteadOf ssh://git@github.com/
npm i -g openclaw

我这边大概等待了3分钟左右安装完成,输入

openclaw -v

看到版本号,就代表安装成功

保姆级教程:Windows部署OpenClaw AI智能体网关

设置

1. 初始化OpenClaw

输入

openclaw onboard

选择 yes -> quick start

保姆级教程:Windows部署OpenClaw AI智能体网关

选择自己开通过API的模型,我这里用的是kimi

保姆级教程:Windows部署OpenClaw AI智能体网关

选择 Kimi API key(.cn), 区别:.ai海外版,.cn国内版,subscription订阅制专属节点

保姆级教程:Windows部署OpenClaw AI智能体网关

下面就是输入api key和选择合适的模型,建议选择多模态模型,回车进行下一步

频道先不配置,先跳过

保姆级教程:Windows部署OpenClaw AI智能体网关

搜索功能也先不选,先跳过

保姆级教程:Windows部署OpenClaw AI智能体网关

skill跳过

保姆级教程:Windows部署OpenClaw AI智能体网关

Enable hooks我们全部勾选上,按空格勾选全部,然后按回车确认

保姆级教程:Windows部署OpenClaw AI智能体网关

部署完毕,程序会自动打开网页


使用

使用地址+端口+token的方式来访问,我的访问地址是http://127.0.0.1:18789/#token=123

保姆级教程:Windows部署OpenClaw AI智能体网关

这里简单测试下,让它直接给出我的电脑硬件信息,等了大概1分钟,给出了具体信息

保姆级教程:Windows部署OpenClaw AI智能体网关

遇到问题

1. nodejs安装完毕后,输入npm -v 提示”npm : 无法加载文件 “

按如下步骤处理

步骤 1:以管理员身份打开 PowerShell

点击 Windows 开始菜单

搜索 “PowerShell”

右键点击 “Windows PowerShell”

选择 “以管理员身份运行”

步骤 2:查看当前执行策略

在管理员模式的 PowerShell 中输入以下命令并回车:

Get-ExecutionPolicy

正常情况下会显示 Restricted,这就是问题的根源。

步骤 3:修改执行策略

输入以下命令来设置更宽松的执行策略:

Set-ExecutionPolicy RemoteSigned

系统会弹出确认提示,输入 Y 并回车确认

步骤 4:验证修改是否生效

再次输入以下命令检查:

Get-ExecutionPolicy

现在应该显示 RemoteSigned。

再次输入npm -v 即可看到版本信息。

保姆级教程:Windows部署OpenClaw AI智能体网关

2. OpenClaw安装完毕后,网页打开失败,重启网关提示 网关服务丢失

保姆级教程:Windows部署OpenClaw AI智能体网关
  • 关闭当前 PowerShell 窗口
  • 右键点击「Windows PowerShell」或「终端」,选择「以管理员身份运行」
  • 重新执行安装命令:
# 先卸载可能残留的无效任务(如果有)
schtasks /Delete /TN "OpenClaw Gateway" /F
# 重新安装网关服务
openclaw gateway install

会自动打开一个命令行窗口,不要关闭

保姆级教程:Windows部署OpenClaw AI智能体网关

浏览器中输入窗口中给的ip+token进行访问,token可以在配置文件里看到,默认token是一串,我这里改成了123

保姆级教程:Windows部署OpenClaw AI智能体网关

3. 按照命令行输出的地址访问一直提示未授权

保姆级教程:Windows部署OpenClaw AI智能体网关

注意配置文件中网关的端口号是什么,用http://127.0.0.1:端口/#token=具体token,比如我的访问地址就是 http://127.0.0.1:18789/#token=123 就能访问了

保姆级教程:Windows部署OpenClaw AI智能体网关

【版权提示】信息来自于互联网,不代表Intoep官方立场,内容仅供网友参考学习。如发现本站内容存在版权问题,烦请提供版权疑问、联系方式等发邮件至 1359125269@qq.com ,我们将及时沟通与处理。如若转载请联系原出处
(0)
OpenClaw高级Skills实操指南 – 全网最全Skills安装配置教程
上一篇 2026-03-31 10:17
手把手教你在Windows系统上部署Hermes Agent | 开源AI智能体安装教程
下一篇 2026-04-15 11:05

相关推荐

发表回复

登录后才能评论
扫码了解
扫码了解
反馈建议
分享本页
返回顶部