当前位置:首页>Linux>一文搞定:OpenClaw 在 Linux 服务器的安装与首次使用

一文搞定:OpenClaw 在 Linux 服务器的安装与首次使用

  • 2026-09-19 14:41:30
一文搞定:OpenClaw 在 Linux 服务器的安装与首次使用

一文搞定:OpenClaw 在 Linux 服务器的安装与首次使用

适用场景:Ubuntu / Debian / CentOS / Fedora 等常见 Linux 服务器(本文以 Fedora 为例,其他发行版流程基本一致)

OpenClaw 是什么?可以帮你做什么?

OpenClaw 可以理解为一个可扩展的 AI 助手运行平台。安装后,你可以把它接入到终端、Web 控制台和聊天平台里,让它帮你完成:

  • 代码生成与修改
  • 文档整理与自动化处理
  • Web 检索与信息汇总
  • 通过插件/技能扩展更多能力(如截图、语音、表格等)

如果你想要的是“在自己的机器上,长期稳定地运行一个可配置的 AI 助手”,OpenClaw 是很实用的一套方案。

1. 前置要求

  • 一台可联网的 Linux 服务器(本文以 Fedora 为例)
  • 建议内存:至少 4GB(8GB 更稳)
  • 已准备好大模型 API Key(如 OpenAI、DeepSeek 等)

2. 推荐安装方式(官方脚本,一条命令)

新手优先用这个方式。

curl -fsSL https://openclaw.ai/install.sh | bash

这条命令会自动完成(耗时可能较长,耐心等待):

  • 检测并安装所需 Node.js(要求 Node 22+)
  • 安装 git(缺失时)
  • 全局安装 openclaw CLI
  • 启动首次引导(onboarding)

如果你只想安装,不立即进入引导:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

安装引导过程说明(按原流程)

使用脚本安装:

安装过程中会有引导,按你实际情况选择即可(如是否个人使用):

是否进入快速引导:

配置你的大模型:

我这里使用自定义配置,你按自己实际有的模型选择即可(如果都没有,国内可先用 Kimi,预算充足可直接 Claude)。

阿里云 CodePlan 配置说明(我之前测试用过,这里不是打广告哈,只是给不知道的人一个建议,首月7.9体验还是不错的):https://www.alibabacloud.com/help/en/model-studio/openclaw-coding-plan

配置接入平台(我这次以演示 QQ 机器人接入,这里可先不选);

Web 搜索 API 有就填,没有就先跳过,上面两步我都直接跳过

常用技能下载步骤:有对应 API 就直接配置;没有可先全部跳过,后续再统一补配:

下一步会问是否启用 Hooks(钩子插件),可选 session-memory,让 AI 记住历史上下文:

基础配置结束后,按推荐方式完成最后一步(TUI):

开始对话:

到这里,基础安装和初始化基本完成。下面通过 Web 访问控制台。

先获取 token(原命令):

cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'

如果初始化时你选择了 Web 方式,通常会直接给访问地址:

浏览器输入:

http://127.0.0.1:18789/#token=xxxxxx

3. 备用安装方式(已装 Node 22+)

如果官方脚本方式失败(常见于网络不稳定),可以走这条:

npm install -g openclaw@latestopenclaw onboard --install-daemon

4. 安装后检查

openclaw --versionopenclaw doctoropenclaw status

5. 服务器远程访问控制台(无桌面必做)

OpenClaw 常用端口是 18789(本机回环)。

在你自己的电脑执行 SSH 端口转发:

ssh -N -L 18789:127.0.0.1:18789 <用户名>@<服务器IP>

然后在本地浏览器打开:

http://127.0.0.1:18789/

按页面提示粘贴 token 即可进入控制台。

6. systemd 管理(可选)

如果你希望服务随系统启动,可在安装引导里选择安装 daemon,或手动执行:

openclaw gateway install

常用状态命令:

openclaw statusopenclaw gateway restart

7. 常见问题

7.1 提示 openclaw: command not found

检查 npm 全局 bin 是否在 PATH:

node -vnpm -vnpm prefix -gecho "$PATH"

若缺失,把下面一行加入 ~/.bashrc 或 ~/.zshrc:

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

然后重新登录 SSH 会话,或执行:

source ~/.bashrc

7.2 启动后打不开页面

  • 先看服务状态:openclaw status
  • 确认 SSH 端口转发命令在本地电脑上持续运行
  • 确认你打开的是本地 http://127.0.0.1:18789/,不是服务器公网地址

8. 官方参考

  • 安装总览(官方):https://docs.openclaw.ai/install/index
  • Linux 平台说明(官方中文):https://docs.openclaw.ai/zh-CN/platforms/linux

如果你是国内网络环境,使用脚本安装失败,建议尝试npm安装方案作为兜底,避免官方脚本超时导致安装中断。

最新文章

随机文章