openclaw本地部署（windows)

一 基础安装

第一步，您需要通过Node.js包管理器快速安装OpenClaw的核心命令行工具。请执行以下全局安装命令：

npm i -g openclaw

成功安装工具后，您需要立即运行初始化向导命令。此步骤将为后续的项目配置创建必要的基础环境：

openclaw onboard

二 关键配置步骤

以最新的2026.2.13版本为例，在配置OpenClaw时，请特别留意以下关键环节和常见问题。

若您的公司网络或本地环境对SSH协议存在访问限制，为了确保代码仓库能够顺利克隆，推荐将Git全局配置为使用HTTPS协议。执行以下两条Git命令，将SSH格式的Git地址映射为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

全局安装完成后，下一步是配置AI模型的访问凭证。请打开您系统（Windows）的文件资源管理器，导航至以下用户目录：C:\Users\您的用户名\.openclaw\agents\main（请务必将路径中的「您的用户名」替换为您的实际电脑用户名）。

进入该目录后，请查找一个名为 auth-profiles.json 的授权配置文件。如果该文件不存在，您需要手动创建一个新的文本文件，将其重命名为 auth-profiles.json。接着，使用任意文本编辑器（如记事本、VS Code等）打开此文件，并填入以下JSON配置结构（请务必将示例中的占位符替换为您从智谱AI官方平台申请到的真实API密钥）：

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

配置文件保存完毕后，请重新打开命令行终端。输入以下命令，进入OpenClaw的交互式配置模式，并选择配置模型相关参数：

openclaw configure --section model

最后，在完成所有上述环境变量和模型配置的修改后，为了让新的配置项立即生效，您必须重启OpenClaw的后台网关服务。执行重启命令如下：

openclaw gateway restart

恭喜！至此，OpenClaw智能开发助手的完整安装与基础环境配置流程已全部结束。您现在已经可以启动并使用它来辅助您的编程开发工作了。