⚙️ 第一步:系统准备与依赖安装
在开始之前,需要确保你的 Ubuntu 系统(建议使用 22.04 或 24.04 LTS 版本)已经准备好必要的工具。
- 。
在 Ubuntu 22.04/24.04 LTS 系统上安装 OpenClaw 的三种主要方式:一键脚本安装、Docker 容器化安装以及基于 npm/pnpm 的手动安装。内容涵盖系统依赖准备、具体执行步骤、初始化配置(如 API 密钥设置)、守护进程启动及 Web UI 访问验证。同时提供了网络配置与安全建议,帮助用户快速完成本地或生产环境的部署。
在开始之前,需要确保你的 Ubuntu 系统(建议使用 22.04 或 24.04 LTS 版本)已经准备好必要的工具。
安装基础工具链:安装后续步骤中可能用到的 curl、git 等工具。
sudo apt install -y curl wget git build-essential
更新系统包:这是为了避免因系统包过旧而导致的依赖冲突。
sudo apt update && sudo apt upgrade -y
你可以根据自身需求,从以下三种方法中选择一种进行安装。
这是官方推荐的最简单、最省心的方式。脚本会自动处理 Node.js 依赖的检测和安装,并直接启动配置向导。
curl -fsSL https://openclaw.ai/install.sh | bash
执行后,脚本会引导你进入下一步的配置流程。
如果你偏好使用 Docker,或者希望将 OpenClaw 运行在隔离的容器环境中,可以使用此方法。
克隆仓库并运行脚本:
# 创建并进入项目目录
mkdir -p ~/openclaw && cd ~/openclaw
# 克隆官方仓库
git clone https://github.com/openclaw/openclaw.git .
# 运行 Docker 设置脚本
./docker-setup.sh
该脚本会自动构建镜像、生成访问令牌并启动服务。
如果你已经安装了 Node.js 22+,并希望自己管理全局包,可以使用 npm 或 pnpm 进行安装。
node --version 应显示 v22.x.x。全局安装 OpenClaw:
npm install -g openclaw@latest
安装 Node.js 22+ (如果还未安装):
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E - bash && sudo apt install -y nodejs
安装完成后,你需要通过'新手引导'来完成核心设置,如添加 AI 模型 API 密钥、配置守护进程等。
docker-setup.sh 脚本通常会在安装过程中自动启动这个向导。如果你使用了一键脚本或 npm 安装,需要手动启动配置向导:
openclaw onboard --install-daemon
这个命令会启动一个交互式终端界面,引导你完成配置。
在配置向导中,你需要完成以下几个关键步骤:
~/.openclaw/workspace 即可,用于存储配置和数据。http://你的 UbuntuIP 地址:18789。如果是本地安装,直接访问 http://127.0.0.1:18789。获取访问令牌:
你需要令牌来登录 Web 界面。可以通过以下命令查看配置文件中生成的令牌:
grep -A1 '"token"' ~/.openclaw/openclaw.json
检查网关状态:
openclaw gateway status
如果显示 running,则表示启动成功。
~/.clawdbot/),它们可能仍然指向同一个工具。网络访问配置:如果需要在局域网内的其他设备上访问 OpenClaw 的 Web 界面,你需要修改配置,让其监听所有网络接口:
openclaw config set gateway.bind lan
openclaw gateway restart
安全提示:请勿将此端口(18789)直接暴露在公网上,以免带来安全风险。如需远程访问,强烈建议使用 VPN 或配置带身份验证的反向代理(如 Caddy、Nginx)。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online