企业官网建设流程全解析

2026年6月8日，下面为你整理一份基于最新资料的 Windows 部署指南，涵盖环境准备、安装、配置到试运行全流程，帮你一次跑通！

一、安装前的准备工作

1. 系统要求

• 操作系统：Windows 10 或 11（64位）
• 内存：建议 8GB 以上
• 磁盘空间：至少 20GB 可用空间（用于存放 Skills 等组件）
• 网络：能够正常访问 GitHub 和 Node.js 官网

2. ⚠️ 重要安全提醒

OpenClaw 拥有操作文件系统、执行自动化任务的权限，强烈建议：

• 使用一台干净的备用电脑，或租用云端虚拟机进行安装测试
• 不要在存有重要资产的主力工作电脑上安装
• 给 API Key 设置月度使用限额，防止泄露导致超额扣费

3. 关闭安全防护软件

安装前请暂时关闭以下安全工具，否则可能拦截或删除关键文件：

• 360 安全卫士 / 360 杀毒
• 腾讯电脑管家
• 火绒安全
• Windows Defender 实时防护

OpenClaw 运行时会执行键鼠模拟、文件读写、浏览器控制等操作，易被安全软件判定为风险行为，这属于正常机制。

二、安装 Node.js 环境

OpenClaw 基于 Node.js 运行，要求版本 ≥ 22，推荐使用 nvm 管理版本。

方式一：使用 nvm（推荐，方便切换版本）

1. 访问 nvm-windows Releases 下载nvm-setup.exe并安装
2. 以管理员身份打开 PowerShell（右键点击开始菜单 → Windows PowerShell（管理员））
3. 执行以下命令：

# 安装 Node.js 22 最新版本 nvm install 22 # 使用刚安装的版本 nvm use 22.22.0 # 验证安装 node -v # 应输出 v22.x.x npm -v # 应输出对应 npm 版本 ```[7](@ref) ### 方式二：直接安装（新手友好） 访问 [Node.js 官网](https://nodejs.org/) 下载 **LTS 版本（22.x）** 的 Windows 安装包（.msi），一路 Next 即可。 ### 3. 配置国内镜像源（可选但推荐，大幅提升下载速度） ```powershell npm config set registry https://registry.npmmirror.com ```[4](@ref) ### 4. 安装 Git（部分组件需要） ```powershell winget install git.git # 或手动从 Git官网 下载安装 git --version # 验证安装

三、安装 OpenClaw

方法一：官方一键脚本（推荐新手）

在管理员 PowerShell中执行：

iwr -useb https://openclaw.ai/install.ps1 | iex ```[7](@ref) > 💡 若遇到执行策略报错，先运行：`Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`[7](@ref) ### 方法二：npm 全局安装（更可控） ```powershell # 先清理缓存（如果之前安装失败） npm cache clean --force # 全局安装最新版 npm install -g openclaw@latest # 验证安装 openclaw --version # 应输出 3.x.x 版本号 ```[4](@ref) --- ## 四、初始化配置（关键步骤） ### 1. 运行初始化向导 ```powershell openclaw onboard --flow quickstart ```[7](@ref) ### 2. 按提示完成配置 | 配置项 | 推荐选择 | 说明 | |--------|---------|------| | **风险提示** | Yes | 确认了解工具的风险[7](@ref) | | **安装模式** | QuickStart | 新手快速模式[7](@ref) | | **AI 模型** | 可选 Gemini、Qwen、DeepSeek 等 | 国内建议选 Gemini 或通义千问[7](@ref) | | **API Key** | 输入对应平台的 Key | 需提前注册获取[7](@ref) | | **通讯渠道** | Skip for now（暂不配置） | 后续可补充[7](@ref) | | **技能（Skills）** | Yes | 安装推荐技能包[7](@ref) | | **守护进程（Daemon）** | Yes | 实现后台运行[7](@ref) | ### 📌 接入 DeepSeek 模型（热门配置） 由于 DeepSeek 兼容 OpenAI 接口，在配置时选择 **OpenAI** 或 **Custom (OpenAI Compatible)**，然后填入： - **API Key**：从 DeepSeek 开放平台获取的 `sk-xxx` - **Base URL**：`https://api.deepseek.com`（末尾不要加 `/v1`） - **Model Name**：`deepseek-chat` 或 `deepseek-reasoner` ### 📌 接入 Kimi 模型 - **Auth Method**：选择 `Kimi Code API key (subscription)` - **Model**：推荐 `kimi-coding/k2p5`（旗舰模型，响应最快） --- ## 五、启动服务并验证 ### 1. 启动 Gateway 网关 ```powershell # 方式一：先设置本地模式（重要！） openclaw config set gateway.mode local # 启动网关 openclaw gateway start ```[4](@ref)[7](@ref) ### 2. 打开 Web 控制台 访问 **http://127.0.0.1:18789/**，或运行： ```powershell openclaw dashboard ```[4](@ref) ### 3. 发送消息试运行 在聊天框中输入 **“你好”**，如果能收到回复，说明安装成功！🎉[7](@ref) ### 4. 验证守护进程（关掉终端仍能运行） ```powershell openclaw daemon status

六、常见问题排查

❌ 问题1：code 128错误

原因：网络波动或 SSH 访问失败。

解决：

npm cache clean --force npm install -g openclaw@latest # 重试 ```[4](@ref) ### ❌ 问题2：`'openclaw' 不是内部或外部命令` **原因**：环境变量未刷新或 npm 全局目录未加入 PATH。 **解决**：关闭当前 PowerShell，重新以管理员身份打开；或手动将 `C:\Users\<用户名>\AppData\Roaming\npm` 加入系统 PATH。 ### ❌ 问题3：网关启动失败（Gateway 离线） **可能原因与解决**： - 安全软件拦截 → 关闭后重试[9](@ref) - 安装路径含中文 → 改为纯英文路径，如 `D:\OpenClaw`[9](@ref) - Gateway token 不匹配 → 运行 `openclaw doctor --fix` 自动修复 ### ❌ 问题4：首次启动加载慢 **正常现象**，首次需初始化依赖与环境，等待 **1-3 分钟** 即可，后续启动会加快[9](@ref)。 --- ## 七、进阶方向 ### 接入飞书机器人 ```powershell openclaw plugins install @m1heng-clawd/feishu

然后在飞书开放平台创建应用，配置 App ID、App Secret 及相应权限即可。

常用管理指令

八、总结

OpenClaw 是一款功能强大的本地 AI 智能体工具，数据存储在本地，隐私更有保障。安装过程中最需要注意的是：管理员权限、纯英文路径、关闭安全软件这三点。祝你的“小龙虾”顺利跑起来！🦞✨