OpenClaw 教程二：首次配置与启动 — 5分钟快速上手指南

上一讲我们了解了 OpenClaw 是什么，这一讲来说说怎么让它跑起来。

很多人看到新工具就发怵，觉得配置肯定很复杂。其实 OpenClaw 的配置非常简单，跟着我做，5分钟就能搞定。

一、环境准备

在安装之前，先确认一下你的环境：

1. 操作系统

• Linux — 完全支持，推荐 Ubuntu 20.04+
• macOS — 完全支持
• Windows — 推荐使用 WSL（Windows Subsystem for Linux）

我个人用的是 Linux 服务器版本，稳定省心。如果你用的是 Windows，装个 WSL 就行，跟本地跑 Linux 没什么区别。

2. Node.js 环境

OpenClaw 需要 Node.js v18 或更高版本。检查一下你有没有：

node --version
# 如果显示 v18.x.x 就 OK
# 如果没有，去 https://nodejs.org 下载

如果没有，去 Node.js 官网下载 LTS 版本。Windows 和 macOS 直接安装包，Linux 可以用 nvm 管理多版本。

3. 网络要求

• 能访问 GitHub（下载技能等）
• 能访问你需要集成的平台（飞书、Telegram 等）

如果是国内服务器，可能需要配置代理，这个后面再说。

二、安装步骤

环境确认好了，现在开始安装：

第一步：全局安装

npm install -g openclaw

这行命令搞定。npm 是 Node.js 的包管理器，会自动下载安装 OpenClaw。

如果报错说权限不够，加上 sudo：

sudo npm install -g openclaw

第二步：初始化配置

openclaw init

首次运行会初始化配置目录和默认文件。

第三步：启动 Gateway

openclaw gateway start

Gateway 是 OpenClaw 的核心服务，启动之后就可以用了。

看到类似这样的输出就说明启动成功了：

Gateway started on http://0.0.0.0:8080

三、配置文件详解

首次运行会在 ~/.openclaw/ 目录生成配置。我来说说主要文件：

~/.openclaw/
├── config.yaml        # 主配置文件
├── plugins/          # 插件配置
└── skills/           # 技能目录

config.yaml

这是主配置文件，包含核心设置。

gateway:
  host: "0.0.0.0"
  port: 8080

agents:
  default:
    model: "minimax/MiniMax-M2.5"
    thinking: "low"

channels:
  - type: "feishu"
    app_id: "your_app_id"
    app_secret: "your_secret"

我解释一下主要配置项：

添加飞书配置

如果你要用飞书，需要配置飞书应用：

channels:
  - type: "feishu"
    app_id: "你的飞书应用ID"
    app_secret: "你的飞书应用Secret"

飞书应用需要在飞书开放平台创建。

添加 Telegram 配置

channels:
  - type: "telegram"
    bot_token: "你的Telegram机器人Token"

Telegram 机器人需要找 @BotFather 创建。

四、启动与停止

启动 Gateway

# 方式一：CLI 启动
openclaw gateway start

# 方式二：后台运行
openclaw gateway start &

# 方式三：系统服务（需要配置）

查看状态

openclaw gateway status

会显示当前运行状态、启动时间、连接数等。

重启 Gateway

openclaw gateway restart

修改配置后需要重启生效。

停止 Gateway

openclaw gateway stop

五、验证安装

安装完成后，验证一下：

openclaw --version

应该显示版本号。

然后访问：

http://你的服务器IP:8080

如果能看到 OpenClaw 的界面，就说明安装成功了。

六、常见问题

Q1: 安装报错 Permission denied

加上 sudo，或者修复 npm 目录权限：

sudo chown -R $(whoami) ~/.npm

Q2: 端口被占用

改个端口：

openclaw gateway start --port 8888

Q3: 连不上网

配置代理：

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

Q4: 飞书消息发不出去

检查配置是否正确， token 是否过期。如果是生产环境，需要配置 verification_token。

七、接下来的教程

安装好了，下一篇我们来说说核心指令，这些都是你以后每天都会用到的。

传送门：教程三：核心指令速查

本文作者：小文 · 2026年5月