🦞 OpenClaw + 阿里千问免费模型 Windows 11 超详细安装教程

这是一份真正的「保姆级」教程，从零开始，每一步都有详细的命令、截图说明和选择指引，即使是电脑小白也能一步步完成安装。

📋 目录

1. 准备工作：检查你的电脑
2. 安装 Node.js 环境
3. 获取阿里云百炼 API Key
4. 一键安装 OpenClaw
5. 配置向导全程详解
6. 验证安装成功
7. 常用命令速查
8. 常见问题排查

准备工作：检查你的电脑

第一步：确认操作系统

1. 右键点击桌面左下角的 「开始」 按钮（或按 Win + X）
2. 选择 「系统」
3. 在「系统类型」一栏确认显示为 「64位操作系统」

📖 说明：本教程适用于 Windows 10 和 Windows 11 64位系统。

第二步：检查电脑配置（建议）

💡 提示：配置低于最低要求也能运行，但体验可能会卡顿。

第三步：检查是否已安装 Node.js

OpenClaw 需要 Node.js 22.0 或更高版本才能运行。我们来检查一下你的电脑是否已经安装。

1. 按 Win + S 搜索 「PowerShell」
2. 点击 「Windows PowerShell」 打开（不需要管理员权限）
3. 在窗口中输入以下命令，然后按回车：

node --version

根据显示结果判断：

📖 说明：如果显示版本号以 v22 开头，说明已经安装好了，可以直接跳到下一步。

安装 Node.js 环境

如果你的电脑没有 Node.js，或者版本低于 22.x，请按照以下步骤安装。

步骤 1：下载 Node.js 安装包

1. 打开浏览器，访问 Node.js 官网：https://nodejs.org/

2. 页面会显示两个下载按钮：

   • LTS（长期支持版）：推荐下载这个，版本号为 22.x.x
   • Current（最新版）：不推荐，可能不稳定
3. 点击 LTS 按钮，下载 Windows 安装程序（文件名类似 node-v22.x.x-x64.msi）

💡 提示：如果你不确定下载哪个，就下载文件名中带有 x64 和 msi 的那个。

步骤 2：运行安装程序

1. 找到下载的 .msi 文件，双击运行
2. 出现安装向导界面，点击 「Next」
3. 勾选 「I accept the terms in the License Agreement」，点击 「Next」
4. 选择安装目录（建议保持默认 C:\Program Files\nodejs\），点击 「Next」
5. 保持默认组件全选，点击 「Next」
6. 在 「Automatically install the necessary tools」 这一项，不要勾选（这会额外安装很多不需要的工具），直接点击 「Next」
7. 点击 「Install」 开始安装
8. 安装完成后，点击 「Finish」

步骤 3：验证安装是否成功

1. 重新打开一个新的 PowerShell 窗口（之前打开的可能还没有加载新环境变量）
2. 输入以下命令验证：

node --version

应该显示 v22.x.x（如 v22.10.0）

npm --version

应该显示 npm 的版本号（如 10.9.0）

✅ 成功标志：两个命令都正常显示版本号，说明 Node.js 安装成功！

获取阿里云百炼 API Key

OpenClaw 本身是免费的，但它需要调用大模型来回答问题。阿里云百炼为新用户提供 100万 Token 免费额度（有效期90天），足够日常使用。

步骤 1：注册并登录阿里云账号

1. 打开浏览器，访问阿里云官网：https://www.aliyun.com/
2. 点击右上角的 「登录/注册」
3. 使用手机号或支付宝账号完成注册和登录

步骤 2：完成实名认证（必需）

阿里云百炼需要实名认证才能使用。

1. 登录后，访问实名认证页面：https://account.console.aliyun.com/real-name
2. 选择 「个人实名认证」
3. 使用 支付宝扫码 或 身份证+人脸识别 完成认证
4. 整个过程约 2-5 分钟

📖 说明：实名认证是阿里云的要求，用于防止滥用。认证后不会自动扣费，请放心。

步骤 3：开通百炼服务并领取免费额度

1. 访问阿里云百炼控制台：https://bailian.console.aliyun.com/
2. 页面会提示「开通服务」，点击 「开通」 或 「免费体验」
3. 勾选同意服务协议，点击确认开通
4. 开通成功后，系统会自动发放 100万 Token 免费额度（有效期90天）

