Ubuntu 24 Desktop LTS 部署 AI 智能体 OpenClaw
文章目录
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、操作系统怎么选
推荐：
- 长期稳定/生产/服务器 → Linux（Ubuntu 22.04/24.04 LTS）
- 最稳、兼容性最好、社区教程最多
- 原生支持 systemd、定时任务、后台守护、完整技能生态
- 云服务器/家庭服务器首选，适合 7×24 运行
- 无 WSL 抽象层，性能与资源占用最优
- 个人日常/本地优先/苹果设备 → macOS 14+（Sonoma）
- 原生桌面体验、菜单栏、语音唤醒、Web UI 完整
- M 系列芯片性能强，本地模型（Ollama）跑得顺
- 隐私与文件权限友好，适合个人主力机
- Windows 用户 → Windows 11 + WSL2（Ubuntu 22.04）
- 绝对不要用 Windows 原生（仅预览、技能/记忆残缺）
- WSL2 是 Windows 唯一推荐方案，等价 Linux 环境
- 可无缝用 Windows 文件、浏览器、IDE，兼顾日常与开发
- 边缘/低功耗/24/7 → Raspberry Pi 5（8GB）+ Ubuntu Server 24.04
- 低功耗、静音、适合家庭私有 AI 节点
- 用 NVMe SSD 替代 SD 卡，稳定性大幅提升
我的选择：老电脑装 Ubuntu Desktop
- 不选：
- Ubuntu Server 没有桌面，我要用浏览器
- 苹果没有，买？太贵 ~
- Windows 需要 WSL2，虚拟机里面运行。有性能损失
- 低功耗设备没有，买？
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.ZEEKLOG.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）安装基础依赖
# 正常安装应该是sudoapt update &&sudoapt upgrade -ysudoaptinstall-ycurlgit build-essential python3 python3-pip chromium-browser # 我的安装是这样的sudoapt update &&sudoapt upgrade -ysudoaptinstall-ycurlgit python3 python3-pip chromium-browser # 会报错sudoaptinstall-y build-essential 
# 报错sudoaptinstallbzip2
sudoapt policy libbz2-1.0 # 看到 Installed: 后面是 1.0.8-5.1build0.1，而 Candidate: 或可用版本里有 1.0.8-5.1。# 强制降级 libbz2-1.0 到指定版本sudoaptinstall libbz2-1.0=1.0.8-5.1 # 成功降级后，重新安装sudoaptinstallbzip2sudoaptinstall build-essential # 终于成功了 ~（2）安装 Node.js 22 LTS
curl-fsSL https://deb.nodesource.com/setup_22.x |sudo-Ebash - sudoaptinstall-y nodejs # 验证node-v# 应输出 v22.x.xnpm-v（3）配置代理，保证网络正常
首先要配置代理，因为我要使用 Google
1）Ubuntu 24.04.1 LTS 怎么看网络代理？
设置 → 网络 → 代理 → 关/手动
详细里面就是具体的代理了
2）Ubuntu 24.04.1 LTS 怎么显示隐藏文件？
Ubuntu 文件管理器（最常用）
快捷键：Ctrl + H
作用：显示 / 隐藏 隐藏文件（. 开头的文件）
效果：按一次显示，再按一次隐藏。
3）配置代理，否则 Google 的模型不通，更改操作系统配置文件 ~/.bashrc
# 替换你的 proxy 信息 # Proxy export http_proxy=http://127.0.0.1:9674 export https_proxy=http://127.0.0.1:9674 # 配置文件生效source ~/.bashrc # 命令行试一下curl https://www.google.com （4）安装 OpenClaw（官方脚本）
# 国内可先加速 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
说明：此步骤如果失败，重启电脑，重新安装就行了。
# 验证 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
# 帮忙文档 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 # 卸载（谨慎） - 没测试npm uninstall -g openclaw 2.4、Skill
Skills 是 OpenClaw 实现各种功能的插件或模块
2.4.1、安全
（1）Skill Vetter（必备技能） - 官方推荐工具（核心防御）
OpenClaw 官方认证的安全审查技能，被誉为 “技能安全门卫”
安装与使用：
# 安装 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
# 搜索 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 对应的能力是否和配置一致。
# 验证 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 的无限可能！
