2026年5 分钟搞定 OpenClaw!Windows 安装配置完整指南

5 分钟搞定 OpenClaw!Windows 安装配置完整指南导读 OpenClaw 是一款开源 AI 工具 支持多模型接入 本文从零开始 手把手教你在 Windows 上完成安装配置 包含环境准备 权限设置 常见问题解决方案 适合人群 Windows 用户 AI 工具爱好者 零基础新手 预计耗时 5 10 分钟 OpenClaw 是一款开源的 AI 客户端工具 主要特性 多模型支持 接入 Moonshot Kimi K2 5 等主流

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



导读:OpenClaw 是一款开源 AI 工具,支持多模型接入。本文从零开始,手把手教你在 Windows 上完成安装配置,包含环境准备、权限设置、常见问题解决方案。

 

适合人群:Windows 用户、AI 工具爱好者、零基础新手

 

预计耗时:5-10 分钟


OpenClaw 是一款开源的 AI 客户端工具,主要特性:

  • 🤖 多模型支持:接入 Moonshot、Kimi-K2.5 等主流 AI 模型
  • 🌐 双界面模式:Web UI + 终端 TUI,按需选择
  • 🔌 平台集成:支持飞书等平台消息对接
  • 🏠 本地部署:数据本地处理,隐私更安全
  • 轻量快速:基于 Node.js,占用资源少

适用场景

  • 个人 AI 助手
  • 团队消息自动化
  • AI 工作流集成
  • 本地模型测试

| 项目 | 最低要求 | 推荐配置 |

|------|---------|---------|

| 操作系统 | Windows 10 | Windows 11 |

| CPU | 双核 | 四核及以上 |

| 内存 | 2GB | 4GB 以上 |

| 磁盘空间 | 500MB | 1GB 以上 |

| Node.js | 18.x | 22.x LTS |

| Git | 任意版本 | 最新版本 |


Git 是代码版本管理工具,OpenClaw 依赖它获取资源。

安装步骤

  1. 访问官网下载页面:git-scm.com/install/win…
  2. 点击下载
  3. 双击运行安装程序
  4. 保持默认设置,连续点击 Next
  5. 完成安装后点击 Finish

验证安装

打开命令提示符,输入:

 
     

输出示例:

GPT plus 代充 只需 145

Node.js 是 JavaScript 运行时,npm 是其包管理器。

安装步骤

  1. 访问官网:nodejs.org/en/download
  2. 选择 22.x LTS 版本(长期支持版,更稳定)
  3. 下载 Windows 安装包(.msi)
  4. 双击运行,保持默认设置
  5. 勾选自动安装必要工具(如有提示)
  6. 完成安装

验证安装

 
      

输出示例:

GPT plus 代充 只需 145

⚠️ 重要提示

  • 务必选择 22.x LTS 版本,其他版本可能存在兼容性问题
  • Node.js 安装时会自动配置环境变量,但有时需要手动确认

如果安装后命令无法识别,需要手动配置环境变量。

方法一:快捷方式

  1. 按 打开运行窗口
  2. 输入 并回车
  3. 切换到 "高级" 选项卡
  4. 点击 "环境变量" 按钮

方法二:右键菜单

  1. 右键点击桌面/文件资源管理器中的 "此电脑"
  2. 选择 "属性"
  3. 点击 "高级系统设置"
  4. 点击 "环境变量" 按钮
  1. "系统变量" 区域找到
  2. 选中后点击 "编辑"
  3. 点击 "新建"
  4. 输入以下路径:

  

   C:Program Files odejs

  

  1. 继续新建,添加:

  

   C:Program Files odejs ode_global

  

  1. 依次点击 "确定" 保存所有设置

关闭并重新打开命令提示符,执行:

 
       

全部显示版本号即配置成功。


Windows 默认限制脚本执行,需要调整策略。

操作步骤

  1. 按 ,选择 "Windows PowerShell (管理员)"
  2. 输入以下命令查看当前策略:

   powershell

   Get-ExecutionPolicy -List

  

  1. 如果显示 ,执行以下命令:

   powershell

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

  

  1. 输入 确认更改

策略说明

| 策略 | 说明 |

|------|------|

| Restricted | 禁止所有脚本(默认) |

| RemoteSigned | 本地脚本可执行,远程脚本需签名 |

| Unrestricted | 允许所有脚本(不推荐) |

推荐:使用 ,平衡安全与便利

部分安全软件可能拦截 npm 全局安装。

