乐于分享
好东西不私藏

保姆级教程:OpenClaw 极简安装指南,小白也能一次成功!

保姆级教程:OpenClaw 极简安装指南,小白也能一次成功!

最近在折腾 OpenClaw,一个可以让你用微信、飞书、Telegram 这些聊天软件来控制电脑的工具。简单说就是:你在手机上发一条消息,它能帮你在电脑上执行任务——跑脚本、整理文件、自动化操作啥的。

听起来很炫,实际装起来有几个坑,我踩过了给你们记录一下。


装之前先确认几件事

系统没啥限制,Mac、Windows、Linux 都支持。不过 Windows 用户要注意,官方明确说原生 Windows 测试不充分,建议套一层 WSL2(就是 Windows 里的 Linux 子系统)来跑,稳定很多。

必须有 Node.js,而且版本要 22 以上,这个不能省,低版本跑不了。

要有一个 AI 模型的 API Key。OpenClaw 本身只是个调度框架,它得连到大模型才能理解你的指令。国内用户不建议折腾 OpenAI 或者 Anthropic,又贵又要国际信用卡。推荐几个免费或便宜的国内选项:

  • 智谱 GLM-4-Flash:完全免费,在 bigmodel.cn 注册就能拿到 Key
  • 通义千问:免费额度也不少,dashscope.aliyun.com 注册
  • Moonshot(Kimi):中文理解不错,platform.moonshot.cn

我自己用的是智谱的 GLM-4-Flash,免费够用了。


第一步:装 Node.js 22

去 nodejs.org 下载 v22 的安装包,选 LTS 版本,下载完一路 Next 装好就行。

装完打开终端验证一下:

node --version

显示 v22.x.x 就没问题。

Windows 用户:如果你想用 WSL2(推荐),先在 PowerShell 管理员窗口里运行:

wsl --install

重启一次电脑,之后打开 Ubuntu 终端,后面所有命令在 Ubuntu 里跑就行。


第二步:安装 OpenClaw

国内直接用 npm 装,不过先换个镜像源,不然速度感人:

npm config set registry https://registry.npmmirror.comnpm install -g openclaw

等它装完,验证一下:

openclaw --version

有版本号输出就装好了。

如果 npm 还是很慢甚至报错,社区有个国内优化版,依赖都打包好了:

npm install -g openclaw-cn

第三步:跑配置向导

这一步是核心,OpenClaw 会一步步引导你把 AI 模型、聊天渠道、网关这些都配置好。

运行:

openclaw onboard --install-daemon

然后会进入一个交互式的配置流程:

第 1 步 - 安全确认

它会警告你 OpenClaw 有比较高的系统权限,按左方向键  选 Yes,回车确认继续。

第 2 步 - 选 AI 模型

会让你选模型服务商。国内用户选 Custom / OpenAI-compatible,然后填入:

API Base URL: https://open.bigmodel.cn/api/paas/v4/API Key: 你在智谱平台拿到的 KeyModel: glm-4-flash

其他服务商同理,URL 和 Key 换成对应的就行。

第 3 步 - 选 Gateway 模式

第一次用选 Local,就是在本机跑网关。Remote 是连接远程部署的网关,先不用管。

出现端口配置的时候直接用默认值(18789),回车跳过就行。

第 4 步 - 聊天渠道

这里可以选飞书、Telegram、WhatsApp 等。第一次装建议直接跳过,先确认能跑起来,后面再配聊天渠道。

第 5 步 - 技能安装

默认选项就好,后面随时可以补装。


第四步:打开控制面板

配置完之后,运行:

openclaw dashboard

它会自动打开浏览器。如果没自动打开,手动访问:

http://127.0.0.1:18789/openclaw

注意:必须带上端口和路径,只写 127.0.0.1 是打不开的。

能看到 Dashboard 界面就说明完全跑起来了。


几个常用命令记一下

# 查看运行状态openclaw status# 手动启动网关(Dashboard 打不开时用)openclaw gateway --force# 查看日志(排查问题用)openclaw logs --follow# 设置开机自启openclaw daemon install

遇到问题?先看这几个

Dashboard 打不开

先跑 openclaw status 看看网关有没有在运行,没运行就手动 openclaw gateway --force 启一下。

内存不够报错(OOM)

内存小于 4G 可能会出现这个问题,可以给系统配置一下 swap 交换空间,把硬盘空间当虚拟内存用,网上搜"Linux 配置 swap"有很多教程。

npm 装包一直超时

确认镜像源已经切到淘宝了:npm config get registry,应该显示 https://registry.npmmirror.com


等你把基础跑通了,可以试着接入飞书机器人,这样就能在手机上发消息控制电脑。大概流程是:

  1. 去飞书开发者平台创建一个自定义应用
  2. 拿到 App ID 和 App Secret
  3. 在 OpenClaw 的 Channels 里配置 Feishu,填入这两个值
  4. 绑定完成后,在飞书给机器人发消息就能用了

具体步骤后面可以单独出一篇,这篇先到这里。


整体来说,OpenClaw 安装不算复杂,主要坑在网络和 Node 版本上。按这个流程走,大概半小时能搞定。有问题欢迎留言。