OpenClaw 安装与配置指南

这篇文章整理一下 OpenClaw 的安装、基础配置、飞书接入和常见运行方式，适合直接部署到 Linux 服务器上使用。

一、准备资料

开始前建议先准备好下面这些内容：

一个大模型 API Key
一个飞书账号（可选，如果你要接入飞书机器人）

二、安装前说明

强烈不建议直接使用 root 用户安装 OpenClaw，更推荐使用普通用户，例如 claw。

OpenClaw 运行依赖 Node.js 22+，本文统一使用 Node.js 24.15.0，先检查当前版本：

node --version
node -v

三、安装 Node.js

这里以 Linux x64 环境为例，本文统一使用 Node.js 24.15.0 这个长期支持版本安装 OpenClaw。

1. 下载 Node.js

国内环境用镜像下载更快。

# 国内镜像，通常更快
wget https://npmmirror.com/mirrors/node/v24.15.0/node-v24.15.0-linux-x64.tar.xz

# 官方地址
wget https://nodejs.org/dist/v24.15.0/node-v24.15.0-linux-x64.tar.xz

2. 解压并放到固定目录

mkdir -p $HOME/nodejs
tar -xf node-v24.15.0-linux-x64.tar.xz
mv node-v24.15.0-linux-x64 nodejs

3. 配置环境变量

直接写入

echo 'export PATH=$HOME/nodejs/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

手动编辑：

nano ~/.bashrc

在文件末尾加入：

export NODE_HOME=$HOME/nodejs
export PATH=$NODE_HOME/bin:$PATH

然后执行：

source ~/.bashrc

4. 验证 Node.js 是否安装成功

node -v
npm -v

四、配置 npm 国内镜像

这一步非常推荐，安装依赖会快很多。

npm config set registry https://registry.npmmirror.com

验证是否设置成功

npm config get registry

正常情况下应该输出：

https://registry.npmmirror.com/

如果后续想恢复官方源：

npm config set registry https://registry.npmjs.org

五、安装 OpenClaw

原文推荐安装下面这个版本：

npm install -g openclaw

也可以写成：

npm i -g openclaw

如果安装过程卡住，可以先清理缓存再重试：

npm cache clean -f

六、首次配置 OpenClaw

首次配置前，请先准备好大模型和飞书相关资料。

openclaw onboard --install-daemon

选择Yes

选择QuickStart

选择你的API提供商并输入apikey

注意这里一定要选择Skip for now

选择Skip for now

完成初始化后，启动网关：

openclaw gateway

七、飞书配对

参考飞书官方教程

八、查看 token

有几种常见方式可以拿到 token：

cat ~/.openclaw/openclaw.json | grep token

或者在配置过程中直接复制：

openclaw config fp

或者：

openclaw dashboard --no-open

九、后台运行 OpenClaw

前台运行：

openclaw gateway

查看进程：

pgrep -f "openclaw gateway"

停止进程：

kill 进程ID

十、Web 访问方式

如果你是部署在远程服务器上，可以先做端口转发：

ssh -f -N -L 18789:127.0.0.1:18789 root@IP地址

如果 SSH 端口不是默认的 22：

ssh -f -N -L 18789:127.0.0.1:18789 root@IP地址 -p 22022

若你的服务器有GUI，他将自动弹出窗口，若没有则会给你一个带有Token的URL，做好ssh隧道后就可以访问链接了

http://127.0.0.1:18789/#token=你的token

十一、补充建议

如果你是准备把这套流程长期跑在服务器上，建议：

不要用 root 直接运行 OpenClaw
不要全局安装nodejs
提前配置好 npm 国内镜像
把 openclaw gateway 放到后台运行
保存好 token 和飞书配对信息

这样后续维护、卸载会轻松很多。

标签：openclaw

安装OpenClaw并绑定飞书机器人