💡 提示：你可以在「模型用量」页面查看剩余的免费额度。建议开启「免费额度用完即停」开关，避免意外产生费用。

步骤 4：创建 API Key

1. 在百炼控制台左侧菜单，点击 「API-KEY」
2. 点击 「创建 API Key」 按钮
3. 输入一个名称（如 OpenClaw），方便识别用途
4. 点击 「确认」
5. ⚠️ 立即复制并保存好 API Key！ 关掉这个页面后就看不到了

🔑 API Key 格式：类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 的一串字符

一键安装 OpenClaw

步骤 1：以管理员身份打开 PowerShell

1. 按 Win + S 搜索 「PowerShell」
2. 右键点击 「Windows PowerShell」
3. 选择 「以管理员身份运行」
4. 如果弹出用户账户控制提示，点击 「是」

📖 说明：为什么需要管理员权限？安装脚本需要在系统路径中添加 OpenClaw 命令，这需要管理员权限。

步骤 2：执行一键安装命令

在 PowerShell 窗口中，复制并粘贴下面这行命令，然后按 回车：

iwr -useb https://openclaw.ai/install.ps1 | iex

关于粘贴：PowerShell 中 Ctrl + V 可能无效，正确的粘贴方式是 右键点击窗口任意位置，内容会自动粘贴。

安装过程说明：

• 脚本会自动检测 Node.js 环境
• 自动下载 OpenClaw 程序
• 自动配置环境变量
• 整个过程约 1-3 分钟，取决于网络速度

⚠️ 如果遇到执行策略报错：首次运行 PowerShell 脚本可能会报错，请先执行以下命令解除限制，然后重新运行安装命令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

步骤 3：验证安装是否成功

安装完成后，输入以下命令验证：

openclaw --version

成功标志：显示类似 openclaw/2026.3.23 的版本号。

如果显示 openclaw : 无法将“openclaw”项识别...，请关闭 PowerShell 窗口，重新以管理员身份打开，再试一次。

配置向导全程详解

安装完成后，配置向导会自动启动。如果没有自动启动，可以手动输入以下命令启动：

openclaw onboard --install-daemon

下面我将详细说明每一步的选择和原因。

第 1 步：安全确认

* I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
|    Yes / > No

操作：

1. 窗口显示这个提示
2. 按键盘上的 Y 键（Yes）
3. 按 回车 确认

📖 说明：这是确认你知道 OpenClaw 默认是个人使用模式。如果是多人共享使用，需要额外配置安全措施。这里我们只是自己用，直接确认即可。

第 2 步：选择安装模式

* Setup mode
|  > QuickStart (Configure details later via openclaw configure.)
|    Manual

操作：直接按 回车（QuickStart 已经默认选中）

📖 说明：选择快速开始模式。所有配置都可以后续在 Web 界面修改，不用担心选错。

第 3 步：选择 AI 模型提供商

* Model/auth provider
|    Anthropic (setup-token + API key)
|    BytePlus
|    Chutes
|    Cloudflare AI Gateway
|    Copilot
|    Custom Provider
|    DeepSeek
|    Google
|    Hugging Face
|    Kilo Gateway
|    Kimi Code
|    LiteLLM
|    MiniMax
|    Mistral AI
|    Moonshot AI (Kimi K2.5)
|    Ollama
|    OpenAI
|    OpenCode
|    OpenRouter
|    Qianfan
|    Qwen
|  > Qwen (Alibaba Cloud Model Studio)
|    SGLang
|    Synthetic
|  ...

操作：

1. 使用键盘的 方向键 ↓ 向下滚动列表
2. 找到 Qwen (Alibaba Cloud Model Studio)（注意不是单独的 Qwen）
3. 按 回车 选中

📖 说明：选择阿里云千问的官方版本。这个选项支持 OAuth 授权，配置最方便。

第 4 步：选择认证方式

* Qwen (Alibaba Cloud Model Studio) auth method
|    Coding Plan API Key for China (subscription)
|  > Standard API Key for China (pay-as-you-go)
|    Back

操作：

1. 确保 Standard API Key for China (pay-as-you-go) 是高亮状态
2. 按 回车 选中

📖 说明：选择按量付费模式。新用户有 100 万 Token 免费额度，不需要立即付费。

