在云服务器上安装 OpenClaw(官方一键安装脚本)

操作步骤

官方推荐的方式，脚本会自动检测并安装 Node.js 和所有依赖，无需手动配置环境。

bash

复制代码

# 1. SSH 连接到你的云服务器
ssh ubuntu@你的服务器IP

# 2. 执行官方安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

# 3. 安装完成后，启动配置向导
openclaw onboard --install-daemon

配置向导说明：

进入引导界面后，依次选择：yes → QuickStart → Use existing values
在模型选择界面，可以选择：
- 云端付费模型：如 OpenAI、Anthropic、通义千问等（需 API Key）
- 本地免费模型：通过 Ollama 部署本地模型（如 qwen3.5:9b）

系统要求：

内存 ≥ 2GB（推荐 4GB+）
支持 Ubuntu 22.04（实际安装验证版本）

验证安装

安装完成后，可以通过以下方式验证：

bash

复制代码

# 检查 OpenClaw 版本
openclaw --version

# 进入终端对话模式测试
openclaw tui

如果能正常进入对话界面，说明部署成功

过程中提示1

I understand this is personal-by-default and shared/multi-user use │ requires lock-down. Continue?

这是 OpenClaw 安装过程中的一个安全确认提示，问你是否要继续安装。

提示含义

OpenClaw 默认配置为单用户个人使用 模式，如果你打算在服务器上让多个人访问 或作为公共服务运行，需要进行额外的安全加固（如配置认证、权限隔离等）。

如何回答

如果你是个人使用（选择 Yes）

只有你自己通过 SSH 隧道或本地访问，可以直接继续：

bash

复制代码

# 输入 y 然后按回车
y

如果你想多用户共享（生产环境）

选择 No，先进行安全配置：

bash

复制代码

# 输入 n 然后按回车
n

然后执行以下安全加固步骤：

bash

复制代码

# 1. 设置管理员密码/Token
openclaw config set gateway.auth.token "你的强密码"

# 2. 配置 HTTPS（如需公网访问）
openclaw config set gateway.auth.https true

# 3. 限制监听地址（只允许本地访问）
openclaw config set gateway.bind "127.0.0.1:18789"

配置完成后再继续安装。

过程中提示2

ubuntu@VM-0-11-ubuntu:~/home $openclaw --version openclaw: command not found ubuntu@VM-0-11-ubuntu:\~/home$ openclaw tui openclaw: command not found

openclaw: command not found 这个错误很常见，通常是因为 npm 全局安装的目录没有被添加到系统的 PATH 环境变量中。以下是完整的排查和修复步骤：

问题原因分析

出现这个错误的原因有几种可能：

Node.js 版本过低：OpenClaw 要求 Node.js 22+
npm 全局 bin 目录不在 PATH 中：系统找不到 openclaw 命令
安装过程出现问题：网络或权限导致安装不完整
使用了错误的命令名 ：旧版本曾用名 moltbot 或 clawdbot

步骤一：检查 Node.js 版本

bash

复制代码

node -v

要求：必须 ≥ 22.x

如果版本低于 22，先升级 Node.js：

bash

复制代码

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证版本
node -v

步骤二：查找 npm 全局安装位置

bash

复制代码

# 查看 npm 全局 bin 目录
npm prefix -g

输出示例：

Linux 通常是 /usr/local/lib/node_modules 或 /home/ubuntu/.npm-global

步骤三：检查 PATH 是否包含该目录

bash

复制代码

# 查看当前 PATH
echo $PATH

检查 npm prefix -g 的输出路径加上 /bin 是否出现在 PATH 中。

步骤四：将 npm bin 目录添加到 PATH

方法 A：永久添加到 PATH（推荐）

bash

复制代码

# 确定你的 shell 类型
echo $SHELL

# 如果是 bash，编辑 ~/.bashrc
nano ~/.bashrc

# 如果是 zsh，编辑 ~/.zshrc
nano ~/.zshrc

在文件末尾添加以下内容（路径根据 npm prefix -g 输出调整）：

bash

复制代码

export PATH="$(npm prefix -g)/bin:$PATH"

保存后刷新配置：

bash

复制代码

source ~/.bashrc   # 或 source ~/.zshrc

云服务器上安装好后显示如下

🦞 OpenClaw 2026.5.7 (eeef486) Your AI assistant, now without the $3,499 headset. openclaw tui - ws://127.0.0.1:18789 - agent main - session main connecting | idle session agent:main:main HEARTBEAT_OK gateway reconnected | idle agent main | session main | deepseek/deepseek-v4-flash | think high | tokens 11k/1.0m (1%)

如何使用

1. 基础对话（在当前 TUI 界面）

你现在已经处于对话模式，直接输入文字即可与 AI 对话：

text

复制代码

你好，请介绍一下你自己

text

复制代码

帮我写一个 Python 脚本备份日志文件

text

复制代码

解释一下什么是 Docker 容器

快捷键：

Enter - 发送消息
Ctrl+C - 退出 TUI
Ctrl+L - 清屏
↑/↓ - 浏览历史消息

2. 切换不同的 Agent（代理模式）

bash

复制代码

# 在 TUI 中输入以下命令（注意要以 / 开头）
/agent code       # 切换到代码助手模式
/agent chat       # 切换到对话模式
/agent research   # 切换到研究分析模式

3. 查看和管理会话

bash

复制代码

/session list     # 查看所有会话
/session new      # 创建新会话
/session history  # 查看当前会话历史
/clear            # 清除当前会话上下文

4. 调整模型参数

bash

复制代码

/model list       # 查看可用模型
/model deepseek/deepseek-v4-flash  # 切换到指定模型
/temp 0.7         # 调整温度参数（0-1）
/max 4096         # 设置最大输出长度

在云服务器上安装 OpenClaw(官方一键安装脚本)

操作步骤

验证安装

过程中提示1

提示含义

如何回答

推荐操作

过程中提示2

问题原因分析

如何使用

1. 基础对话（在当前 TUI 界面）

2. 切换不同的 Agent（代理模式）

3. 查看和管理会话

4. 调整模型参数