安装 OpenClaw 全网最详细流程与步骤,新手必备(一键脚本安装)

安装 OpenClaw 全网最详细流程与步骤,新手必备(一键脚本安装)

在Windows上安装OpenClaw主要有两种主流且可靠的方式:一键脚本安装(适合大多数用户)和结合WSL的安装(官方推荐,环境更兼容)。同时,也有一个较新的原生安装方式可供选择。

下面为你梳理了这三种方式的详细流程和步骤。

⚠️ 重要提示:安全第一

OpenClaw是一个具有系统操作权限的AI代理工具。在开始前,有两点非常重要的提醒:

风险意识:该工具可能会被授权访问你的账号、信息甚至系统,使用时请自行承担风险。

环境隔离:如果你的电脑存有重要资料,强烈建议在备用设备、虚拟机或云服务器(VPS)上运行,以保护隐私安全。

这是目前Windows上最简单、最快捷的安装方法,整个流程主要通过Powerhell命令行完成。

操作系统:Windows 元宝 混元 Hunyuan 教程 10 或 11(64位)。

网络:能够访问GitHub以下载安装脚本。

权限:需要使用管理员身份运行PowerShell。

以管理员身份打开PowerShell:右键点击开始菜单或按Win + X,选择 “Windows PowerShell (管理员)” 或 “终端(管理员)”。

(可选)解锁执行策略:为了防止首次运行脚本时报错,可以先执行以下命令:

运行一键安装命令:在PowerShell中复制粘贴以下命令并回车:

如果下载缓慢,可以尝试使用国内镜像源:

跟随安装向导:脚本运行后,会进入交互式配置流程,你需要根据提示做出选择:

完成与验证

OpenClaw主要为类Unix环境设计,在Windows上通过WSL 2运行是官方推荐的方案,能获得更好的兼容性和稳定性。

操作系统:Windows 10 2004+ 或 Windows 11。

开启虚拟化:需要在BIOS中启用VT-x/AMD-V。

以管理员身份打开PowerShell,安装WSL 2和Ubuntu系统:

安装完成后,按提示重启电脑。

进入WSL环境:重启后,打开PowerShell或CMD,输入wsl命令,即可进入Ubuntu命令行界面。

在WSL中安装OpenClaw:在Ubuntu的终端中,执行Linux安装命令:

完成初始化配置:安装脚本会自动启动向导,其后续的配置选项(选择模型、输入API Key等)与方式一中的步骤4完全相同。

访问控制台:配置完成后,OpenClaw服务会在WSL内启动。你可以在Windows的浏览器中直接访问http://127.0.0.1:18789来使用控制面板。

根据最新的教程,目前OpenClaw对Windows原生的支持已有改善,无需WSL也能较流畅地运行。

操作系统:Windows 11 (build 26200+) 或 Windows 10。

内存:建议≥8GB。

权限:需要管理员身份运行PowerShell。

以管理员身份打开PowerShell

解锁执行策略(同上文方式一):

安装OpenClaw Beta版(推荐使用最新稳定版):

配置Gateway模式:安装完成后,需要手动将Gateway设置为本地模式:

安装并启动Gateway服务

验证与访问

无论哪种方式安装,以下命令都非常实用:

健康检查:openclaw doctor全面检查环境与配置。

查看状态:openclaw gateway status查看核心服务是否运行。

打开面板:openclaw dashboard在浏览器中打开控制台。

实时日志:openclaw logs follow查看日志,定位错误时非常有用。

重启服务:openclaw gateway restart刷新机器人状态。

如果遇到问题怎么办?

“openclaw”命令找不到:关闭当前PowerShell,重新用管理员权限打开一个,让环境变量刷新。

Node.js版本问题:一键安装脚本通常会自动处理,如果手动安装失败,可以去官网下载Node.js 22+ LTS版本。

端口被占用:使用netstat -ano | findstr :18789找到占用端口的进程并结束它。

💡 下一步:接入飞书

安装成功后,你可以通过以下步骤将OpenClaw接入飞书,在聊天软件中使用它:

在OpenClaw控制台或命令行中安装飞书插件:openclaw plugins install @m1heng-clawd/feishu。

前往飞书开放平台,创建一个企业自建应用,获取App ID和App Secret。

在飞书应用的“权限管理”中,使用官方提供的JSON配置批量导入所需权限。

在“事件与订阅”中,配置订阅方式为“使用长连接接收事件”,并添加im.message.receive_v1事件。

发布应用版本,然后在飞书中找到机器人,发送消息获取配对码,最后在OpenClaw Web UI中绑定即可。

希望这份指南能帮你顺利在Windows上安装OpenClaw!如果在某个步骤遇到问题,随时可以再来问我。

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/275270.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午1:21
下一篇 2026年3月13日 下午1:21


相关推荐

关注全栈程序员社区公众号