导读: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 依赖它获取资源。
安装步骤:
- 访问官网下载页面:git-scm.com/install/win…
- 点击下载
- 双击运行安装程序
- 保持默认设置,连续点击 Next
- 完成安装后点击 Finish
验证安装:
打开命令提示符,输入:
输出示例:
GPT plus 代充 只需 145
Node.js 是 JavaScript 运行时,npm 是其包管理器。
安装步骤:
- 访问官网:nodejs.org/en/download
- 选择 22.x LTS 版本(长期支持版,更稳定)
- 下载 Windows 安装包(.msi)
- 双击运行,保持默认设置
- 勾选自动安装必要工具(如有提示)
- 完成安装
验证安装:
输出示例:
GPT plus 代充 只需 145
⚠️ 重要提示:
- 务必选择 22.x LTS 版本,其他版本可能存在兼容性问题
- Node.js 安装时会自动配置环境变量,但有时需要手动确认
如果安装后命令无法识别,需要手动配置环境变量。
方法一:快捷方式
- 按 打开运行窗口
- 输入 并回车
- 切换到 "高级" 选项卡
- 点击 "环境变量" 按钮
方法二:右键菜单
- 右键点击桌面/文件资源管理器中的 "此电脑"
- 选择 "属性"
- 点击 "高级系统设置"
- 点击 "环境变量" 按钮
- 在 "系统变量" 区域找到
- 选中后点击 "编辑"
- 点击 "新建"
- 输入以下路径:
C:Program Files odejs
- 继续新建,添加:
C:Program Files odejs ode_global
- 依次点击 "确定" 保存所有设置
关闭并重新打开命令提示符,执行:
全部显示版本号即配置成功。
Windows 默认限制脚本执行,需要调整策略。
操作步骤:
- 按 ,选择 "Windows PowerShell (管理员)"
- 输入以下命令查看当前策略:
powershell
Get-ExecutionPolicy -List
- 如果显示 ,执行以下命令:
powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
- 输入 确认更改
策略说明:
| 策略 | 说明 |
|------|------|
| Restricted | 禁止所有脚本(默认) |
| RemoteSigned | 本地脚本可执行,远程脚本需签名 |
| Unrestricted | 允许所有脚本(不推荐) |
✅ 推荐:使用 ,平衡安全与便利
部分安全软件可能拦截 npm 全局安装。
建议操作:
- 暂时退出 360 安全卫士
- 暂时退出腾讯电脑管家
- 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 端口被占用,可修改配置:
- 找到配置文件(通常在用户目录)
- 修改 字段
- 重启服务
OpenClaw 支持飞书机器人集成:
配置步骤:
- 飞书开放平台创建应用
- 获取 AppID 和 Secret
- 在 OpenClaw 配置中填写凭证
- 订阅所需事件(消息、审批等)
权限要求:
- - 消息读写
- - 会话管理
- - 通讯录读取
- - 文档访问
- - 多维表格
在 Web UI 中可选择不同模型:
- Moonshot
- Kimi-K2.5
- 其他接入的模型
错误信息:
解决方案:
- 以管理员身份运行命令提示符
- 或修改 npm 全局目录:
bash
npm config set prefix "%APPDATA% pm"
- 重新安装
解决方案:
- 确认环境变量已配置(见第四节)
- 关闭并重新打开命令行窗口
- 执行 确认路径包含
- 重新安装:
bash
npm uninstall -g openclaw
npm install -g openclaw@latest
错误信息:
GPT plus 代充 只需 145
解决方案:
解决方案:
- 查找占用进程:
bash
netstat -ano | findstr 18789
- 结束进程或修改配置端口
- 重启服务
排查步骤:
- 确认服务已启动:
- 检查防火墙设置
- 尝试
- 查看日志文件定位问题
解决方案:
- 确认 Key 格式正确(无多余空格)
- 检查账户余额/配额
- 测试 API 连通性
- 查看官方文档确认权限
解决方案:
- 暂时退出安全软件
- 添加 npm 和 Node.js 到信任列表
- 重新执行安装命令
- 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 10⁄11
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/236451.html