基于火山引擎 Ubuntu 24.04 预制镜像 30 分钟部署 OpenClaw 飞书办公助手

# Ubuntu24.04 系统部署OpenClaw AI 平台完整指南

1. 系统环境准备

1.1 系统要求检查

在开始安装 OpenClaw 之前，请确保您的 Ubuntu24.04 系统满足以下基本要求：

| 要求项 | 具体规格 | 备注说明 |

|——–|———–|———-|

| 操作系统 | Ubuntu24.04.4 | 也支持 macOS/Windows (Windows 推荐 WSL2) [ref_1] |

| 内存 | 建议 2GB 以上 | OpenClaw 本身占用约 400MB [ref_3] |

| Node.js | v18 或更高版本 | OpenClaw 基于 Node.js 开发 [ref_3] |

1.2 系统更新与基础环境检查

首先确保系统是最新状态，执行以下命令：

“`bash

# 更新系统包列表

sudo apt update

# 升级已安装的软件包

sudo apt upgrade -y

# 检查系统版本

lsb_release -a

# 检查内存情况

free -h

“`

2.OpenClaw 安装步骤

2.1 推荐安装方法：一键安装脚本

这是官方推荐的安装方式，脚本会自动完成 Node.js 检测/安装、CLI 全局安装、启动引导向导 [ref_1]。

“`bash

# 执行一键安装脚本

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

“`

安装过程会自动完成以下步骤：

– 检测系统环境

– 安装必要的依赖

– 配置 Node.js 环境（如需要）

– 安装 OpenClaw CLI 工具

– 启动初始配置向导

2.2 安装完成验证

安装完成后，系统会显示安装成功信息并进入设置页面。请务必记住生成的 token，这是后续访问和管理的重要凭证 [ref_1]。

3. 初始配置指南

3.1 启动配置向导

安装完成后，在终端中输入以下命令开始配置：

“`bash

# 启动配置向导

openclaw onboard

“`

3.2 配置界面选择

系统会提供多种配置方式，推荐选择：

【强烈推荐】Hatch in TUI (recommended)

适用场景：Ubuntu 虚拟机无图形界面、不想配置端口映射，全程在终端完成所有配置，是官方推荐的最优方案 [ref_1]。

操作步骤：

1. 该选项已默认选中（左侧有绿色圆点标记）

2. 直接按下回车键确认

openclaw3. 跟随终端的分步引导完成配置

3.3 模型配置关键步骤

3.3.1 模型选择注意事项

在选择 AI 模型时，需要特别注意以下关键点：

“`bash

# 配置过程中的重要提示

– OpenClaw 对上下文有要求，默认最小是 16000 Token

– 如果配置不满足要求，安装时会报错 [ref_2]

“`

3.3.2 推荐模型配置方案

根据实际需求选择适合的模型：

| 模型类型 | 配置方式 | API 地址 | 适用场景 |

|———-|———-|———-|———-|

| QuickStart | 快速开始 | 自动配置 | 新手体验 |

| DeepSeek | Custom Provider | https://api.deepseek.com/v1 | 代码生成 |

| GLM-4.7-Flash | Custom Provider | 智谱AI平台 | 免费使用 [ref_3] |

3.3.3 具体模型配置示例

配置 DeepSeek 模型：

“`bash

# 选择 Custom Provider

– Base URL: https://api.deepseek.com/v1

– API Key: sk- (您的实际 API 密钥)

– Model: deepseek-coder [ref_2]

“`

配置 GLM-4.7-Flash 免费 API：

“`bash

# 获取智谱AI API 密钥

1. 访问智谱AI开放平台 BigModel.cn

2. 注册/登录后，在控制台创建 API 密钥（以 sk- 开头）

3. 保存好 API 密钥用于后续配置 [ref_3]

“`

4. Skills 技能安装配置

4.1 技能选择建议

在配置过程中，系统会提示安装各种 Skills（技能）。根据您的具体需求选择安装：

“`bash

# Skills 安装界面会显示：

– 技能名称

– 功能说明

– 是否推荐安装

– 安装状态 [ref_2]

“`

4.2 常见问题解决

4.2.1 模型连接问题

如果遇到模型选择后一直显示 “waiting” 状态（如选择 Qwen 模型时），建议：

1. 检查网络连接

2. 验证 API 密钥是否正确

3. 确认模型服务是否可用

4. 尝试切换到其他模型提供商 [ref_2]

4.2.2 配置重置方法

如果之前配置过 OpenClaw，系统会提示是否使用原来的配置信息：

“`bash

# 可以使用 Reset 进行重置

– 选择 Reset 选项

– 重新开始配置流程

– 输入新的 API 密钥和模型参数 [ref_2]

“`

5. 安装完成验证

5.1 服务状态检查

安装配置完成后，验证 OpenClaw 是否正常运行：

“`bash

# 检查 OpenClaw 服务状态

systemctl status openclaw

# 或者通过进程检查

ps aux | grep openclaw

“`

5.2 访问测试

根据您选择的配置方式：

– TUI 方式：直接在终端中与 AI 助手交互

– Web 界面：通过浏览器访问提供的 URL

– API 集成：测试 API 接口连通性

6. 后续配置建议

6.1 钉钉机器人集成（可选）

如果需要将 OpenClaw 集成到钉钉机器人，参考以下步骤：

1. 在钉钉开发者平台创建机器人

2. 获取 Webhook 地址

3. 在 OpenClaw 中配置钉钉集成

4. 测试消息推送功能 [ref_3]

6.2 性能优化建议

对于资源有限的环境（如 2GB 内存的虚拟机）：

1. 使用云端 API 而非本地模型推理

2. 合理配置并发连接数

3. 定期清理缓存文件

4. 监控系统资源使用情况 [ref_3]

通过以上完整步骤，您应该能够在 Ubuntu24.04 系统上成功部署和配置 OpenClaw AI 平台。如果在任何步骤遇到问题，建议参考官方文档或相关技术社区的讨论。