建议操作

  1. 暂时退出 360 安全卫士
  2. 暂时退出腾讯电脑管家
  3. Windows Defender 添加信任(可选)

安装完成后可重新开启安全软件。


国内用户建议使用国内镜像加速:

GPT plus 代充 只需 145

验证配置:

 
         

应输出:

在命令提示符或 PowerShell 中执行:

GPT plus 代充 只需 145

参数说明

  • :全局安装,可在任意目录使用
  • :安装最新版本

安装成功标志

 
         

GPT plus 代充 只需 145

显示版本号即安装成功。


 
          

参数说明

  • :启动初始化向导
  • :后台运行模式

向导会提示选择配置方式:

选项 1:使用现有配置

GPT plus 代充 只需 145

选择此项使用默认的 Moonshot/Kimi 模型。

选项 2:跳过配置

 
          

可后续再配置。

选项 3:自定义配置

根据提示输入:

  • AppID
  • Secret
  • 其他平台凭证

当提示确认时,输入 完成初始化。


启动服务

GPT plus 代充 只需 145

访问地址

浏览器打开:

 
           

或:

GPT plus 代充 只需 145

喜欢命令行的用户可使用 TUI 模式:

 
           

GPT plus 代充 只需 145

正常输出

 
           

GPT plus 代充 只需 145

如果 18789 端口被占用,可修改配置:

  1. 找到配置文件(通常在用户目录)
  2. 修改 字段
  3. 重启服务

OpenClaw 支持飞书机器人集成:

配置步骤

  1. 飞书开放平台创建应用
  2. 获取 AppID 和 Secret
  3. 在 OpenClaw 配置中填写凭证
  4. 订阅所需事件(消息、审批等)

权限要求

  • - 消息读写
  • - 会话管理
  • - 通讯录读取
  • - 文档访问
  • - 多维表格

在 Web UI 中可选择不同模型:

  • Moonshot
  • Kimi-K2.5
  • 其他接入的模型

错误信息

 
             

解决方案

  1. 以管理员身份运行命令提示符
  2. 或修改 npm 全局目录:

   bash

   npm config set prefix "%APPDATA% pm"

  

  1. 重新安装

解决方案

  1. 确认环境变量已配置(见第四节)
  2. 关闭并重新打开命令行窗口
  3. 执行 确认路径包含
  4. 重新安装:

   bash

   npm uninstall -g openclaw

   npm install -g openclaw@latest

  


错误信息

GPT plus 代充 只需 145

解决方案

 
               

解决方案

  1. 查找占用进程:

   bash

   netstat -ano | findstr 18789

  

  1. 结束进程或修改配置端口
  2. 重启服务

排查步骤

  1. 确认服务已启动:
  2. 检查防火墙设置
  3. 尝试
  4. 查看日志文件定位问题

解决方案

  1. 确认 Key 格式正确(无多余空格)
  2. 检查账户余额/配额
  3. 测试 API 连通性
  4. 查看官方文档确认权限

解决方案

  1. 暂时退出安全软件
  2. 添加 npm 和 Node.js 到信任列表
  3. 重新执行安装命令

  • OpenClaw 官网:www.ai/zh-CN/
  • 官方文档:docs.ai/
  • Git 下载:git-scm.com/install/win…
  • Node.js 下载:nodejs.org/en/download
  • npm 镜像:npmmirror.com/

  • 掘金社区:搜索 OpenClaw 相关话题
  • GitHub Issues:问题反馈

恭喜完成 OpenClaw 的安装配置!

关键步骤回顾

| 步骤 | 操作 | 耗时 |

|——|——|——|

| 1 | 安装 Git | 2 分钟 |

| 2 | 安装 Node.js 22.x | 2 分钟 |

| 3 | 配置环境变量 | 1 分钟 |

| 4 | 设置 PowerShell 权限 | 1 分钟 |

| 5 | npm 安装 OpenClaw | 2 分钟 |

| 6 | 初始化配置 | 2 分钟 |

| 总计 | | 约 10 分钟 |

下一步建议

  • 📖 阅读官方文档了解功能
  • 🔑 配置 API Key 开始使用
  • 🤖 尝试飞书等平台集成
  • 💡 探索自动化工作流

如果本文对你有帮助

👍 点赞 | ⭐ 收藏 | ➕ 关注

遇到问题欢迎在评论区留言交流!


最后更新:2026 年 3 月 11 日

适用版本:OpenClaw latest / Windows 1011

小讯
上一篇 2026-03-17 15:38
下一篇 2026-03-17 15:36

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/236451.html