OpenClaw 安装指南【详细保姆级教程，含常见问题解决方案】

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

 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg> <div align="center">

完整的安装与配置指南

平台最后更新 Windows ¹⁰⁄ ₁₁ + WSL2 2026年3月

1. 硬件与系统要求
2. 第一步：安装 WSL2 环境
3. 第二步：OpenClaw 核心环境安装
4. 第三步：运行配置向导
5. 第四步：Token 配置与服务启动
6. 常见问题排查
7. 常用命令速查表
附录：部署流程概览
结语

1.1 基本配置要求

配置项最低要求建议配置 CPU 2核心以上（需在BIOS中开启虚拟化） 4核心及以上内存 4GB 8GB+ 硬盘 20GB 可用空间 50GB+ 操作系统 Windows 10 21H2+ Windows 11

1.2 注意事项

⚠️ OpenClaw 需要一定的计算资源来运行 AI 模型和处理任务。如果您的硬件配置较低，可能会影响响应速度和稳定性。建议在部署前确保系统有足够的资源。

步骤 2.1：启用 WSL 功能

以管理员身份打开 Windows PowerShell，执行以下命令：

GPT plus 代充 只需 145

🔄 执行完成后，重启计算机。

步骤 2.2：设置 WSL 默认版本

重启后，以管理员身份打开 PowerShell：

步骤 2.3：安装 Ubuntu

🌟 推荐方法：命令行一键安装

GPT plus 代充 只需 145

此命令会自动下载并安装最新的 Ubuntu 发行版。安装完成后，重启终端即可使用。

📦 备选方法：Microsoft Store 安装

打开 Microsoft Store
搜索或
点击 “获取” 或 “安装” 按钮

💡 提示：如果已安装其他版本 Ubuntu，可直接使用，无需重复安装。

步骤 2.4：初始化 Ubuntu（首次启动）

首次启动 Ubuntu，需要进行初始化设置：

用户名设置

输入您的用户名（建议使用小写字母，不要包含特殊字符）
如出现错误，请使用符合 Linux 命名规范的用户名（建议使用或简单的英文名）

密码设置

输入密码（输入时不会显示字符，请牢记）
需要确认密码

⚠️ 重要：请务必记住您设置的用户名和密码，后续安装步骤需要 sudo 权限。

步骤 3.1：更新系统包（可选）

步骤 3.2：安装 Node.js 22

OpenClaw 需要 Node.js v22+ 运行环境。

GPT plus 代充 只需 145

✅ 验证安装：

应显示或更高版本。

步骤 3.3：运行安装脚本（网络延迟失败或者无梯子就使用淘宝镜像）

GPT plus 代充 只需 145

安装脚本会自动下载并配置 OpenClaw。如果出现 npm 相关警告，可以暂时忽略，继续下一步。

步骤 3.4：配置 PATH 环境变量（如需要）

❓ 遇到问题？点击展开

问题：如果出现错误

原因：PATH 中缺少 npm global bin 目录，导致 OpenClaw 命令无法被识别。

解决方案：

步骤 4.1：启动配置向导

GPT plus 代充 只需 145

步骤 4.2：配置步骤详解

步骤选项说明 1️⃣ Welcome 输入确认开始配置 2️⃣ Mode / 高级设置或快速开始 3️⃣ Model Provider 选择模型或如、（需配置 API Key） 4️⃣ Channel 通道配置可稍后设置 5️⃣ Skills 按提示安装依赖如显示，请按提示操作 6️⃣ Hooks 钩子配置可稍后设置 7️⃣ Systemd 服务 忽略错误 WSL 不支持 systemd，选择跳过

步骤 5.1：Token 配置（首次部署必读）

方法 A：自动生成 ✅ 推荐

如果过程中出现以下提示：

建议选择，系统会自动生成并配置 Token。

完成后请记录生成的 Token。

方法 B：手动设置

如果在配置向导中选择了，需要手动设置 Token。

GPT plus 代充 只需 145

⚠️ 注意：旧版本使用配置项，新版已废弃。请使用。

步骤 5.2：查看 Token（可选）

❓ 如何查看已设置的 Token？

问题：使用可能返回

原因：出于安全考虑，Token 会被隐藏显示。

解决方法：直接查看配置文件：

在输出的 JSON 中找到字段，即为您的 Token。

步骤 5.3：启动服务

GPT plus 代充 只需 145

✅ 看到表示服务已成功启动。

❓ 端口被占用怎么办？

问题：如果出现错误

原因：端口已被占用

解决方法：

然后重新启动。

步骤 5.4：访问 Web 界面

在 Windows 浏览器中访问（将替换为您的实际 Token）：

GPT plus 代充 只需 145

常见访问问题

问题原因解决方法 ❌ 无法访问端口错误确认使用 18789 端口，而非 18791 ❌ Unauthorized Token 未正确传递确保 Token 已添加到 URL 的参数中

问题可能原因解决方法 WSL 网络问题重启 WSL 或检查网络配置用户名格式错误使用符合 Linux 规范的用户名（小写字母） PATH 未配置执行重新加载配置使用了旧配置项使用替代 Token 未正确传递检查 URL 中的参数端口被占用服务已在运行先停止服务：

功能命令 🚀 启动服务 🛑 停止服务 📋 查看配置文件 🔑 设置 Token 🤖 设置默认模型 ⚙️ 重新运行配置向导

感谢您阅读本部署手册！OpenClaw 是一个功能强大的 AI 助手平台，本指南详细介绍了从环境搭建到服务启动的完整流程。

🎯 后续预告：我们将在后续文档中更新 OpenClaw 技能（Skills）的使用方法，敬请期待！

计划内容包括：

📦 技能的安装与配置详解

🛠️ 常用技能功能介绍

💡 自定义技能开发指南

🌟 实战案例与**实践

敬请期待！ 🚀

如有任何问题或建议，欢迎反馈交流。

Made with ❤️ by OpenClaw Team