第 5 步：输入 API Key

* Enter Alibaba Cloud Model Studio API key (China)
|  _

操作：

1. 切换到之前保存 API Key 的地方（记事本或其他文档）
2. 复制你的 API Key（整串字符）
3. 回到 PowerShell 窗口，在光标处右键点击（粘贴）
4. 按 回车 确认

⚠️ 注意：粘贴时可能看不到任何字符显示，这是正常的（密码模式）。直接按回车即可。

验证：OpenClaw 会自动验证 API Key 是否有效。如果验证失败，会提示错误。请检查：

• API Key 是否复制完整（包括 sk- 前缀）
• 是否有多余的空格
• 如果还是不行，去百炼控制台重新生成一个 API Key

第 6 步：选择默认模型

* Default model
|  > Keep current (modelstudio/qwen3.5-plus)
|    Enter model manually
|    modelstudio/glm-4.7
|    modelstudio/glm-5
|    modelstudio/kimi-k2.5
|    modelstudio/MiniMax-M2.5
|    modelstudio/qwen3-coder-next
|    modelstudio/qwen3-coder-plus
|    modelstudio/qwen3-max-2026-01-23
|    modelstudio/qwen3.5-plus

操作：直接按 回车（Keep current 已默认选中）

📖 说明：qwen3.5-plus 是阿里云千问的最新主力模型，平衡了性能、速度和成本，适合绝大多数日常使用场景。

第 7 步：配置通讯渠道（跳过）

* Select channel (QuickStart)
|    Telegram (Bot API)
|    WhatsApp (QR link)
|    Discord (Bot API)
|    IRC (Server + Nick)
|    Google Chat (Chat API)
|    Slack (Socket Mode)
|    Signal (signal-cli)
|    iMessage (imsg)
|    LINE (Messaging API)
|    Feishu/Lark (飞书)
|    Nostr (NIP-04 DMs)
|    Microsoft Teams (Bot Framework)
|    Mattermost (plugin)
|    Nextcloud Talk (self-hosted)
|    Matrix (plugin)
|    BlueBubbles (macOS app)
|    Zalo (Bot API)
|    Zalo (Personal Account)
|    Synology Chat (Webhook)
|    Tlon (Urbit)
|    Twitch (Chat)
|  > Skip for now

操作：

1. 使用方向键 ↓ 向下滚动到底部
2. 选中 Skip for now
3. 按 回车

📖 说明：通讯渠道是让 OpenClaw 接入 Telegram、飞书等聊天软件。目前我们只需要用 Web 界面聊天，所以跳过。后续随时可以添加。

第 8 步：配置搜索服务（跳过）

* Search provider
|    Brave Search
|  > DuckDuckGo Search (experimental)
|    Exa Search
|    Firecrawl Search
|    Gemini (Google Search)
|    Grok (xAI)
|    Kimi (Moonshot)
|    Perplexity Search
|    Tavily Search
|    Skip for now

操作：

1. 使用方向键 ↓ 滚动到底部
2. 选中 Skip for now
3. 按 回车

📖 说明：联网搜索功能需要配置搜索引擎 API，不是必需功能，可以后续再配。

第 9 步：配置技能（跳过）

* Configure skills now? (recommended)
|  > Yes /   No

操作：

1. 按键盘的 N 键（选择 No）
2. 按 回车

📖 说明：技能（Skills）是让 AI 执行特定任务的功能扩展包，比如操作文件、发送邮件等。可以先跳过，后续在 Web 界面按需添加。

第 10 步：配置钩子（跳过）

* Enable hooks?
|  [ ] Skip for now
|  [ ] 🚀 boot-md
|  [ ] 📎 bootstrap-extra-files
|  [ ] 📝 command-logger
|  [ ] 💾 session-memory

操作：

1. 使用方向键确保 Skip for now 是高亮状态
2. 按 空格键 选中（方括号里会变成 [+]）
3. 按 回车 提交

📖 说明：钩子（Hooks）是高级自动化功能，新手用不到，直接跳过。

第 11 步：选择启动方式

* How do you want to hatch your bot?
|    Hatch in TUI (recommended)
|  > Open the Web UI
|    Do this later

操作：

1. 使用方向键选中 Open the Web UI
2. 按 回车

