安装 Node.js 24
首先准备好基础环境。下载并安装 Node.js v24,推荐使用 LTS 版本。
下载地址:Node.js — 下载 Node.js
验证安装(PowerShell):
PS C:\Users\Admin> node -v
v24.14.0
PS C:\Users\Admin> npm.cmd -v
11.9.0
初始化在线模型(ModelScope)
获取参考文档与 API 地址
访问 ModelScope 模型库找到 GLM-5 模型,确认推理接口文档。
API 地址通常为:https://api-inference.modelscope.cn
获取访问令牌
登录个人中心,在'访问控制'中创建新的访问口令。建议创建一个长期有效的 Token 以便后续配置。
获取模型 ID
访问 https://api-inference.modelscope.cn/v1/models,确认 GLM-5 的准确 ID 为 ZhipuAI/GLM-5。
一键安装 OpenClaw
使用 PowerShell 运行官方安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex
安装过程中会检测 Windows 环境和 Node.js 版本。随后进入交互式配置向导:
- 安全提示:OpenClaw 目前处于 Beta 阶段,作为个人代理运行。阅读安全警告后输入
Yes继续。 - Onboarding Mode:选择
QuickStart(快速开始)。 - Gateway 配置:默认端口 18789,绑定 Loopback (127.0.0.1),认证方式 Token。
- 模型提供商:选择
Custom Provider(自定义提供者)。 - API Base URL:输入
https://api-inference.modelscope.cn。 - API Key:粘贴之前获取的 ModelScope 访问令牌。
- Endpoint Compatibility:选择
Anthropic-compatible(GLM-5 兼容此协议)。 - Model ID:输入
ZhipuAI/GLM-5。 - 通道选择:国内环境推荐跳过 (
Skip for now),后续可在 Web 端添加飞书等渠道。 - 搜索引擎:默认 Brave Search,若需国内引擎可后续配置。
- Hooks 配置:启用
session-memory以保存会话上下文。
启动与故障排查
安装完成后,系统尝试自动注册 Gateway 服务。如果在 Windows 上遇到权限问题导致服务启动失败(如报错 schtasks create failed),无需惊慌,这是常见现象。
手动启动 Gateway 即可正常运行:
openclaw.cmd gateway
成功启动后的日志应包含以下关键信息:
[gateway] listening on ws://127.0.0.1:18789
[webchat] webchat connected
此时打开浏览器访问本地控制台: http://127.0.0.1:18789/
总结
通过上述步骤,我们完成了 OpenClaw 在 Windows 10 上的部署,并接入了 GLM-5 模型。如果遇到工具不可用或搜索功能受限,可在 Web 控制台的设置页面补充相应的 API Key 或调整权限策略。

