目录
Windows 11 上安装 OpenClaw 并接入智谱 GLM-4.7-Flash --安装教程
GrapeLin
2026年03月08日 16:15
openclaw

本文首发于 B 站专栏，手把手带你从零开始，在 Windows 11 上搭建属于自己的 AI 助手 OpenClaw，并配置智谱 GLM-4.7-Flash 模型，全程截图式讲解，小白也能轻松上手！

📌 前言

OpenClaw 是一款强大的自托管 AI 助手平台，支持接入国内外主流大模型（智谱、OpenAI、Claude 等），并提供 Web 控制台、终端界面以及多平台接入能力（如微信、飞书、Telegram）。本文将详细讲解如何在 Windows 11 上安装 OpenClaw，并配置 智谱 GLM-4.7-Flash 模型（免费额度充足），让你拥有一个完全可控的 AI 助手。

特点：

  • ✅ 数据完全本地存储，隐私无忧

  • ✅ 支持模型自由切换

  • ✅ 可扩展技能（文件处理、联网搜索等）

  • ✅ 提供美观的 Web 控制台

🛠️ 一、准备工作

1.1 系统要求

  • 操作系统：Windows 11（64 位）或 Windows 10 64 位

  • 内存：建议 8GB 以上

  • 磁盘空间：至少 2GB

  • 网络：能够正常访问 GitHub（若网络受限，我们会提供国内镜像方案）

1.2 获取智谱 API Key

  1. 访问 智谱开放平台 BigModel.cn 注册/登录。

  2. 进入 “API Keys” 管理页面，点击 “创建 API Key”。

  3. 复制生成的密钥（以 sk- 开头），妥善保存。

💡 GLM-4.7-Flash 模型目前有免费额度，足够个人日常使用。

1.3 以管理员身份打开 PowerShell

  • 按下 Win + X，选择 “Windows PowerShell (管理员)” 或 “终端(管理员)”。

  • 如果弹出用户账户控制提示，点击 “是”。

🚀 二、安装 OpenClaw

OpenClaw 官方提供了一键安装脚本，会自动安装 Node.js 22+ 和 OpenClaw 核心文件。我们推荐使用此方法，省时省力。

2.1 允许执行 PowerShell 脚本

在管理员 PowerShell 中执行：

代码块
PlainText
自动换行
复制代码
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
复制成功

输入 Y 确认。

2.2 运行一键安装命令

官方源（国际网络）：

代码块
PlainText
自动换行
复制代码
iwr -useb https://openclaw.ai/install.ps1 | iex
复制成功

国内镜像源（若官方源慢或失败）：

代码块
PlainText
自动换行
复制代码
iwr -useb https://clawd.org.cn/install.ps1 | iex
复制成功

安装过程约 3-10 分钟，脚本会自动下载 Node.js 并安装 OpenClaw。请耐心等待，不要关闭窗口。

2.3 验证安装

安装完成后，执行：

代码块
PlainText
自动换行
复制代码
openclaw --version
复制成功

如果输出类似 2026.3.7 的版本号，说明安装成功。

⚠️ 若提示 openclaw 不是内部或外部命令，请关闭当前 PowerShell 窗口，重新以管理员身份打开再试。

⚙️ 三、配置智谱 GLM-4.7-Flash 模型

安装成功后，需要告诉 OpenClaw 使用哪个模型和 API Key。

3.1 启动配置向导

代码块
PlainText
自动换行
复制代码
openclaw onboard --install-daemon
复制成功

此命令会：

  • 启动交互式配置界面

  • 将 OpenClaw 网关安装为 Windows 计划任务（实现开机自启）

3.2 按照向导提示填写信息

使用键盘上下键选择，回车确认：

配置项推荐输入说明ModeQuickStart快速启动，跳过复杂项Model/auth providerCustom Provider手动添加模型提供商（拉到列表最下方）API Base URLhttps://open.bigmodel.cn/api/paas/v4智谱 API 地址（国内用户）API Key粘贴你的智谱 API Key以 sk- 开头Endpoint compatibilityOpenAI-compatible接口兼容模式Model IDglm-4.7-flash智谱的模型 IDDefault model选择刚刚添加的模型设为默认Channels（消息渠道）Skip for now暂不配置，后续可按需添加Skills（技能）Yes启用基础技能（推荐）Hook（事件触发）No新手跳过

配置完成后，向导会自动验证连接。如果看到 Verification successful，恭喜你，配置成功！🎉

3.3 手动检查配置（可选）

配置文件保存在 C:\Users\你的用户名\.openclaw\openclaw.json。你可以用记事本打开，确认 models.providers 下是否有 zhipu 相关配置，并且 agents.defaults.model.primary 指向了正确的模型。

🖥️ 四、启动 OpenClaw 网关服务

4.1 安装并启动服务

代码块
PlainText
自动换行
复制代码
openclaw gateway install   # 安装为 Windows 计划任务
openclaw gateway start     # 启动服务
复制成功

