xshell如何安装openclaw 远程部署步骤

在 Windows 电脑上使用 Xshell 连接 Linux 服务器后，可以直接在远端安装 OpenClaw，并通过 SSH 隧道将服务器的控制台端口映射到本机。这样既能利用服务器的计算资源运行 AI 代理，又能通过本地浏览器安全地管理对话，无需在服务器公网开放额外端口。最终效果是在本地浏览器中打开 OpenClaw 控制台，发送消息并获得模型回复，而所有数据交互均通过加密的 SSH 通道完成。

本地浏览器通过SSH隧道访问远程OpenClaw控制台

OpenClaw 是一个运行在服务器端的 AI 代理框架，实际计算和模型调用都在 Linux 环境中进行。Xshell 在此过程中扮演两个角色：一是提供稳定的 SSH 终端用于执行安装命令，二是建立本地端口转发隧道，让本地浏览器能访问服务器内部的服务。开始前，请确保拥有一台已安装 Node.js 26.12.1 或更新 26.x 版本、npm 12 的 Linux 服务器，以及一个具有 sudo 权限或已配置好用户环境的普通账户。

1. 保存 SSH 会话，确认命令运行在服务器

打开 Xshell，点击【文件】→【新建】，创建一个新的会话属性。名称填写“OpenClaw服务器”，协议选择 SSH，主机填入服务器的 IP 地址，端口填写实际的 SSH 端口（默认为 22）。点击【连接】，首次连接时会提示核对主机指纹，确认无误后接受并输入账户密码登录。

登录成功后，终端显示的是 Linux 服务器的命令行界面。为了确认后续操作都在服务器上进行，分别执行以下命令：

whoami
node --version
npm --version

观察输出结果，whoami 应显示当前登录的服务器用户名，node 和 npm 的版本号需符合 OpenClaw 的要求（Node.js 26.x, npm 12）。如果版本不符或缺失，请先在服务器上完成环境配置。切勿将 Windows 本地的 Node 版本误认为是服务器环境，所有后续安装命令均在此 Xshell 窗口中执行。

在Xshell中确认服务器端的Node.js和npm版本

2. 通过 npm 安装，并核对 CLI 版本

在确认环境无误的 Xshell 终端中，执行全局安装命令。由于 OpenClaw 安装过程中需要运行构建脚本，且使用的是较新版本的 npm，需添加允许脚本执行的参数：

npm install -g openclaw@latest --allow-scripts=openclaw

等待安装进度条走完，期间不要关闭终端。安装完成后，立即验证命令行工具是否可用：

openclaw --version

如果终端返回了具体的版本号，说明安装成功。若提示“command not found”或类似错误，通常是因为 npm 的全局 bin 目录未加入当前用户的 PATH 环境变量。此时应根据安装结束时的提示，将相应路径加入 .bashrc 或 .zshrc，然后执行 source ~/.bashrc 重新加载配置，再次验证版本。避免直接使用 sudo 安装，以免导致权限混乱。

2. 通过 npm 安装，并核对 CLI 版本

3. 运行初始化，安装远端后台服务

OpenClaw 需要一个长期运行的后台服务（Gateway）来处理请求。执行以下命令启动交互式初始化向导，并自动安装 systemd 用户服务：

openclaw onboard --install-daemon

向导会引导你选择模型提供商（如 OpenAI、Anthropic 等）并配置 API 密钥。请按提示输入密钥，注意密钥不会在屏幕上显示。在配置网络监听时，选择仅监听本地回环地址（127.0.0.1），端口保持默认的 18789。这意味着服务只接受来自服务器内部的连接，外部无法直接访问，保障了安全性。

初始化完成后，检查服务状态：

openclaw gateway status
openclaw doctor

gateway status 应显示服务正在运行（active/running），doctor 命令会诊断潜在的配置问题。如果提示 systemd 用户服务未启用，可能需要管理员协助执行 loginctl enable-linger <用户名> 以允许用户在未登录时运行服务。

4. 在同一 Xshell 会话中添加本地转发

为了让 Windows 上的浏览器能访问服务器上的 OpenClaw 控制台，需要配置 SSH 隧道。在 Xshell 左侧会话管理器中，右键点击“OpenClaw服务器”会话，选择【属性】。进入【连接】→【SSH】→【隧道】选项卡，点击【添加】按钮。

按照下表填写隧道规则：

这里的逻辑是：当访问 Windows 本机的 18789 端口时，Xshell 会通过 SSH 连接将数据转发到服务器的 18789 端口。点击【确定】保存设置。如果当前会话已连接，建议断开后重新连接，以确保隧道规则生效。若本机 18789 端口被占用，可修改“侦听端口”为其他空闲端口（如 18790），但“目标端口”必须保持与服务器端一致。

配置本地端口转发规则以映射远程服务

5. 打开控制台，验证对话与退出后的服务状态

回到 Xshell 的服务器终端，获取控制台的访问地址：

openclaw dashboard --json

从输出的 JSON 数据中找到 browserUrl 字段，通常格式为 http://127.0.0.1:18789/...。复制该地址，在 Windows 的 Chrome 或 Edge 浏览器中打开。由于配置了 SSH 隧道，浏览器实际上是通过本地端口访问远程服务。

在控制台界面中，尝试发送一条测试消息，例如“请回复部署验证”。如果收到模型的正常回复，说明从浏览器到 Xshell 隧道，再到服务器 Gateway 和模型 API 的整条链路已打通。如果页面能打开但无回复，请检查 openclaw doctor 的诊断结果或 API 密钥配置。

最后，为了确保持久运行，即使断开 Xshell 连接，服务也应保持活跃。再次运行 openclaw gateway status 确认服务状态。断开 Xshell 会话后，本地隧道会中断，浏览器将无法访问，但服务器上的 OpenClaw 服务仍在后台运行。下次需要管理时，只需重新连接 Xshell 并建立隧道即可。记得备份包含 API 密钥的配置文件，但不要将其分享给他人。

发送测试消息验证端到端连接正常