OpenClaw 小白友好型部署手册（Windows + Linux）

iwr -useb https://openclaw.ai/install.ps1 | iex

这个过程会自动下载 OpenClaw 源码、安装依赖并启动初始化流程。网络正常的话，几分钟内就能走完。

如果终端里看到安装成功的提示，说明核心程序已经起来了。

3）初始化配置

安装结束后，通常会进入一个交互式配置界面。这里不用紧张，基本就是用方向键选择、回车确认。

你可以按这个思路来：

• 风险提示，选择确认。
• 启动模式，选快速开始，不建议一上来就碰高级模式。
• 模型服务商，选择 ZhipuAI 或对应显示名称。
• 模型，选你已经开通的型号，比如 GLM-4.7。
• API Key，粘贴你提前准备好的密钥。
• 额外功能，比如 Skills、IM 之类的，第一次部署可以先不装，后面再补。
• 访问方式，选择打开 Web UI。

如果浏览器没有自动跳转，也可以直接访问：

http://localhost:3000

4）确认是否部署成功

别急着结束，最好做两个简单验证。

先在对话面板里发一句简单的话，比如'你好'。如果模型能正常回复，说明大模型连接没问题。

再试一个稍微具体一点的任务，比如让它创建一个文件夹。只要它能正确执行，说明 Agent 的基础能力已经跑通了。

Linux（Ubuntu）部署步骤

Linux 下的流程和 Windows 很像，只是命令都在终端里完成。Ubuntu 用户照着执行会比较顺手。

1）先更新系统并确认版本

打开终端，先把系统包更新一下：

sudo apt update && sudo apt upgrade -y

更新完成后，可以顺手确认一下系统版本：

lsb_release -a

看到 Ubuntu 22.04 就比较稳妥。其他发行版大体思路相同，但命令细节可能略有差别。

2）安装 Node.js 和 Git

安装 Node.js

先执行 NodeSource 的安装脚本，再安装 nodejs：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

安装完后验证一下：

node -v

安装 Git

sudo apt install -y git

完成后检查版本：

git -v

3）一键部署 OpenClaw

准备工作都到位后，直接执行安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动处理大部分安装流程，中途如果提示输入密码，输入当前用户的系统密码即可。

当终端出现安装成功的信息时，说明核心程序已经部署好了。

4）初始化配置

后面的交互配置和 Windows 基本一致：

• 选择 ZhipuAI 作为模型服务商；
• 选择你要使用的模型；
• 粘贴 API Key；
• 额外功能先跳过；
• 进入 Web UI 后再做进一步配置。

如果浏览器没自动打开，手动访问：

http://localhost:3000

5）验证是否可用

进入界面后，发一条简单消息测试模型连接；再下一个实际一点的任务，比如创建一个目录。能正常执行，说明部署流程已经打通。

常见问题排查

API Key 粘贴后提示无效

通常是复制时带进了空格，或者密钥没复制完整。建议先贴到记事本里检查一下，再重新复制到配置界面。

关闭终端后，Web UI 打不开

这一般是后台服务被关掉了。重新启动 OpenClaw 对应的服务，再刷新浏览器即可。

提示 Config invalid

这类报错通常意味着新版本的配置方式和旧教程不一致，API Key 可能需要放到独立配置文件里。按当前版本要求重新整理配置后，再重启服务。

依赖下载特别慢

大概率是默认源访问不畅。Windows 和 Linux 都建议切换到国内镜像源，再重新执行安装。

Windows 提示命令不存在

多半是 Node.js 或 Git 没装好，或者环境变量没有生效。重启终端后再试，如果还是不行，就重新安装并确认相关路径已经加入 PATH。

Linux 提示权限不足

把命令改成 sudo 执行通常就能解决。很多系统级安装命令都需要管理员权限。

后续使用建议

• 如果 OpenClaw 需要操作你的文件系统，建议限制工作目录，不要让它随意访问整个磁盘。
• 日常测试时，先从创建文件、打开文档这类简单任务开始，熟悉以后再尝试复杂流程。
• 版本更新和开机自启这类功能，可以在确认主流程稳定后再去配置，这样排障会轻松很多。

结语

OpenClaw 的部署并没有看起来那么复杂。先把 Node.js、Git 和网络环境准备好，再走脚本安装，最后完成初始化配置，整套流程就闭环了。对新手来说，真正要注意的不是命令多，而是环境是否干净、密钥是否正确、路径是否规范。把这些细节处理好，部署通常都能一次跑通。