Windows系统 OpenClaw-CN 从安装到使用全流程（含依赖缺失、token配置）

摘要：本文详细记录 OpenClaw-CN 从安装、配置到启动的完整流程，同步整理本人安装过程中遇到的所有报错及解决方案，全程实操可复现，新手也能轻松上手，避免踩坑！

关键词：OpenClaw-CN；安装教程；报错解决；千问模型配置；CMD/PowerShell 命令

一、前言

OpenClaw-CN 是一款实用的AI辅助工具，支持多种AI模型调用，可实现对话、写代码、执行命令等功能。本人在安装配置过程中遇到了环境变量、依赖缺失、权限不足等多个问题，耗时良久才全部解决，特此整理完整流程+问题汇总，帮助各位小伙伴快速上手，少走弯路。

二、OpenClaw-CN 完整安装流程（Windows系统，亲测有效）

2.1 前提准备

确保电脑已安装 Node.js（建议最新稳定版），安装后可通过以下命令验证是否安装成功：

node -v
npm -v

若能正常显示版本号，说明 Node.js 安装成功，可继续下一步。

2.2 安装 OpenClaw-CN

打开 管理员 PowerShell，执行以下命令安装（国内镜像，避免依赖丢失）：

npm install -g openclaw-cn@latest --registry=https://registry.npmmirror.com

2.3 配置环境变量（解决“无法识别命令”问题）

安装完成后，若执行 openclaw-cn --version 报错“无法将‘openclaw-cn’识别为cmdlet/函数”，说明环境变量未配置，按以下步骤解决：

1. 执行命令，获取 npm 全局安装路径：

npm config get prefix

通常输出路径为 D:\NodeGlobal\node_global（根据个人安装路径调整）。

1. 管理员 PowerShell 执行以下命令，一键配置环境变量（无需手动操作）：

# 获取 npm 全局路径
$path = (npm config get prefix).Trim()
# 添加到当前会话 PATH
$env:Path += ";$path"
# 永久添加到系统环境变量
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "Machine") + ";$path", "Machine")

1. 关闭当前 PowerShell，重新打开，执行 openclaw-cn --version，显示版本号即环境变量配置成功。

2.4 配置 AI 模型（以千问 Qwen 为例）

执行配置命令，进入模型配置界面：

openclaw-cn configure

配置步骤（全程中文界面，按以下提示操作）：

1. 模型选择：找到 阿里云百炼 (DashScope)（千问 Qwen 官方入口），输入对应序号并回车。

2. 认证方式：若没有 API Key 选项，直接选择 API Key（阿里云百炼），粘贴从阿里云百炼平台获取的 API Key（以 sk- 开头）。

3. API 地址：默认回车即可（或手动输入 https://dashscope.aliyuncs.com/compatible-mode/v1）。

4. 模型版本：推荐选择 qwen-turbo（速度快、免费额度足），回车确认。

5. 后续配置一路回车，直到显示 ✅ Configuration saved successfully!，即配置成功。

2.5 启动 OpenClaw-CN

配置完成后，执行以下命令启动（需设置访问token，保障安全）：

openclaw-cn gateway --token 123456

注：123456 可自定义（如 888888、abc123），启动成功会显示龙虾标语及 Gateway started on http://localhost:18789。

2.6 访问 OpenClaw-CN

打开浏览器，输入带token的地址，即可正常使用：

http://localhost:18789/?token=123456

（若想取消每次输入token，可执行openclaw-cn configure gateway，设置永久token后，直接访问 http://localhost:18789 即可。）

三、安装过程中遇到的问题及解决方案（亲测全部解决）

问题1：启动 CLI 失败，报错“Cannot find package ‘strip-ansi’”

报错信息：

Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'strip-ansi' imported from ...

原因：npm 安装时依赖包丢失（网络波动导致）。

解决方案：

# 1. 卸载旧版本
npm uninstall -g openclaw-cn
# 2. 清理 npm 缓存
npm cache clean --force
# 3. 重新安装（国内镜像）
npm install -g openclaw-cn@latest --registry=https://registry.npmmirror.com
# 4. 若仍报错，强制安装缺失依赖
npm install -g strip-ansi ansi-regex npmlog

问题2：启动网关报错“Gateway auth is set to token, but no token is configured”

原因：网关需要设置访问token（安全限制），未设置则无法启动。

解决方案：启动时添加token，命令如下：

openclaw-cn gateway --token 123456

（可设置永久token，参考 2.5 节末尾步骤）

问题3：浏览器访问显示“disconnected (1008): unauthorized: gateway token missing”

原因：访问网址未携带token，网关拒绝连接。

解决方案：访问时带上token，完整地址如下：

http://localhost:18789/?token=123456

问题4：无法查看磁盘（D盘/E盘），执行 dir 命令报错

报错信息：

exec failed: Get-ChildItem : 找不到与参数名称“/a”匹配的参数...
或 Out-File : 无法打开文件流...

原因：

1. OpenClaw-CN 旧版本不支持 workspace 配置项，无法直接放开磁盘权限；

2. AI 自动拼接的命令语法错误，或中文路径不兼容；

3. 旧版本有安全限制，无法直接访问磁盘根目录（D:\、E:\）。

解决方案：

1. 避免让AI自动拼命令，手动输入正确命令（优先用 PowerShell 命令）：

# 查看当前目录（100%成功）
powershell dir
# 查看指定文件夹（非根目录，如D盘NodeGlobal）
powershell "dir D:\NodeGlobal"
# 强制输出结果（写入文件再读取）
powershell "Get-ChildItem D:\ | Out-File D:\filelist.txt; type D:\filelist.txt"

1. 注意：旧版本无法直接访问 D:\、E:\ 根目录，但可访问根目录下的子文件夹，不影响核心功能使用。

问题5：执行“openclaw-cn configure workspace”报错“too many arguments”

原因：当前 OpenClaw-CN 版本不支持 workspace 配置项，命令格式错误。

解决方案：放弃配置 workspace，直接用上述 PowerShell 命令查看文件（无需配置，直接可用）。

四、核心功能说明（当前版本可用）

虽然旧版本无法直接访问磁盘根目录，但核心功能完全正常，可正常使用以下功能：

1. AI 对话：正常提问、解答问题、聊天互动；

2. 代码/脚本编写：批量重命名脚本、Python代码、HTML页面等；

3. 项目开发：协助编写项目结构、接口文档、核心代码；

4. 当前目录操作：查看当前文件夹、创建/读取/编辑文件；

5. 联网搜索：获取最新信息、技术文档等。

五、总结

OpenClaw-CN 安装配置的核心难点的是环境变量配置、依赖缺失和token设置，解决这三个问题后，基本可正常使用。旧版本虽有磁盘访问限制，但不影响核心功能，适合日常AI辅助、代码编写、项目开发等场景。

本文所有步骤均为本人实操验证，遇到的问题及解决方案全部可复现，新手可直接复制命令操作，避免踩坑。若遇到其他未提及的报错，可在评论区留言，看到后会及时回复解决！