📖 说明：选择打开 Web 图形界面，这是最方便的使用方式。

第 12 步：完成！

配置完成后，你会看到类似以下的日志输出：

🦞 OpenClaw 2026.3.23 — I don't judge, but your missing API keys are absolutely judging you.

08:41:33 [canvas] host mounted at http://127.0.0.1:18789/__openclaw__/canvas/
08:41:34 [gateway] listening on ws://127.0.0.1:18789
08:41:34 [gateway] agent model: modelstudio/qwen3.5-plus
08:41:34 [browser/server] Browser control listening on http://127.0.0.1:18791/

同时，浏览器会自动打开 http://127.0.0.1:18789/，显示 OpenClaw 的 Web 聊天界面。

🎉 恭喜！OpenClaw 安装成功！

验证安装成功

测试 AI 对话

1. 在浏览器打开的 Web 界面中，找到聊天输入框
2. 输入以下测试消息：

你好，请介绍一下你自己

3. 按回车发送
4. 等待几秒钟，AI 应该会回复你

成功标志：AI 正常回复，说明：

• ✅ OpenClaw 安装成功
• ✅ API Key 配置正确
• ✅ 阿里千问模型调用正常

💡 关于那条幽默提示：日志里显示的 "I don't judge, but your missing API keys are absolutely judging you." 只是一个玩笑，意思是你的配置里还有可选的服务没配 API Key（比如搜索、语音等），但不影响正常对话，可以忽略。

常用命令速查

💡 提示：每次电脑重启后，OpenClaw 需要重新启动。可以运行 openclaw dashboard，它会自动启动网关并打开浏览器。

常见问题排查

问题 1：openclaw : 无法将“openclaw”项识别...

原因：环境变量未生效，或安装未完成。

解决方法：

1. 关闭所有 PowerShell 窗口
2. 重新以管理员身份打开 PowerShell
3. 再次运行 openclaw --version 验证
4. 如果还是不行，重新运行安装命令

问题 2：执行安装脚本时报错 "cannot be loaded because running scripts is disabled"

原因：PowerShell 执行策略限制。

解决方法：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新运行安装命令。

问题 3：API Key 验证失败

原因：API Key 不正确、已过期，或百炼服务未开通。

解决方法：

1. 登录阿里云百炼控制台
2. 检查是否已开通服务
3. 删除旧的 API Key，重新创建一个
4. 复制新的 API Key（确保完整，包括 sk- 前缀）
5. 重新运行配置向导修改 API Key

问题 4：浏览器无法打开 http://127.0.0.1:18789

原因：OpenClaw 网关未启动。

解决方法：

openclaw gateway start
openclaw dashboard

问题 5：端口 18789 被占用

原因：有其他程序占用了该端口。

解决方法：

1. 查看占用端口的进程：

   netstat -ano | findstr 18789

2. 找到 PID（最后一列数字），结束该进程：

   taskkill /PID [进程ID] /F

3. 重新启动 OpenClaw

问题 6：AI 回复很慢

原因：可能是网络问题，或模型选择问题。

解决方法：

1. 检查网络连接是否稳定
2. 在 Web 界面尝试切换到其他模型（如 qwen3-coder-next）
3. 如果长期很慢，考虑使用 Ollama 本地部署模型

问题 7：提示 API 额度不足

原因：免费额度已用完。

解决方法：

1. 登录百炼控制台查看剩余额度

2. 如果已用完，有两种选择：

   • 购买 Coding Plan 套餐（Lite 版 7.9 元/月）
   • 使用 Ollama 本地部署模型（完全免费，但需要电脑配置支持）

下一步：开始使用

安装完成后，你可以：

✅ 基础功能

• 在 Web 界面与 AI 对话
• 让 AI 帮你写文章、写代码、回答问题
• 让 AI 帮你整理资料、翻译内容

✅ 进阶功能

• 配置通讯渠道（飞书、钉钉、Telegram），让 AI 接入你的聊天软件
• 安装技能（Skills），让 AI 能够操作文件、发送邮件、搜索网页
• 配置定时任务，让 AI 自动执行日常任务

⚠️ 安全提醒

1. 不要暴露到公网：确保访问地址始终是 127.0.0.1
2. API Key 保密：不要分享给任何人
3. 定期更新：运行 openclaw update 获取安全补丁
4. 免费额度监控：在百炼控制台开启「免费额度用完即停」

