安装指南

从下载到运行的完整教程。按照本页步骤操作,即使是第一次使用也能顺利完成安装。

Step by Step

安装步骤

建议始终从官方下载页获取安装包,不要通过聊天转发或第三方渠道

1

下载安装包

前往下载页获取最新版本安装包。确认文件名包含正确的版本号。

2

验证文件完整性

前往安全校验页,使用 PowerShell 或 certutil 验证 SHA256 哈希值,确认文件未被篡改。

3

运行安装器

双击安装包启动安装向导。如果 Windows Defender 弹出提示,请先确认 SHA256 校验通过后再选择"仍要运行"。

4

配置 AI 服务商

选择你的 AI 服务商(如 OpenAI、Anthropic 等),填写 API Base URL、API Key 和模型名称。

5

选择安装目录

保持默认安装目录或选择纯英文路径。避免中文和特殊字符,减少权限和路径问题。

6

完成安装

点击开始安装,等待 Gateway 自动启动。安装完成后通过浏览器打开本地控制页面即可使用。

安装前建议

优先使用默认安装目录,减少权限问题
安装路径避免中文和特殊字符
API Key 只填在本地安装器中,不要发到群里
完成后保存访问 Token,便于后续登录
Defender 拦截时先核对 SHA256 再放行
安装过程中需要联网下载依赖组件。如果网络环境受限,请确保能访问所选 AI 服务商的 API 端点。

验证命令

PowerShell Get-FileHash "OpenClaw-Installer-Setup-1.0.0.exe" -Algorithm SHA256
CMD certutil -hashfile "OpenClaw-Installer-Setup-1.0.0.exe" SHA256
FAQ

常见问题

安装过程中遇到问题?这里可能有你需要的答案

Windows 提示"未识别的应用"

这是因为首版安装包尚未做代码签名。请先在安全校验页核对 SHA256,确认文件来自官方后,点击"更多信息" → "仍要运行"。

安装完成后打不开

先检查本地端口是否已启动(默认端口会在安装完成时显示),再查看安装目录中的日志文件排查具体错误。

端口冲突怎么办

如果默认端口被占用,安装器会自动尝试其他可用端口。你也可以在配置文件中手动指定端口号。

如何升级到新版本

后续版本采用覆盖安装方式,用户配置目录会保留。具体升级说明会在版本历史页面随版本发布。

Roadmap

后续计划

持续改进安装体验

安装自检

安装后自动检测文件、端口、Gateway 状态

升级提醒

软件内检测最新版本并跳转官方下载页

代码签名

降低杀软拦截率,提升企业用户信任

自动更新

基于 manifest.json 实现增量更新

准备好了吗?

下载安装包,开始你的 AI 助手之旅