文章目录
目录
- 一、OpenClaw 是什么？
- 二、环境准备
- 三、安装 Node.js
- 四、一键安装 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 配置即可流畅运行。
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+。
官方提供了极为简洁的一键安装脚本，自动完成 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: 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 是否正确，确保模型提供商服务可用 |
部署成功后，你可以逐步探索更多玩法：通过 openclaw skills 安装社区技能包，实现文件自动整理、邮件定时发送、网页监控等自动化任务；配置 Telegram 或飞书渠道，实现“聊天即操作”；接入本地 Ollama 模型，完全离线运行，隐私更安全。
以上就是Ubuntu系统上快速部署OpenClaw的完整教程的详细内容，更多关于Ubuntu部署OpenClaw的资料请关注风君子博客其它相关文章！