openclaw本地部署（windows)

一 基础安装

首先，通过一行命令完成核心工具的获取：

npm i -g openclaw

安装完成后，紧接着运行初始化命令，为后续的配置工作打好基础：

openclaw onboard

二 关键配置步骤

以 2026.2.13 版本为例，配置过程中有几个关键点需要注意。

如果您的网络环境对 SSH 协议支持不佳，或者希望统一使用 HTTPS 来拉取代码，可以预先对 Git 进行全局配置。执行以下命令，将常见的 SSH 格式地址映射到 HTTPS：

# 替换 git@github.com: 格式
git config --global url."https://github.com/".insteadOf "git@github.com:"
# 替换 ssh://git@github.com/ 格式
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

接下来，进行正式安装。为了确保安装过程的纯净，避免潜在脚本冲突，建议在安装时忽略执行脚本：

npm install -g openclaw --ignore-scripts

安装成功后，就需要配置模型授权了。打开系统的文件管理器，依次进入这个路径：C:\Users\你的用户名\.openclaw\agents\main（请务必将「你的用户名」替换为您电脑的实际用户名）。

在该目录下，检查是否存在一个名为 auth-profiles.json 的文件。如果文件不存在，就新建一个文本文件，将其命名为 auth-profiles.json，然后用文本编辑器打开，写入以下配置内容（注意将示例中的 API Key 替换成您从智谱AI平台获取的真实密钥）：

{"zhipuai": {"apiKey": "你的智谱API Key"}}

保存文件后，返回命令行终端，执行配置命令以告知系统您的模型选择：

openclaw configure --section model

最后，所有配置修改完成后，为了让设置生效，必须重启核心服务网关：

openclaw gateway restart

至此，整个安装与基础配置流程就完成了。可以开始探索后续的功能了。