OpenClaw 安装教程（Linux）
今天的目标很明确：在 Linux 环境（服务器或本地机均可）上，完成 OpenClaw 的安装部署，并通过基础验证，确保它能跑起来。
一、环境要求
动手之前，先清点一下必备的“地基”。这套环境要求不算苛刻，基本是开箱即用：
Linux 系统：目前主流的发行版都支持，如果还没有想法，Ubuntu 22.04 LTS 或更高版本通常是最稳妥的选择。
Node.js 22.x：这是核心运行时，版本务必对上。
npm：通常随 Node.js 一起安装，负责包管理。
sudo/root 权限：安装全局包或执行部分系统级操作时会用到。
上手第一步，先在终端里敲两行命令，简单验个货：
node -v
npm -v二、安装 Node.js 22（如未安装）
如果刚才的检查没有返回版本号，那说明 Node.js 环境还没就位。这里首推使用 nvm（Node Version Manager） 来安装和管理，它能让你在不同项目间灵活切换版本，非常方便。
打开终端，依次执行以下命令：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
node -v
npm -v这一套组合拳下来，Node.js 22 环境应该已经准备妥当了，最后两行命令可以再次验证。
三、安装 OpenClaw
环境齐备，主角就可以登场了。我们通过 npm 进行全局安装，这样你就能在系统的任何位置调用 openclaw 命令。
npm install -g openclaw安装过程视网络情况而定，稍等片刻。完成后别急着走，用两个简单的命令验证安装是否成功：
openclaw --version
openclaw help第一个命令会输出当前安装的 OpenClaw 版本号，第二个命令则会显示所有的可用命令和帮助信息。看到这些，就说明安装这一步稳了。
四、启动 Gateway 服务
OpenClaw 的核心是它的 Gateway 服务。启动它，整个系统才开始真正运转。这里有几个常用命令，可以先记一下：
openclaw gateway status # 查看状态
openclaw gateway start # 启动服务
openclaw gateway stop # 停止服务
openclaw gateway restart # 重启服务对于首次安装，我们直接启动它：
openclaw gateway start启动后，立即检查一下状态，确认服务是否在正常运行：
openclaw gateway status五、基础配置
服务跑起来了，但还缺些“灵魂”——也就是配置。运行初始化命令，它会以交互式向导引导你完成最核心的几项设置：
openclaw configure你需要根据提示，依次配置好模型、消息通道、工具等。这一步决定了 OpenClaw 能用什么样的 AI 模型、通过什么方式与你交互（比如 Discord、Slack）、以及具备哪些能力。
特别提醒一下：如果你想使用网页搜索功能（web_search），它需要独立的 API Key（比如 Brave Search 的 Key）。别担心，可以随时通过以下命令单独配置这一部分：
openclaw configure --section web六、健康检查
配置完成后，强烈建议进行一次全面的“体检”。这能帮你发现潜在的环境或依赖问题，防患于未然。执行诊断命令：
openclaw doctor --non-interactive这个命令会以非交互模式运行，自动检查各项依赖、环境变量和网络连通性，并直接给出报告。如果发现任何异常，就按照输出提示的信息，逐项排查修复。大多数初期问题，比如某个依赖没装好或者端口冲突，都能在这里被发现。
七、升级与维护
软件世界日新月异，保持更新是获得新功能和修复的关键。升级 OpenClaw 到最新版本非常简单：
npm install -g openclaw@latest升级之后，为了确保一切运转如常，最好遵循一个标准流程：先重启 Gateway 服务，让新版本生效；然后再跑一遍健康检查，确认升级没有引入新问题。
openclaw gateway restart
openclaw doctor --non-interactive八、常见问题
安装路上难免遇到小磕绊，这里列举几个高频问题，帮你快速排雷。
1） openclaw：找不到命令
这个提示很常见，通常是系统找不到全局安装的 npm 包路径。
解决办法：先执行 npm prefix -g 和 npm bin -g 查看全局安装路径和二进制文件路径。然后，确保这个二进制文件路径被添加到了你终端的 PATH 环境变量中（通常在 ~/.bashrc 或 ~/.zshrc 文件里配置）。
2) Gateway 启动失败
如果服务启动不了，别慌，按照这个顺序排查：
第一步，看状态：openclaw gateway status，看有没有错误日志。
第二步，尝试重启：openclaw gateway restart。
如果还是不行，第三步，请出“医生”：openclaw doctor --non-interactive，它通常能定位到具体原因。
3) 搜索工具报 missing_brave_api_key
当你调用网页搜索功能时出现这个错误，说明虽然配置了工具，但没给它“钥匙”——也就是 Web 搜索的 API Key。
解决：运行 openclaw configure --section web，在其中填入有效的 API Key（例如 Brave Search 的 Key）即可。
九、结语
跟着上面的步骤走下来，你的 OpenClaw 应该已经安装就绪，并且可以基础运行了。
那么，完成安装验证后的下一步该做什么呢？给你两个切实的建议：
首先，深化配置。根据你的实际使用场景，去仔细配置消息通道（比如连接到你的团队通讯工具），这是它能为你效力的直接桥梁。
其次，安全加固。在正式投入使用前，务必做一次安全检查。检查方向包括：是否为服务设置了最小必要权限、监听的端口是否被不必要地暴露在公网、所有用到的 API 密钥和敏感配置是否得到了妥善管理。这一步，怎么重视都不为过。
祝部署顺利！