首页 > 教程攻略 > ai教程 >Ubuntu系统上快速部署OpenClaw的完整教程

Ubuntu系统上快速部署OpenClaw的完整教程

来源：互联网时间：2026-06-15 07:08:19

一、OpenClaw 是什么？

要说清楚这个工具，咱们得先聊聊它到底是个什么角色。OpenClaw，社区里俗称“小龙虾”，是一个本地优先、开源又跨平台的AI智能体执行框架。听起来挺唬人，但它的核心价值其实很简单——不是去做大模型本身，而是给大模型装上“手和脚”。什么意思呢？就是让AI从一个只会“被动回答问题”的聊天对象，升级成一个能“主动完成任务”的得力助手。你可以在自己的电脑上，让它帮你做文件管理、浏览器自动化、写代码、处理邮件……这些实实在在的操作。

这个框架是奥地利开发者Peter Steinberger在2025年发布的，采用MIT开源协议。说到它的核心优势，主要有四点：

本地优先的隐私架构

，数据默认存在本地，不用提心吊胆；

模型无关的开放设计

，兼容Kimi、OpenAI、Anthropic等200多种主流模型，你想用哪个都行；

安全可控的隔离沙箱

，每个任务独立运行，互不影响；还有

无限扩展的插件生态

，社区已经贡献了超过5700个技能包。上线才几个月，GitHub星标就突破了28万，说是当下最火的开源AI执行工具，一点也不为过。

二、环境准备

要在Ubuntu上部署OpenClaw，先得确认环境是否达标。来看看最低配置要求：

依赖项	要求
操作系统	Ubuntu 22.04+（推荐24.04）
Node.js	≥ v22.x（建议安装24.x）
内存	≥ 2GB（推荐4GB+）
磁盘	≥ 500MB可用空间
网络	需联网下载依赖包和调用云端模型
可选	Python 3.10+、Git

这些要求真的不算高，普通的笔记本电脑或者云服务器，2核4GB的配置就能跑得很顺畅。

三、安装Node.js

OpenClaw是Node.js的应用，所以先把Node.js搞定是关键。如果你的Ubuntu还没装Node.js 22以上版本，可以用下面的命令快速安装：

# 添加NodeSource官方源（22.x）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装Node.js
sudo apt-get install -y nodejs
# 验证安装
node -v   # 应输出 v22.x.x 或 v24.x.x
npm -v    # 应输出 9.x.x+

这里有个小提示：如果系统里已经有旧版Node.js，建议用nvm来管理多版本，或者把旧版彻底卸载了再按这个步骤重装。Node.js 18或20版本跑这个工具会有兼容性问题，所以一定要用22以上版本。

四、一键安装OpenClaw

官方准备了一个非常简洁的一键安装脚本，能自动帮你搞定Node.js检测、构建工具安装和OpenClaw CLI部署：

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

脚本跑起来后会自动下载并安装所有依赖，大概两到三分钟就能完成。安装成功后，终端会提示你进入初始化配置向导。

注意事项

国内用户直接安装可能会遇到npm下载慢或者GitHub资源超时的问题。建议在安装前先配置一下镜像源：

# 配置npm淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry

这一招能明显提升下载速度，避免安装过程卡住。

五、初始化配置向导

安装完成后，第一次启动会自动进入一个交互式配置向导。下面是每一步的推荐选择：

第一步：安全确认。

向导会显示安全提示，说明OpenClaw可能会执行实际操作。直接选Yes然后回车确认。

第二步：选择配置模式。

选QuickStart（快速模式），系统会自动配置网关和默认参数，包括端口18789、绑定地址127.0.0.1、Token认证。对新手来说，这是最快的上手方式。

第三步：模型提供商配置。

选择你要用的大模型。新手可以先选

Qwen免费云端模型

跑通整个流程，后面随时可以切换。如果想对接Kimi，可以去platform.moonshot.cn申请API Key。选Anthropic或OpenAI也完全可以，只需要填入对应的API Key就行。

第四步：渠道与技能配置。

渠道（比如Telegram、Slack）可以先跳过，后面再配。技能安装也建议先选No，等服务跑通了，再根据实际需求去添加。

第五步：选择交互方式。

推荐选

TUI（终端界面）

或

Web UI

。前者直接在终端里用，后者通过浏览器访问http://localhost:18789来操作。

六、启动与验证

配置完成后，OpenClaw会自动启动。你也可以通过下面的命令手动管理：

# 启动TUI终端交互界面
openclaw tui

# 查看服务状态
openclaw status

# 查看网关状态
openclaw gateway status

# 启动/停止网关
openclaw gateway start
openclaw gateway stop

在终端里输入openclaw tui，如果看到了聊天界面并能正常对话，那说明部署成功了。恭喜，你的专属AI智能体已经可以开始“干活”了。

七、常见问题速查

问题	原因	解决方法
`command not found: openclaw`	PATH未配置	执行`npm config get prefix`获取路径并加入环境变量，然后`source ~/.bashrc`刷新
Gateway启动失败	端口18789被占用	执行`lsof -ti:18789 \| xargs kill -9`释放端口，或修改配置切换到其他端口
访问控制台提示“缺失访问凭证”	Token未携带	执行`openclaw token generate`生成新Token，并在URL中追加`?token=你的Token`
Node.js版本不兼容报错	版本低于22.x	彻底卸载旧版Node.js，安装22.x或24.x版本
模型调用报错	API Key未配置或无效	检查`~/.openclaw/config.yaml`中的API Key是否正确，确保模型提供商服务可用