本教程按 Windows 11 + PowerShell 场景编写，包含 Node.js 官方安装、OpenClaw 官方安装、DeepSeek API 配置、启动与排错 四部分。优先使用官方安装地址和官方命令，减少版本偏差。

二、官方地址与下载入口

下面这些地址建议收藏，后续下载、更新、排错都会反复用到。

三、Node.js 安装教程（官方方式）

OpenClaw 依赖 Node.js 运行。如果本机没有 Node.js，建议先完成这一节，再安装 OpenClaw。

3.1 推荐下载地址

推荐入口： Node.js 官方下载页 https://nodejs.org/en/download。官方页面会显示当前 LTS 版本。

Windows 11 常用安装包： 64 位 MSI 安装程序。

示例（2026-04 当前 LTS 直链，后续可能更新）： https://nodejs.org/dist/v24.14.1/node-v24.14.1-x64.msi

3.2 安装步骤

1.    打开 Node.js 官方下载页，优先选择 LTS（长期支持版）。

2.    点击 Windows 64-bit Installer（.msi）下载到本地。

3.    双击安装包，保持默认选项，一路点击 Next / Install 即可。

4.    安装结束后关闭安装窗口，重新打开 PowerShell。

3.3 验证 Node.js 是否安装成功

在 PowerShell 中依次执行下面两条命令：

如果两条命令都能正常显示版本号，说明 Node.js 与 npm 安装成功。若提示找不到命令，通常是安装未完成或终端未重开。

四、OpenClaw 安装教程（PowerShell）

OpenClaw 官方支持 Windows（PowerShell）安装。 本教程提供 官方脚本安装法 和 Node.js + npm 手动安装法 两种方式。两种任选一种即可。

4.1 方式 A：使用 OpenClaw 官方 PowerShell 安装脚本

官方安装命令：

这条脚本会在 Windows PowerShell 中执行官方安装流程；官方文档说明它可以在需要时安装 Node，并拉起 OpenClaw 安装与引导流程。

适合人群：希望尽量按官方默认方式完成安装的用户。

4.2 方式 B：使用 Node.js + npm 手动安装 OpenClaw

如果你已经安装好了 Node.js，也可以直接执行下面这条命令：

安装完成后，用下面命令检查版本：

4.3 首次引导配置（推荐）

安装完成后，推荐执行官方引导命令：

这条命令会帮助你完成模型认证、网关配置和基础环境初始化。

五、配置 DeepSeek API（推荐做法）

DeepSeek 官方 API 与 OpenAI 兼容，base URL 为 https://api.deepseek.com，模型常用值为 deepseek-chat。在 OpenClaw 中，默认模型推荐写成 provider/model 形式。

5.1 先准备 DeepSeek API Key

5.    打开 https://platform.deepseek.com/api_keys 。

6.    登录 DeepSeek 账号后创建一个新的 API Key。

7.    复制并妥善保存这串 Key，后面配置时会用到。

5.2 推荐方式：用 OpenClaw 官方 CLI 的自定义 Provider 方式接入

这是一种比较稳的做法。官方 CLI 参考里提供了 custom-api-key、custom-base-url、custom-model-id、custom-provider-id、custom-compatibility 这些参数，适合接入 DeepSeek 这样的 OpenAI 兼容接口。

请把下面命令中的 YOUR_DEEPSEEK_API_KEY 替换成你自己的 Key：

执行完成后，默认模型建议使用：

5.3 如果你想用交互式方式配置

8.    执行 openclaw configure。

9.    进入 Model / Auth 部分时，优先选择支持自定义 Provider 的入口。

10.  把 base URL 填为 https://api.deepseek.com 。

11.  把模型 ID 填为 deepseek-chat 。

12.  保存后，把默认模型设置成 deepseek/deepseek-chat。

5.4 检查模型是否配置成功

可以用下面命令检查当前模型与认证状态：

如果日志里看到默认模型已经是 deepseek/deepseek-chat，通常说明基础配置已经生效。

六、启动、打开和停止 OpenClaw

6.1 启动网关

启动成功后，默认会监听本机 127.0.0.1:18789。

6.2 打开控制界面

常用地址：

如果启用了 token 认证，请优先使用 dashboard 命令让 OpenClaw 自动打开当前 token 对应的控制页：

若你手动拼接地址，常见格式是：

6.3 停止网关

6.4 查看日志

七、更新与常用维护命令

下面这些命令最常用，建议保存。

八、常见问题与处理方法

问题 1：PowerShell 执行策略或权限问题

·         如果命令执行时提示脚本或权限受限，先确认当前 PowerShell 是否以管理员身份运行。

·         安装完成后，建议重新打开一个新的 PowerShell 窗口再继续操作。

问题 2：更新时报 EBUSY / 文件被占用

·         先执行 openclaw gateway stop。

·         关闭所有 OpenClaw 相关 PowerShell 窗口和控制页标签。

·         然后重新执行 openclaw update，或使用 npm install -g openclaw@latest。

问题 3：浏览器提示 unauthorized / token missing

·         优先使用 openclaw dashboard 自动打开控制页。

·         如果手动打开，请确认地址里带的是 #token=... 而不是 ?token=...。

问题 4：模型报 Unknown model

·         先确认默认模型写法是否是 provider/model 形式。

·         DeepSeek 常用写法建议为 deepseek/deepseek-chat。

·         再确认 base URL 是否正确填成 https://api.deepseek.com。

九、最快完成安装的推荐顺序

13.  访问 Node.js 官方下载页，安装当前 LTS 版 Node.js。

14.  在 PowerShell 中执行 npm install -g openclaw@latest。

15.  执行 openclaw onboard --install-daemon。

16.  准备好 DeepSeek API Key。

17.  执行 custom provider 接入命令，写入 DeepSeek base URL 与模型 ID。

18.  启动 openclaw gateway。

19.  执行 openclaw dashboard 打开控制界面，检查模型状态。

文末提醒

• 官网与下载页会随着版本更新而变化；本文中的官方主页与文档页长期有效，具体版本号以官网页面显示为准。

• 如果你后续还要接企业微信、Telegram、邮件等渠道，建议先把本机 OpenClaw 跑通，再做渠道对接。