网上关于OpenClaw的教程很多，但大部分要么只讲了安装那三分钟，要么就直接跳到高级功能定制。中间那个"从环境配置到成功跑起来"的过程反而很少被仔细写出来。这篇文章专门补这个缺口——按时间线记录我从零开始搭建OpenClaw环境的完整过程，包括踩过的坑和对应的解法。

OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

Day 1：环境准备

我的目标是在一台Windows Server 2019（之前只用来跑数据库的闲置机器）上部署OpenClaw。第一步是确认系统环境。

# 检查Node.js
node --version
# → v16.20.0（版本太低，需要升级）

# 检查npm
npm --version
# → 8.19.0

# 检查可用内存
# 任务管理器 → 性能 → 内存
# → 可用 10GB（够用）

Node版本不满足要求（需要18+），所以先装nvm-windows来管理Node版本。

# 下载nvm-windows安装器
# https://github.com/coreybutler/nvm-windows/releases
# 选择 nvm-setup.exe 安装

# 安装完后重启终端
nvm list available       # 查看可用版本
nvm install 18.17.0       # 安装Node 18 LTS
nvm use 18.17.0          # 切换到18

node --version
# → v18.17.0 ✓

这里有个小细节：装nvm-windows之前，如果系统里已经装了Node，建议先卸载。不然nvm切换版本之后，某些路径可能还指向旧的Node安装目录。我第一次就是因为没卸干净，导致 nvm use 之后跑 node --version 还是显示旧版本。

Day 1下午：配置镜像源和安装依赖

# 配置npm镜像（国内网络必备）
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry
# → https://registry.npmmirror.com/ ✓

然后克隆项目并安装依赖：

git clone https://github.com/nicepkg/openclaw.git
cd openclaw
npm install

npm install 跑了大概2分钟（配了镜像之后速度还行）。没配镜像的话，之前试过一次，等了15分钟还没跑完就放弃了。

Day 1傍晚：配置API Key并首次启动

# 创建环境变量文件
cp .env.example .env

# 用VS Code编辑（避免记事本的BOM问题）
code .env

我用的是智谱AI的API Key。在.env里填入：

ZHIPU_API_KEY=your_actual_key_here

然后修改配置文件：

# config.yaml 核心配置
models:
  - id: "glm"
    provider: "zhipu"
    model: "glm-4-flash"
    maxTokens: 4096

gateway:
  port: 3780  # 避开Hyper-V保留端口
  host: "0.0.0.0"

启动：

npm run gateway

# 输出：
# [Gateway] Initializing...
# [Gateway] Loading config from ~/.qclaw/config.yaml
# [Gateway] Agent "assistant" loaded
# [Gateway] Listening on http://0.0.0.0:3780

看到 "Listening" 就说明成功了。浏览器打开 http://localhost:3780，发了条"你好"，两秒内收到回复。

第一天到这里就完成了。从零开始大概花了4-5个小时，其中大部分时间花在Node版本管理和排查端口冲突上。

Day 2：多通道配置和Skill安装

跑通基本功能之后，我开始折腾更进阶的配置。

添加Telegram通道

# config.yaml 中添加
channels:
  telegram:
    botToken: "${TELEGRAM_BOT_TOKEN}"
    allowedUsers:
      - "你的TelegramID"

# .env 中添加
TELEGRAM_BOT_TOKEN=你的Bot Token

Telegram Bot的创建流程就不展开了，在BotFather里操作就行。配置好之后，我在Telegram里发消息测试——延迟比Web界面多了大概50ms，可以接受。

安装额外Skill

# 查看可用的Skill
openclaw skill list

# 安装邮件Skill
openclaw skill install email

# 安装Excel操作Skill
openclaw skill install xlsx

安装完之后不需要重启Gateway，新Skill会在下一次对话时自动加载。

Day 2下午：性能调优

跑了一上午之后，我观察了一下资源占用情况：

Gateway进程：~180MB内存，CPU空闲时 <2%
Agent进程：  ~250MB内存，空闲时几乎不占CPU
Node.js堆：  默认1.7GB上限，实际用到300-400MB

对于8GB内存的机器来说，这个占用完全没问题。但如果你想跑多个Agent（比如3-4个），建议调大Node的堆上限：

# 在启动脚本里加参数
NODE_OPTIONS="--max-old-space-size=2048" npm run gateway

整体搭建过程两天就完成了。最大的感悟是：OpenClaw的环境门槛主要集中在Node.js版本管理上，其他的配置都比较直白。如果你用官方安装包部署，连Node都不用自己装，半小时就能搞定。