Linux 服务器安装 OpenClaw 全流程教程（nvm + npm 方式）

OpenClaw 是一款多渠道 AI 网关，支持飞书、微信、Discord 等多平台消息集成。本文记录在 Linux 服务器上使用 nvm + npm从零安装 OpenClaw 的完整过程。

一、环境准备

1.1 安装 nvm（Node 版本管理器）

SSH 登录服务器后，执行以下命令安装 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

安装完成后，加载 nvm 环境：

source ~/.nvm/nvm.sh

验证安装：

nvm --version# 输出：0.40.3

提示：如果 nvm 命令未找到，退出终端重新登录，或执行 source ~/.bashrc（Debian/Ubuntu）或 source ~/.zshrc（如使用 zsh）。

1.2 安装 Node.js 和 npm

通过 nvm 安装最新版 Node.js（自带 npm）：

nvm install node

验证版本：

node --version   # v25.8.1npm --version    # 11.11.0

注意：本教程仅使用 nvm + npm 安装，不涉及 podman、docker 等容器工具。

二、安装 OpenClaw

2.1 使用 npm 安装（推荐）

OpenClaw 有两种安装方式对比：

已有 nvm + npm 环境的情况下，强烈推荐使用 npm 方式：

npm i -g openclaw

安装完成后验证：

openclaw --version

2.2 启动配置向导

安装完成后运行：

openclaw onboard

进入交互式配置流程。

三、配置向导详解

3.1 选择 AI 模型提供商

Filter models by provider● All providers          ← 推荐，使用所有提供商○ anthropic              ← Claude 系列○ openai                 ← GPT 系列○ google                 ← Gemini 系列○ kimi-coding            ← 月之暗面，中文友好○ openrouter             ← 聚合平台...

建议选择 All providers，后续可按需调整。

3.2 配置默认模型（以 Qwen 为例）

Qwen OAuth 认证

选择 Qwen 作为模型提供商时，系统会自动启动 OAuth 认证流程：

1. 1. 系统弹出授权链接，如：https://chat.qwen.ai/authorize?user_code=SKF1E1H4
2. 2. 在浏览器中打开该链接，登录 Qwen 账号并授权
3. 3. 授权成功后，系统自动获取 Token，无需手动输入 API Key

◇  Qwen OAuth complete◇  Provider notes│  Qwen OAuth tokens auto-refresh.│  Base URL defaults to https://portal.qwen.ai/v1

说明：Qwen 使用 OAuth 认证，Token 会自动刷新，比 API Key 更方便。如果刷新失败，重新运行 openclaw onboard 即可。

设置默认模型

OAuth 完成后，系统提示选择默认模型：

◆  Default model│  ○ 使用系统推荐│  ● Enter model manually    ← 选择手动输入

选择 Enter model manually，输入：

qwen-portal/qwen3.5-plus

模型名称格式：提供商/模型ID，如 qwen-portal/qwen3.5-plus

各提供商认证方式对比

3.3 配置消息渠道（可选）

OpenClaw 支持多种消息渠道，按需选择：

如不需要消息集成，可选择 Skip for now。

飞书配置示例

如选择飞书，需要：

1. 1. 在飞书开放平台（https://open.feishu.cn/）创建应用
2. 2. 获取 App ID、App Secret、加密密钥
3. 3. 配置事件订阅（WebSocket 长连接模式）

详细步骤参考飞书开放平台文档。

3.4 搜索提供商配置

Search provider● Brave Search             ← 需付费 API（已无免费额度）○ Gemini (Google Search)○ Kimi (Moonshot)○ Skip for now             ← 推荐先跳过

建议选择 Skip for now。OpenClaw 内置的 web_search Skill 已经可以满足基本搜索需求，无需额外配置付费 API。

3.5 可选 API 配置

以下 API 均为可选，全部选 No 即可：

以上功能均可在后续需要时，编辑配置文件 ~/.openclaw/openclaw.json 添加。

3.6 Hooks（钩子）配置

Enable hooks?◻ Skip for now◻ 🚀 boot-md                  ← 启动时生成报告◻ 📎 bootstrap-extra-files    ← 加载额外配置◻ 📝 command-logger           ← 记录命令日志◻ 💾 session-memory           ← 会话记忆持久化（推荐）

四、配置文件说明

所有配置保存在 ~/.openclaw/openclaw.json，后续可直接编辑此文件修改配置：

vim ~/.openclaw/openclaw.json

五、常用命令

# 启动 OpenClawopenclaw# 运行配置向导openclaw onboard# 健康检查openclaw doctor# 查看当前配置openclaw config show# 更新插件openclaw plugins update --all# 更新 OpenClawnpm update -g openclaw# 查看安装路径npm list -g openclaw

六、系统要求

七、常见问题

7.1 nvm 命令未找到

问题：执行 nvm --version 提示 command not found

解决：

# 重新加载环境变量source ~/.bashrc    # Debian/Ubuntusource ~/.zshrc     # 如使用 zsh# 或退出终端重新登录

7.2 npm 全局包权限问题

问题：执行 npm i -g openclaw 提示权限错误

解决：

# 方法1：使用 nvm 安装的 Node.js（推荐）# nvm 会自动处理权限问题# 方法2：配置 npm 全局目录mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrcsource ~/.bashrc

7.3 OAuth 授权失败

问题：Qwen OAuth 授权时浏览器无法打开

解决：

# 手动复制授权链接到浏览器# 链接格式：https://chat.qwen.ai/authorize?user_code=XXXXXX# 授权完成后，返回终端继续配置

八、总结

整个安装流程：

安装 nvm → 安装 Node.js/npm → npm 安装 OpenClaw → 运行配置向导→ 选择模型提供商 → OAuth 授权（如 Qwen）→ 设置默认模型→ 配置消息渠道（可选）→ 配置搜索/API（建议跳过）→ 配置 Hooks → 完成

核心要点：

1. 1. 使用 npm i -g openclaw 安装，无需容器工具
2. 2. 部分提供商（如 Qwen）使用 OAuth 认证，无需手动输入 API Key
3. 3. 默认模型格式为 提供商/模型ID
4. 4. 消息渠道、搜索、图像生成等功能均为可选
5. 5. 所有配置保存在 ~/.openclaw/openclaw.json，可随时修改

本文基于 OpenClaw 2026.3.13 版本，适用于主流 Linux 发行版（Ubuntu、Debian、CentOS、RHEL 等），Node.js v25.8.1，纯 nvm + npm 方式安装。