广告位联系
返回顶部
分享到

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

Ai 来源:互联网 作者:佚名 发布时间:2026-06-15 22:15:18 人浏览
摘要

一、OpenClaw 是什么? OpenClaw(社区俗称小龙虾)是一款本地优先、开源、跨平台的 AI 智能体执行框架,由奥地利开发者 Peter Steinberger 于 2025 年发布,采用 MIT 开源协议。它的核心价值不是大模

一、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+,可通过以下命令快速安装:

1

2

3

4

5

6

7

# 添加 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 部署:

1

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

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

注意事项

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

1

2

3

4

5

# 配置 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 会自动启动。你也可以通过以下命令手动管理:

1

2

3

4

5

6

7

8

9

10

11

12

# 启动 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 模型,完全离线运行,隐私更安全。


版权声明 : 本文内容来源于互联网或用户自行发布贡献,该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权, 违法违规的内容, 请发送邮件至2530232025#qq.cn(#换@)举报,一经查实,本站将立刻删除。
原文链接 :
相关文章
  • 本站所有内容来源于互联网或用户自行发布,本站仅提供信息存储空间服务,不拥有版权,不承担法律责任。如有侵犯您的权益,请您联系站长处理!
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计