4.2 检查服务状态

代码块
PlainText
自动换行
复制代码
openclaw gateway status
复制成功

如果输出显示 Running，说明服务已正常运行。

🐞 小贴士：如果服务启动失败，可以尝试前台运行网关查看日志：

代码块
PlainText
自动换行
复制代码
openclaw gateway run
复制成功

按 Ctrl+C 可停止，前台运行能帮助你定位问题。

🔑 五、获取 Token 并访问 Web 控制台

OpenClaw 默认启用了 Token 认证，你需要拿到 Token 才能登录 Web 界面。

5.1 查看 Token

在 PowerShell 中执行：

代码块
PlainText
自动换行
复制代码
type C:\Users\72901\.openclaw\openclaw.json | findstr token
复制成功

找到 gateway.auth.token 后面的一长串字符，复制它。

5.2 打开 Dashboard

使用以下命令自动携带 Token 打开浏览器：

代码块
PlainText
自动换行
复制代码
openclaw dashboard --token 你的Token
复制成功

或者手动在浏览器地址栏输入：

text

代码块
PlainText
自动换行
复制代码
http://127.0.0.1:18789/?token=你的Token
复制成功

如果一切正常，你将看到 OpenClaw 的聊天界面！

5.3 首次对话测试

在输入框中随便问一个问题，例如：“你好，请介绍一下自己”。如果模型能正常回复，说明 OpenClaw 已在 Windows 11 上成功运行！👏

🔧 六、常用命令速查

操作命令说明查看版本openclaw --version确认安装成功重新配置openclaw config修改模型或添加新功能启动网关openclaw gateway start启动服务停止网关openclaw gateway stop停止服务查看状态openclaw gateway status检查运行状态打开控制台openclaw dashboard在浏览器中打开 Web 界面查看日志openclaw logs查看运行日志，排查问题健康检查openclaw doctor检查系统状态并给出修复建议完全卸载openclaw uninstall卸载 OpenClaw 并清理相关文件

❗ 七、常见问题与解决

Q1：安装时提示“无法加载文件 ...，因为在此系统上禁止运行脚本”

原因：PowerShell 执行策略未修改。 解决：以管理员身份运行 PowerShell，执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，输入 Y 确认，再重新运行安装命令。

Q2：openclaw 命令找不到

原因：安装后未重启终端，或 PATH 未更新。 解决：关闭当前 PowerShell 窗口，重新以管理员身份打开。如果仍不行，手动将 C:\Users\你的用户名\AppData\Roaming\npm 添加到系统环境变量 PATH 中。

Q3：网关启动失败，提示“Gateway service missing”

原因：未执行 openclaw gateway install。 解决：先执行 openclaw gateway install，再 openclaw gateway start。

Q4：Web 界面打开后无法连接，显示 unauthorized

原因：未提供正确的 Token。 解决：使用 openclaw dashboard --token 你的Token 打开，或在 URL 后添加 ?token=你的Token。Token 可在配置文件中找到。

Q5：配置时验证失败（Verification failed）

原因：

  • API Key 错误或已过期

  • API Base URL 不正确（应包含 /v4）

  • 网络无法访问智谱 API（国内用户一般无需代理） 解决：重新运行 openclaw config，仔细核对以上三项。

Q6：聊天时模型无响应，日志出现 low context window 警告

原因：GLM-4.7-Flash 上下文窗口为 16K，OpenClaw 默认期望更高，但这是无害警告，不影响使用。 解决：可忽略，或在配置文件中为模型添加 "contextWindow": 16000 字段消除警告。

Q7：如何彻底卸载 OpenClaw？

解决：

代码块
PlainText
自动换行
复制代码
openclaw uninstall
复制成功

然后手动删除 C:\Users\你的用户名\.openclaw 文件夹。

🎯 八、进阶玩法

OpenClaw 远不止一个简单的聊天界面，它还能：

  • 接入消息平台：通过 openclaw channels add 配置微信、飞书、Telegram 等，让 AI 在群里回答问题。

  • 安装更多技能：执行 openclaw skills install 添加文件处理、PDF 解析、网页抓取等工具。

  • 连接本地模型：如果你想完全离线使用，可以安装 Ollama，并配置本地模型（如 Qwen、Llama 3）。

  • 设置自动化任务：让 OpenClaw 定时执行邮件摘要、文件备份等操作。

详细文档请参考：OpenClaw 官方文档

📝 结语

至此，你已经成功在 Windows 11 上搭建了 OpenClaw，并接入了智谱 GLM-4.7-Flash 模型。现在你可以随时随地拥有一个智能、可定制的 AI 助手，而无需担心数据隐私问题。

如果在安装过程中遇到任何困难，欢迎在评论区留言交流或者Email：729018627@qq.com。如果本文对你有帮助，请点赞、收藏、转发支持一下！🦞

cv46578083