总结

恭喜！你已经完成了 OpenClaw 的安装和阿里千问免费模型的配置。现在你可以：

• 🎯 在 Web 界面与 AI 对话
• 📝 让 AI 帮你写 Typecho 博客（AI 生成内容，你手动发布）
• 🚀 后续根据需要配置更多功能

关于 Typecho 写作的建议：OpenClaw 虽然可以自动操作（通过 API），但出于安全考虑，建议采用「AI 生成 + 手动发布」的模式——让 AI 帮你写文章，你登录 Typecho 后台复制发布。这样既高效又安全。

有问题随时在 Web 界面问 AI，或在社区搜索解决方案。祝使用愉快！🦞

🦞 每次启动 OpenClaw 的操作方法

OpenClaw 每次电脑重启后需要重新启动，以下是三种启动方式，按推荐程度排序。

✅ 方式一：一行命令启动（最推荐）

这是最简单、最常用的方式。

操作步骤

1. 按 Win + S 搜索 「PowerShell」
2. 点击 「Windows PowerShell」 打开（不需要管理员权限）
3. 输入以下命令，按回车：

openclaw dashboard

这条命令会自动完成以下操作：

• 自动启动网关服务（如果没运行）
• 自动打开浏览器访问 http://127.0.0.1:18789/

💡 优点：一行命令搞定，不需要记多个步骤。

✅ 方式二：分步启动（更灵活）

如果你想更清楚地控制启动过程，可以分两步执行。

第 1 步：启动网关

打开 PowerShell，输入：

openclaw gateway start

成功后会显示类似：

[gateway] listening on ws://127.0.0.1:18789

第 2 步：打开 Web 界面

openclaw dashboard

浏览器会自动打开聊天界面。

💡 适用场景：当你只想在后台运行网关，不立即打开浏览器时，可以只执行第 1 步。

✅ 方式三：创建快捷方式（一劳永逸）

如果你不想每次打开 PowerShell 输命令，可以创建一个桌面快捷方式。

操作步骤

1. 右键点击桌面空白处 → 「新建」 → 「快捷方式」
2. 在「请键入对象的位置」输入框中，粘贴以下内容：

powershell.exe -Command "openclaw dashboard"

3. 点击 「下一步」
4. 输入名称，比如 「OpenClaw」，点击 「完成」

以后使用：双击桌面上的这个快捷方式即可自动启动并打开浏览器。

💡 可选优化：如果想隐藏 PowerShell 窗口（后台静默运行），可以将命令改为：

powershell.exe -WindowStyle Hidden -Command "openclaw dashboard"

📊 三种方式对比

⚙️ 相关管理命令

🔍 如何判断 OpenClaw 已经在运行？

方法一：用命令检查

openclaw gateway status

返回结果：

• gateway is running → 正在运行 ✅
• gateway is not running → 未运行 ❌

方法二：访问 Web 界面

在浏览器访问 http://127.0.0.1:18789/

• 如果能打开聊天界面 → 正在运行 ✅
• 如果显示「无法访问此网站」→ 未运行 ❌

💡 常见问题

Q1：每次电脑重启后都要重新启动吗？

是的。OpenClaw 不会开机自启动，每次重启电脑后需要手动启动一次。如果你希望开机自动启动，可以：

1. 按 Win + R，输入 shell:startup，回车
2. 将上面创建的快捷方式复制到这个文件夹

这样每次登录 Windows 后，OpenClaw 会自动启动。

Q2：启动后显示「端口已被占用」怎么办？

说明上一次的网关没有正常关闭。执行：

openclaw gateway restart

Q3：启动后浏览器没自动打开怎么办？

手动访问 http://127.0.0.1:18789/ 即可。

Q4：忘记 API Key 了怎么办？

不需要重新配置。API Key 已经保存在配置文件中，启动后会自动使用。如果 API Key 失效了，可以：

openclaw config set models.providers.bailian.apiKey "你的新API Key"

📝 总结

日常使用记住这一条命令就够了：

openclaw dashboard

每次想用 OpenClaw 时，打开 PowerShell 输入这行命令，浏览器就会自动弹出聊天界面，开聊！🦞