OpenClaw 是一个强大的 AI 助手框架，本文档将详细指导你如何在 Windows 系统上完成安装和配置。
- 准备工作
- 环境安装
- OpenClaw 安装
- 基础配置
- 高级配置
- 故障排查
Node.js 下载地址
https://nodejs.org/zh-cn/download
建议选择 LTS 版本（长期支持版），更适合生产环境使用。
Git 下载地址
https://registry.npmmirror.com/binary.html?path=git-for-windows
国内用户推荐使用 NPM Mirror 提供的镜像源，下载速度更快。
Windows 默认会阻止脚本执行，需要先修改执行策略：
1
GPT plus 代充 只需 145Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
说明: RemoteSigned 允许本地执行的脚本，对于远程下载的脚本需要签名。这是平衡安全性和可用性的**选择。
运行下载好的 Node.js 安装包，一路点击 “Next” 即可完成安装。
安装完成后，验证安装是否成功：
1
2
GPT plus 代充 只需 145node –version
npm –version
应该能输出类似：
1
2
GPT plus 代充 只需 145v20.x.x
10.x.x
为了加速 npm 包的安装，建议切换到国内镜像源：
1
GPT plus 代充 只需 145npm config set registry https://registry.npmmirror.com/
验证配置：
1
GPT plus 代充 只需 145npm config get registry
应该输出：
1
GPT plus 代充 只需 145https://registry.npmmirror.com/
运行 Git 安装包，使用默认配置即可。安装完成后验证：
1
GPT plus 代充 只需 145git –version
1
GPT plus 代充 只需 145npm install -g openclaw@2026.3.2
如果遇到编译错误，可以使用以下命令跳过编译步骤：
1
GPT plus 代充 只需 145npm install -g openclaw@2026.3.2 –ignore-scripts –no-optional –force
参数说明:
–ignore-scripts: 跳过安装脚本–no-optional: 不安装可选依赖–force: 强制安装
1
GPT plus 代充 只需 145openclaw –version
首先需要生成 SSH 密钥，用于与服务器通信：
1
GPT plus 代充 只需 145ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"
注意: 将 "你的邮箱@example.com" 替换为你自己的邮箱地址。
按提示保存密钥（直接回车使用默认位置），并设置 passphrase（可选）。
生成的密钥文件位于：
- 私钥：
/.ssh/id_rsa - 公钥：
/.ssh/id_rsa.pub
运行以下命令进行初始配置：
1
GPT plus 代充 只需 145openclaw onboard –install-daemon
安装完成后，获取访问 Dashboard 的地址和 Token：
1
GPT plus 代充 只需 145openclaw dashboard –no-open
这个命令会输出包含 Token 的访问地址，请妥善保管。
重启服务
1
GPT plus 代充 只需 145openclaw gateway restart
以调试模式启动
1
GPT plus 代充 只需 145openclaw gateway –port 18789 –verbose
参数说明:
–port: 指定服务端口（默认为 18789）–verbose: 启用详细日志输出
编辑 OpenClaw 配置文件：
1
GPT plus 代充 只需 145openclaw config
或者手动编辑配置文件（通常位于 ~/.openclaw/config.json）。
在配置文件中添加以下权限设置， granting 所有工具的完全访问权限：
1
2
3
4
5
6
7
8
GPT plus 代充 只需 145{
"tools": {
"profile": "full",
"allow": [
"group:all"
]
}
}
如果需要集成 Feishu 作为消息通道，需要在 OpenClaw 配置中添加以下权限：
必需权限:
im:message- 发送和接收消息im:chat- 管理聊天会话
在 Feishu 开发者平台申请应用时，确保勾选这些权限。
如果遇到问题，可以使用诊断工具：
1
GPT plus 代充 只需 145openclaw doctor –fix
这个命令会自动检测常见问题并提供修复建议。
1
GPT plus 代充 只需 145openclaw status
如果遇到安装错误或权限问题，可以尝试切换全局安装目录：
1
2
3
4
5
6
7
8
9
10
11
GPT plus 代充 只需 145# 创建新的全局模块目录
mkdir C: ode-modules
# 设置全局模块路径
npm config set prefix C: ode-modules
# 设置全局缓存路径
npm config set cache C: ode-cache
# 添加到环境变量
$env:Path += ";C: ode-modules ode_modulesbin"
注意: 修改后需要重新打开 PowerShell 窗口使环境变量生效。
如果在安装过程中遇到编译相关的错误（如缺少 C++ 编译器等），需要：
- 安装 Visual Studio:
- 下载 Visual Studio Community（免费）
- 安装时勾选 “C++桌面开发” 工作负载
- 安装 Windows Build Tools:
1
GPT plus 代充 只需 145npm install -g windows-build-tools
如果 18789 端口被占用，可以更换其他端口：
1
GPT plus 代充 只需 145openclaw gateway –port 18790 –verbose
尝试以下步骤：
- 检查防火墙设置，确保相应端口已开放
- 查看日志文件获取详细错误信息
- 使用
openclaw doctor –fix自动修复 - 重启服务：
openclaw gateway restart
A: 建议配置国内镜像源，或使用 –ignore-scripts 选项跳过编译。
A: 检查服务是否在运行，确认端口正确，查看防火墙设置。
A: 运行 npm uninstall -g openclaw 即可卸载。
A: 运行 npm install -g openclaw@latest 升级到最新版本。
恭喜！你已经完成了 OpenClaw 的安装和基础配置。接下来可以：
- 访问 Dashboard 开始使用
- 配置更多的集成和插件
- 探索 OpenClaw 的高级功能
如有问题，请使用 openclaw doctor –help 获取更多帮助。
最后更新: 2026-03-13
适用版本: OpenClaw 2026.3.2
操作系统: Windows 10/11
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/249419.html