Ubuntu 24 Desktop LTS 部署 AI 智能体 OpenClaw

文章目录

[AI 智能体 OpenClaw 简介](#AI 智能体 OpenClaw 简介)
1、准备阶段
- 1.1、操作系统怎么选
- 1.2、硬件要求
- [1.3、API 密钥与账号准备（关键）](#1.3、API 密钥与账号准备（关键）)
[2、Ubuntu 24 Desktop LTS 部署 OpenClaw](#2、Ubuntu 24 Desktop LTS 部署 OpenClaw)
- 2.1、安装部署
- [2.2、Ubuntu 24 Desktop LTS 优化](#2.2、Ubuntu 24 Desktop LTS 优化)
- 2.3、常用命令
- 2.4、Skill
- - 2.4.1、安全
  - [2.4.2、如何安装 skill](#2.4.2、如何安装 skill)
[3、示例：如何使用 OpenClaw](#3、示例：如何使用 OpenClaw)
- 3.1、生成博客
4、注意事项：账单
5、常见问题
总结

AI 智能体 OpenClaw 简介

GitHub 地址：https://github.com/openclaw/openclaw
官方网站：https://clawhub.ai/
官方文档：https://docs.openclaw.ai/

OpenClaw（曾用名 Clawdbot、Moltbot）是一款开源、本地优先、模型无关的 AI 智能体执行网关，核心是让你用自然语言指挥电脑，让 AI 替你完成真实操作。它不是聊天机器人，而是能 "听懂人话、动手干活" 的本地 AI 执行中枢。

OpenClaw 是 AI 智能体领域的现象级项目，它将大模型从 "聊天工具" 升级为 "数字员工"，真正实现了 "指令一句话，AI 跑全程"。其本地优先、模型无关、技能扩展、多平台接入的核心优势，使其成为个人效率提升、企业自动化部署的首选方案。

1、准备阶段

1.1、操作系统怎么选

1.2、硬件要求

项目	最低配置	推荐配置	说明
CPU	2核处理器	4核及以上（Intel i5/Ryzen 5+）	影响多任务并发与执行效率
内存	2GB RAM	4GB+ RAM	避免智能体运行时内存不足
存储	500MB 可用空间	2GB+ 可用空间	存放程序、依赖与缓存
网络	稳定互联网连接	高速宽带	用于下载依赖、调用 LLM API、同步更新

1.3、API 密钥与账号准备（关键）

LLM API 密钥（必选其一）
- 商业模型 API 密钥，例如：GPT、Claude、Google Gemini 等
- 本地模型：如 Ollama（需额外安装并配置）
通信平台账号（可选。如需要通过通讯平台与 OpenClaw 通讯）
- WhatsApp 账号（扫码连接）
- Telegram 账号 + Bot Token（@BotFather 创建）
- Discord 账号 + 应用凭证

2、Ubuntu 24 Desktop LTS 部署 OpenClaw

插播广告 - 常用命令可以参考 Ubuntu 24 常用命令&方法：https://blog.csdn.net/achi010/article/details/145224136

操作系统：Ubuntu 24.04.1 LTS

OpenClaw 版本：v2026.3.13

2.1、安装部署

注意事项：

必要的步骤，尽量不要跳过。例如：Model/auth provider（没有 OpenClaw 用不了）、Hooks 尽量都开通
OpenClaw 提供的 skill 尽量安装，用的概率很高，但是有些需要 Key 就根据个人情况而定了

（1）安装基础依赖

shell 复制代码

# 正常安装应该是
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential python3 python3-pip chromium-browser

shell 复制代码

# 我的安装是这样的
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git python3 python3-pip chromium-browser

shell 复制代码

# 会报错
sudo apt install -y build-essential

shell 复制代码

# 报错
sudo apt install bzip2

shell 复制代码

sudo apt policy libbz2-1.0
# 看到 Installed: 后面是 1.0.8-5.1build0.1，而 Candidate: 或可用版本里有 1.0.8-5.1。

# 强制降级 libbz2-1.0 到指定版本
sudo apt install libbz2-1.0=1.0.8-5.1
# 成功降级后，重新安装
sudo apt install bzip2
sudo apt install build-essential
# 终于成功了 ~

（2）安装 Node.js 22 LTS

shell 复制代码

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 验证
node -v  # 应输出 v22.x.x
npm -v

（3）配置代理，保证网络正常

首先要配置代理，因为我要使用 Google

1）Ubuntu 24.04.1 LTS 怎么看网络代理？

设置 → 网络 → 代理 → 关/手动

详细里面就是具体的代理了

2）Ubuntu 24.04.1 LTS 怎么显示隐藏文件？

Ubuntu 文件管理器（最常用）

快捷键：Ctrl + H

作用：显示 / 隐藏隐藏文件（. 开头的文件）

效果：按一次显示，再按一次隐藏。

3）配置代理，否则 Google 的模型不通，更改操作系统配置文件 ~/.bashrc

config 复制代码

# 替换你的 proxy 信息
# Proxy
export http_proxy=http://127.0.0.1:9674
export https_proxy=http://127.0.0.1:9674

shell 复制代码

# 配置文件生效
source ~/.bashrc

# 命令行试一下
curl https://www.google.com

（4）安装 OpenClaw（官方脚本）

shell 复制代码

# 国内可先加速 npm（可选）
npm config set registry https://registry.npmmirror.com

# 开始之前要确保网络能连上 Model ，否则就好后面再重新配置了！
# 官方一键安装（可以选择 QuickStart（快速配置），会进入配置导航，按照指引一步一步配置就好了！）
curl -fsSL https://openclaw.ai/install.sh | bash
# 需要配置：LLM API Key

配置完成后，会自动打开浏览器进入主页 http://127.0.0.1:18789

说明：此步骤如果失败，重启电脑，重新安装就行了。

shell 复制代码

# 验证
openclaw --version
# 查看状态
openclaw status

2.2、Ubuntu 24 Desktop LTS 优化

关闭休眠、锁屏（如果需要作为后台使用，避免断连）
- 设置 → 电源 → 电源模式：均衡
- 设置 → 电源 → 节点 → 息屏：从不
Web UI 可固为书签（方便打开）

2.3、常用命令

FAQ: https://docs.openclaw.ai/faq
Troubleshooting: https://docs.openclaw.ai/troubleshooting

shell 复制代码

# 帮忙文档
openclaw --help

# 管理后台核心服务
openclaw gateway
# 常用参数 openclaw gateway install / start / stop / restart / status

# 重新进入初始化向导
openclaw onboard
# 自动安装后台服务
# openclaw onboard --install-deamon
# 仅安装，不进入初始化向导
# openclaw onboard --no-noboard

# 查看日志
openclaw logs --follow
openclaw logs --json
openclaw logs

# 交互式修改配置
openclaw config
openclaw configure

# 查看整体运行状态
openclaw status
# 全面健康诊断
openclaw doctor
# 轻量级健康检查
openclaw health

# 查看所有聊天渠道状态
openclaw channels status

# 打开 Web 面板
openclaw dashboard

# 升级到最新版
openclaw update

shell 复制代码

# 卸载（谨慎） - 没测试
npm uninstall -g openclaw

2.4、Skill

Skills 是 OpenClaw 实现各种功能的插件或模块

2.4.1、安全

（1）Skill Vetter（必备技能） - 官方推荐工具（核心防御）

OpenClaw 官方认证的安全审查技能，被誉为 "技能安全门卫"

安装与使用：

shell 复制代码

# 安装
clawhub install skill-vetter

# 使用方法1：安装前自动扫描
clawhub install <target-skill>  # 自动触发Skill Vetter审查

2.4.2、如何安装 skill

搜索
Skill Store ：https://clawhub.ai/

下载，放到 /home/userName/.openclaw/workspace/skills/ 目录，skill 就生效了。可以通过页面确认

也可以通过 clawhub CLI 来管理 Skills

shell 复制代码

# 搜索
clawhub search <skill-name>
# 安装
clawhub install <skill-name>
# 更新
clawhub sync
clawhub sync <skill-name>

3、示例：如何使用 OpenClaw

3.1、生成博客

通过 Skill Store ：https://clawhub.ai/ 搜索 - genetrate blog

下载喜欢的 skill 放到 /home/userName/.openclaw/workspace/skills/ 目录，通过浏览器确认 skill 生效。通过"聊天"就可以让 OpenClaw 生成博客了。

4、注意事项：账单

首先，也是最终的事情，注意 Token 账单哈 ~

保持更新：定期更新 OpenClaw 及其 Skills，以获得最新的功能和安全补丁。
理解局限性：AI 智能体并非万能，其生成的内容可能需要人工审核和修改，尤其是在专业领域或涉及事实核查时。
数据安全：在处理敏感信息时，务必谨慎，并遵守相关的数据隐私法规。
资源消耗：复杂的任务可能需要较多的计算资源，请确保您的系统有足够的内存和 CPU。
明确指令：提供清晰、具体、结构化的指令，有助于 AI 更准确地理解您的需求。

5、常见问题

（1）依赖问题

上面已经说过了，降级吧 ~ 哎 ~

（2）安装卡住

重启电脑；换 npm 镜像；重启终端；或者手动安装

（3）权限不足：所有命令加 sudo 或用普通用户（推荐）

（4）LLM 连接不上

排查思路：1）首先检查网络是否正常，例如 DNS、443、API、代理等；2）模型是否正常，例如：Google Cloud 状态面板（https://status.cloud.google.com/），确认 Gemini API 无服务中断 / 限流；3）确认 KEY 对应的能力是否和配置一致。

shell 复制代码

# 验证 DNS 解析
nslookup generativelanguage.googleapis.com

# 验证端口连通性（443 是 HTTPS 默认端口）
nc -zv generativelanguage.googleapis.com 443
# 预期：显示「succeeded!」或「Connected」，无连接拒绝/超时

# 手动调用 API 验证（替换为你的 API Key）
curl -v "https://generativelanguage.googleapis.com/v1/models/gemini-3.1-flash-lite-preview:generateContent?key=YOUR_GOOGLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents": [{"parts": [{"text": "test"}]}]}'
# 预期：返回200 OK和模型响应；若返回「Connection timed out」则确认网络问题

# 查看 key 可以使用的模型
curl -v "https://generativelanguage.googleapis.com/v1/models?key=YOUR_GOOGLE_API_KEY"

总结

通过本指南，您应该已经了解了如何在 Ubuntu 24 Desktop LTS 上部署 OpenClaw AI 智能体，并掌握了其基本使用方法。OpenClaw 作为一个强大的生产力工具，能够极大地提升我们的工作效率。鼓励您积极探索其更多高级功能，并将其集成到您的日常工作流程中，释放 AI 的无限可能！