安装 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
成功启动后的日志应包含以下关键信息：
[] listening ws:
[] webchat connected
