openClaw的部署教程（部署安装教程）

一、OpenClaw 是什么

你可以把 OpenClaw 理解成：

一个能跑在你电脑或服务器上的 AI 助手“底座”。

装好以后，它一般会提供这些能力：

本地命令行管理

网页控制台

对接模型

对接聊天渠道

管理配置、插件、工作目录

官方文档里把它描述为可以快速安装、启动 Gateway、再通过浏览器控制台使用。

二、最适合谁看这篇教程

这篇教程适合这几类人：

完全没装过 OpenClaw

看官方文档觉得太散

只想先装起来，不想先研究原理

想知道每一步“正常现象”是什么

三、先决定：你准备装在哪

方案 1：装在自己的电脑上

适合：

自己先测试

本地体验

不想一上来买服务器

方案 2：装在云服务器上

适合：

想长期运行

想对外访问

想挂消息渠道持续在线

第一次接触，建议先本地装。
先在本地跑通，再搬服务器，成功率最高。

四、安装前你要准备什么

根据官方安装文档，安装脚本会帮你处理 Node 检测和安装引导。

你真正需要准备的是：

一台电脑或服务器

能联网

能打开终端

有管理员权限更好

准备好后面要接入的模型密钥（如果你要连外部模型）

如果你只是想先把 OpenClaw 本体装上，哪怕暂时没有模型密钥，也可以先装。

五、最简单安装方式

macOS / Linux / WSL2

官方推荐命令：

这条命令做的事，你可以理解成：

1.下载官方安装脚本

2.自动检查环境

3.安装 OpenClaw CLI

4.进入初始引导

Windows

官方当前推荐 Windows 走 WSL2，而不是直接原生装。官方文档明确写了：Windows 推荐通过 WSL2（建议 Ubuntu）运行，这样兼容性更好

PowerShell 安装命令是：

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

但如果你是 Windows 新手，我更建议你：

1.先安装 WSL2

2.装 Ubuntu

3.进入 Ubuntu 后，用上面的 Linux 命令安装

这样后续很多命令、路径、权限问题都会少很多。
安装步揍
第一步：
选择 Yes

第二步：
选择 QuickStart

第三步:
因为选择是咱们的api中转，这里跳过Skip for now

第四步:
All providers(选择什么都无所谓)

第五步:
Skip for now

第六步:
Skip for now

第七步:
No(现在skill不着急安装)

第八步:
选择这些内容安装( boot-md 、command-logger 、session-memory)

第九步:
选择 Do this later

第十步:

如图这是我们访问的地址

输入地址就可以访问了

http://localhost:18789

配置秘钥和内容

vim ~/.openclaw/openclaw.json

第一步:
在原文件中找到：

"agents": {
  "defaults": {
    "workspace": "/Users/.openclaw/workspace"
  }
},

改成：

"agents": {
  "defaults": {
    "workspace": "/Users/lishuai/.openclaw/workspace",
    "model": {
      "primary": "apiqik/gpt-4.1"
    }
  }
},

第二步

在 agents 后面、tools 前面，加一段：

"models": {
  "providers": {
    "apiqik": {
      "baseUrl": "https://api.apiqik.online/v1",
      "apiKey": "你的第三方token",
      "api": "openai-completions",
      "models": [
        {
          "id": "gpt-4.1",
          "name": "GPT-4.1"
        }
      ]
    }
  }
},

如图所示：

不同的可以看令牌管理配置：
令牌分组（Token Group）使用教程

六、安装完成后，先不要急着配一堆东西

很多新手一装完就开始改配置，结果越改越乱。

正确顺序是：

1.先确认安装成功

2.再运行引导

3.再确认工作目录生成了

4.最后再接模型、接插件、接消息渠道

七、怎么确认安装成功

安装完以后，先执行：

openclaw --version

如果能输出版本号，说明 CLI 已经在 PATH 里了。

官方插件文档里也把 openclaw --version 当作验证 OpenClaw 是否已安装成功的方法之一。

如果这里提示：

zsh: command not found: openclaw

一般就这几种原因：

原因 1：没装成功

最直接，重新跑安装脚本。

原因 2：装了，但终端还没刷新

执行：

exec $SHELL -l

或者直接关闭终端重开。

原因 3：PATH 没生效

这种通常是安装脚本跑完后，当前 shell 没读到新环境。

八、第一次配置，优先用官方引导

官方配置页明确建议新手从 openclaw onboard 开始，用交互方式做初始化。

执行：

openclaw onboard

你可以把它理解为：

“别让我手改配置文件，直接一步步问我。”

这对新手最友好。

九、OpenClaw 默认把东西放哪

官方说明里提到，OpenClaw 默认使用：

~/.openclaw/workspace

作为工作目录，并会自动创建一些初始化文件，比如 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md。

所以安装成功后，你可以看一下：

ls -la ~/.openclaw
ls -la ~/.openclaw/workspace

如果这些目录和文件出现了，说明初始化基本走通了。

十、从用户角度理解这些目录，不要被吓到

很多人看到一堆 md 文件就慌了。

你不用一开始就研究每个文件。

先这样理解就够了：

workspace：你的 AI 工作空间

AGENTS.md：像“角色说明”

TOOLS.md：像“可用工具说明”

USER.md：像“用户偏好/上下文”

SOUL.md：像“整体行为风格”

HEARTBEAT.md：像“运行节奏或心跳相关内容”

你先知道：这些是 OpenClaw 帮你组织 AI 行为的地方，不是系统报错文件。

十一、第一次能跑起来，什么算成功

对新手来说，不要求你一上来就接入 Telegram、Discord、插件、自动化。

第一阶段成功标准只有 3 个：

成功 1：命令能执行

openclaw --version

成功 2：引导能跑

openclaw onboard

成功 3：工作目录生成

~/.openclaw/workspace

只要这三个成立，就说明 “OpenClaw 本体已经安装成功”。

十二、以后要升级，别乱删重装

官方更新文档给出的首选方式是：再次运行官网安装脚本，它会检测已有安装并原地升级。

如果你不想重新跑 onboarding，可以加：

这个比你手动删文件、再到处补环境变量稳得多。

十三、想跳过引导只安装，也可以

官方安装页给了跳过 onboarding 的方式：

适合：

你已经懂配置

你想先装 CLI

你后面自己再配

但如果你是新手，不建议一开始跳过。

十四、如果你想折腾源码方式安装

官方 FAQ 和安装器文档提到，也支持用 git / source checkout 的方式安装，适合想看源码、深度改造的人。
比如：

但我站在用户角度说实话：

新手不要一开始选这个。

因为你会立刻遇到：

仓库结构

pnpm / node 版本

源码依赖

构建流程

更新冲突

对第一次部署的人来说，npm/安装脚本方式最省心。
打开页面
输入想要说的对话

🎉 恭喜，配置成功了！

openClaw的部署教程（部署安装教程）

一、OpenClaw 是什么#

二、最适合谁看这篇教程#

三、先决定：你准备装在哪#

四、安装前你要准备什么#

五、最简单安装方式#

六、安装完成后，先不要急着配一堆东西#

七、怎么确认安装成功#

八、第一次配置，优先用官方引导#

九、OpenClaw 默认把东西放哪#

十、从用户角度理解这些目录，不要被吓到#

十一、第一次能跑起来，什么算成功#