脚本之家 服务器常用软件
快捷导航
您的位置：主页 > AI > openclaw > Ubuntu部署OpenClaw

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

  发布时间：2026-06-14 11:33:20   作者：AI砖家   我要评论
OpenClaw（社区俗称“小龙虾”）是一款本地优先、开源、跨平台的 AI 智能体执行框架，由奥地利开发者 Peter Steinberger 于 2025 年发布，采用 MIT 开源协议，下面小编就和大家详细讲讲如何在Ubuntu系统上快速部署OpenClaw吧

一、OpenClaw 是什么？

OpenClaw（社区俗称“小龙虾”）是一款本地优先、开源、跨平台的 AI 智能体执行框架，由奥地利开发者 Peter Steinberger 于 2025 年发布，采用 MIT 开源协议。它的核心价值不是大模型本身，而是给大模型装上“手脚”——让 AI 从“被动回答问题”升级为“主动完成任务”，能够在你的电脑上自主完成文件管理、浏览器自动化、代码开发、邮件处理等真实操作。

OpenClaw 具备四大核心特性：本地优先的隐私架构（数据默认存储在本地）、模型无关的开放设计（兼容 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 的应用，这是部署的关键前提。如果你的 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

脚本执行后会自动下载并安装所有依赖，约 2-3 分钟即可完成。安装成功后，终端会提示进入初始化配置向导。

注意事项

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

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

# 验证配置
npm config get registry

这样可显著提升下载速度，避免安装中断。

五、初始化配置向导

安装完成后，首次启动会自动进入交互式配置向导。以下是各步骤的推荐选择：

第一步：安全确认。 向导会显示安全提示，说明 OpenClaw 作为个人 AI 智能体可能会执行实际操作。选择 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: openclawPATH 未配置执行 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 是否正确，确保模型提供商服务可用

八、进阶建议

部署成功后，你可以逐步探索更多玩法：通过 openclaw skills 安装社区技能包，实现文件自动整理、邮件定时发送、网页监控等自动化任务；配置 Telegram 或飞书渠道，实现“聊天即操作”；接入本地 Ollama 模型，完全离线运行，隐私更安全。

以上就是Ubuntu系统上快速部署OpenClaw的完整教程的详细内容，更多关于Ubuntu部署OpenClaw的资料请关注脚本之家其它相关文章！

相关文章

最新评论

关注微信公众号

扫一扫