小白openclaw安装(win)
安装OpenClaw方法
部署OpenClaw主要有两条路径:一是本地部署,二是云端部署(例如阿里云、腾讯云或其他云服务商)。对于大多数想深入把玩、进行定制化开发的用户来说,本地部署往往是第一步。
本地部署有两种方法可以实现
如果你对命令行不太熟悉,别担心,这条路不止一条。最省心的办法是让智能的IDE工具帮你搞定环境配置,或者直接求助Claude这类AI助手,告诉它你的系统环境,让它生成部署脚本。当然,如果你喜欢挑战,也可以选择完全手动安装——不过这通常会耗费不少时间,尤其是对新手而言。说个过来人的经验,前期如果没找对方法,折腾一整天也是常有的事。
(一个高效的小技巧是:先借助IDE的强大能力把基础环境搭建好,然后再着手部署OpenClaw,这样能为你节省大量的时间和精力。)
环境官网地址
工欲善其事,必先利其器。安装OpenClaw前,需要确保你的系统里已经准备好了这几样东西,具体按需安装即可:
Node.js 环境:https://nodejs.org/en
Git 版本控制工具:https://git-scm.com/
https://git-scm.com/
怎么检验安装是否成功?打开你的终端(Terminal),输入下面这几条指令。如果能查看到版本号,并且符合OpenClaw的要求,那就没问题了(建议安装LTS长期支持版,稳定性更有保障)。
检查Node.js版本:
node -v检查npm版本:
npm -v检查Git版本:
git -v
当环境准备就绪,就可以进入正题,开始安装OpenClaw了。
OpenClaw官网地址
一切从这里开始:https://openclaw.ai/
访问官网,直接将页面拉到最底部,找到那个醒目的【Quick Start】部分。这里提供了几种安装方式,因为我的环境是用npm管理的,所以自然选择了npm的安装指令。
步骤
1. 安装完成后,别急着进行下一步。先输入
openclaw --version指令看看版本,确认安装成功。我当前安装的版本是 2026.3.2。2. 接下来,输入
openclaw onboard命令,这会启动一个交互式的初始化向导。当终端出现类似下图的页面时,就意味着你可以跟着引导继续操作了。
向导会陆续询问一些配置选项。一路选择“YES”,然后进入“QUICKSTART”。接着会来到关键的一步:模型配置。你可以选择在此刻配置,也可以留到后期再说,非常灵活。
我选择了MiniMax作为我的主力模型,只需跟着屏幕上的步骤和要求填写相应的API Key等信息即可。不同模型的价格策略各异,具体费用建议直接参考各模型的官方文档。
模型之后,向导会询问你关于“Channels”的配置。这其实就是你未来与OpenClaw对话的渠道。选择一个你常用的就行,我这边以飞书(Feishu)为例。同样,这个配置也支持后期修改。这里提一嘴:飞书是国内版,Lark是国际版,两者界面相似但后台服务有区别,别选错了。
以飞书为例,选择后,终端会提示你输入对应的 App Secret 和 App ID。这两串字符需要在飞书开放平台创建应用后才能获得。直接复制粘贴过来就好。(有个细节要注意:从飞书平台复制的内容格式可能与终端不兼容,建议先在记事本或任何文本编辑器里粘贴一下,再从编辑器里复制,最后在终端中鼠标右键完成粘贴。)
Channel配置妥当后,向导还会引导你配置“Skills”和“Webhooks”,这些关乎机器人的技能和外部连接,同样可以现在配置或日后补上。
进行到这里,核心部署其实已经基本完成了。最后一步是选择与OpenClaw的对话方式,我选择了Web UI,因为图形界面更加直观友好。
(需要注意的是,此时部署好的还是一个“骨架”机器人,尚未添加任何定制化功能。)
飞书配置
创建自己的bot在飞书上
由于我选择了飞书作为Channel,那么自然需要在飞书平台创建一个对应的机器人应用。
打开飞书开放平台:open.feishu.cn,创建一个“企业自建应用”。
应用名称随你喜欢填写即可。(但请注意:生成的App ID和App Secret相当于机器人的最高权限钥匙,务必妥善保管,切勿泄露。)
加机器人
应用创建好后,进入应用详情页,找到【添加应用能力】或类似选项,然后选择【机器人】。
配置权限
这一步决定了你的机器人在飞书里能做什么。根据你的需求,在权限配置页面勾选相应的权限,比如获取用户信息、发送消息等。
事件配置
这是至关重要的一步!如果没有正确配置事件订阅,飞书上的机器人将无法接收和响应用户的消息。很重要!再说三遍也不为过。
(对于本地测试环境,特别推荐采用“长连接”方式,它无需你拥有公网IP,配置起来非常方便。)
在事件列表里,你可以自定义选择需要订阅的事件类型,例如“接收消息”。
发布
这里有一个关键操作习惯:每次在飞书开放平台上对应用进行任何修改之后,无论是【权限配置】、【事件配置】还是其他设置,
记得一定要点击“重新发布”!记得一定要点击“重新发布”!记得一定要点击“重新发布”!
发布并审核通过后(企业自建应用通常是自动通过),你会在飞书手机端收到应用上线的通知。
接下来,你可以在飞书里找到这个机器人并尝试对话,但此时你会发现它无法正常回应,反而可能会给你返回一个“pairing code”。这个配对码请先复制保存好,在接下来的【飞书配对OpenClaw】环节会用到。
飞书配对OpenClaw
之前配置的App ID和Secret,好比是为OpenClaw打开了接收飞书信号的“门”。而现在这个配对步骤,则是让OpenClaw“认识”并“理解”你这个具体的飞书用户。需要回到终端进行操作。
查看配对请求
在终端输入:
openclaw pairing list feishu
批准
在终端输入:
openclaw pairing approve feishu#请将
替换成你在飞书机器人对话框里收到的那串配对码。
显示页面
当看到类似下图的成功提示,就意味着大功告成了!现在,你已经可以通过飞书的机器人界面与你的OpenClaw助手进行对话了。
如果完成以上步骤后,飞书机器人仍然没有对话框或无法回应,可以尝试在终端运行 openclaw gateway 命令来启动核心网关服务。
以上记录源于实践过程中的梳理,希望能为你提供一份清晰的参考路线图。

















