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



OpenClaw 是一款轻量、跨平台的 AI 助手框架，支持快速对接各类大模型。本文以Windows 原生环境为基础，从环境准备、OpenClaw 安装、千问 API 获取，到模型配置与启动，提供零踩坑、可直接复制的完整流程，适合新手快速上手。

---

1. 安装 Node.js（必备）

OpenClaw 基于 Node.js 运行，需先安装稳定版 Node.js（推荐 v20+）：

• 下载地址：

  Node.js 官网

  File

• 安装时勾选Add to PATH，确保命令全局可用
• 验证安装（管理员 PowerShell 执行）：

powershell

node -v npm -v 

出现版本号即成功。

2. 安装 Git（可选，用于源码安装）

powershell

winget install Git.Git 

验证：

powershell

git –version 

---

方式 1：npm 全局安装（新手首选）

以管理员身份打开 PowerShell，执行：

powershell

# 安装最新版OpenClaw npm install -g openclaw@latest

验证安装

openclaw –version

出现版本号（如 v0.12.x）即安装成功。

方式 2：虚拟环境安装（隔离依赖）

powershell

# 创建虚拟环境 node -m venv openclaw_env

激活

.openclaw_envScriptsActivate.ps1

安装

npm install -g openclaw@latest

验证

openclaw -v

方式 3：源码安装（开发者模式）

powershell

git clone https://github.com/openclaw/openclaw.git cd openclaw npm install npm link openclaw –version 

---

1. 登录

   阿里云 DashScope 平台

   File

2. 进入API 密钥管理，创建并复制API-KEY（格式：sk-xxx）
3. 记录兼容模式地址：https://dashscope.aliyuncs.com/compatible-mode/v1

---

方法 1：交互式配置（新手推荐）

执行初始化向导，按提示操作：

powershell

openclaw onboard 

关键步骤：

1. 确认配置目录（默认：%USERPROFILE%.openclaw）→ 输入y
2. 选择 AI 提供商：选择Custom OpenAI Compatible API
3. 填写 API Key：粘贴你的 Qwen API-KEY
4. 填写 Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
5. 默认模型：输入qwen-turbo（或qwen-plus/qwen3.5-max）
6. 其他选项默认，完成配置。

方法 2：直接修改配置文件（精准控制）

1. 打开配置目录：

powershell

# 快速打开配置文件夹 explorer %USERPROFILE%.openclaw 

1. 用记事本 / VS Code 打开openclaw.json，替换为以下配置（修改apiKey）：

json

{ “models”: {

"providers": { "qwen": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "sk-你的千问API密钥", "api": "openai-completions" } }, "defaults": { "model": "qwen/qwen-turbo" } 

}, “agents”: {

"defaults": { "model": { "primary": "qwen/qwen-turbo", "fallbacks": ["qwen/qwen-plus"] } } 

} }

1. 保存文件，配置生效。

---

1. Web UI（推荐，可视化操作）

powershell

openclaw ui –no-gateway 

启动成功后，浏览器访问：http://localhost:3000即可在 Web 界面与千问大模型交互。

2. 终端 TUI（命令行界面）

powershell

openclaw tui 

直接在终端内对话，适合无图形界面场景。

---

1. 安装权限问题

• 报错：permission denied
• 解决：必须以管理员身份运行 PowerShell，或添加–user参数：

powershell

npm install -g openclaw@latest –user 

2. 命令未找到（openclaw not found）

• 原因：Node.js 未添加到 PATH，或安装未生效
• 解决：
  1. 重启 PowerShell / 终端
  2. 重新安装：npm install -g openclaw@latest
  3. 手动添加 Node.js 路径到系统环境变量

3. 模型连接失败

• 报错：API Key invalid或connection failed
• 解决：
  1. 核对 API Key 是否正确，无多余空格
  2. 确认 Base URL 为：https://dashscope.aliyuncs.com/compatible-mode/v1
  3. 检查网络，确保可访问阿里云服务
  4. 重启 OpenClaw：openclaw ui –no-gateway

4. Web UI 无法打开

• 解决：
  1. 改用 TUI：openclaw tui
  2. 换浏览器（Edge/Chrome）访问http://localhost:3000
  3. 检查端口 3000 是否被占用

---

1. 常用 Qwen 模型推荐

表格

2. 切换默认模型（命令行）

powershell

# 切换为qwen-plus openclaw models set qwen/qwen-plus

查看当前模型

openclaw models list

---

本文完整覆盖 Windows 下 OpenClaw 从安装、配置到对接通义千问的全流程，提供两种配置方式与常见问题解决方案，新手可直接复制命令完成部署。OpenClaw+Qwen 的组合，可快速搭建本地 AI 助手，满足日常开发、办公与创作需求。