OpenClaw 教程

OpenClaw 一键安装操作建议 ​

一、操作流程怎么走 ​

Windows ​

先按 Win + R，输入 powershell，回车打开命令行窗口。 然后执行安装命令：

shell
irm https://codefather.cn/openclaw_install/install-openclaw.ps1 | iex

如果执行时出现中文乱码，可以改用这条命令：

shell
& {$w=New-Object Net.WebClient;$w.Encoding=[Text.Encoding]::UTF8;iex $w.DownloadString('https://codefather.cn/openclaw_install/install-openclaw.ps1')}

执行后，脚本会自动完成一整套流程，包括：

  • 检测并安装 Node.js
  • 检测并安装 Git
  • 配置 npm 镜像
  • 安装 pnpm
  • 安装 OpenClaw
  • 验证安装结果
  • 引导完成首次配置

Mac ​

按 Command + 空格，搜索并打开 终端。 然后执行：

shell
curl -fsSL https://codefather.cn/openclaw_install/install-openclaw.sh | bash

执行后，脚本会自动完成依赖安装和 OpenClaw 配置，整体流程和 Windows 类似。

关于芯片差异 ​

这里可以简单理解为：只要是同一个系统，操作上没有差异。 也就是说，Windows 就按 Windows 的方式操作，Mac 就按 Mac 的方式操作，不需要因为芯片不同而改变你的使用步骤。

二、安装完成后应该做什么 ​

安装完成并不代表真正能顺畅使用，后续还要做几件事。

1. 先确认是否安装成功 ​

安装完成后，先看脚本有没有提示成功，或者 OpenClaw 控制面板有没有正常启动。 如果能正常打开，一般说明基础环境已经没问题了。 如果没有自动打开，也不要慌，先确认几个核心依赖有没有装好：

  • Node.js
  • Git
  • pnpm
  • OpenClaw 只要这几个正常，后面一般都能继续往下配。

2. 完成首次模型配置 ​

第一次使用时，通常还需要配置：

  • AI 厂商
  • API Key
  • 默认模型 这一步很关键。 很多人以为“安装完就能直接聊”，结果真正卡住的其实不是安装，而是没有配好模型和密钥。 所以安装完成之后，重点不是反复重装，而是把模型配置补完整。

3. 先做一次基础测试 ​

建议安装完成后，先不要急着上复杂任务。 可以先做几个最简单的测试，比如：

  • 看是否能正常启动
  • 看是否能调用模型
  • 看是否能进入控制面板
  • 看基本命令是否可用 先确认整条链路是通的，再去折腾高级玩法，这样效率最高。

4. 不要一上来就给太高权限 ​

OpenClaw 这类工具通常具备比较高的本地操作权限，能读写文件、执行命令、调用系统能力。 所以真正开始使用后，要注意两点：

  • 不要一开始就把整个磁盘都开放给它
  • 敏感目录、私密文件、重要项目建议单独控制权限 工具很强，但权限这东西像电锯，切木头很好使，乱挥也很精彩。

5. 遇到问题先排查“环境”和“配置” ​

后续如果不能正常使用，优先排查这两类问题：

  • 环境问题：依赖没装完整、命令找不到、路径异常
  • 配置问题：模型没选对、API Key 没填对、默认模型不可用 很多报错看起来像“大问题”，其实往往只是某个配置项没填好。

三、实际使用上的建议 ​

可以记住这几条最实用的建议：

第一，先安装，再验证，再配置。 ​

不要命令一跑完就默认万事大吉，最好顺手确认一下是否真的可用。

第二，先跑通最基础功能。 ​

先确保能启动、能连模型、能正常交互，再去玩更复杂的能力。

第三，遇到问题别先怀疑自己电脑坏了。 ​

大多数情况，不是脚本坏了，就是环境变量、依赖版本、模型配置这几个地方出了小岔子。

第四，安全意识要在线。 ​

这类工具很强，但权限也大。生产力工具是好东西，别最后变成“自动帮你扩大事故半径”的小猛兽。

四、一句话总结 ​

整个流程其实很简单：先在对应系统里执行一键安装命令，等脚本自动完成依赖和 OpenClaw 安装；安装成功后，再完成模型配置、做基础测试，最后再正式开始使用。