腾讯云 Lighthouse + OpenClaw 浏览器 Ubuntu 24.04 配置指南

- 以内内容由AI总结

# 腾讯云Lighthouse服务器OpenClaw浏览器配置指南

本文核心思路参考腾讯云开发者社区原文：《Lighthouse × OpenClaw：手把手教你搞定浏览器配置与启动》

原文作者：云煮鱼

原文链接：[https://cloud.tencent.com/developer/article/2626186](https://cloud.tencent.com/developer/article/2626186)

---

## 前言

很多用户在腾讯云Lighthouse服务器安装完OpenClaw后，执行`openclaw browser status`会发现状态一直是`running: false`、`browser: unknown`，无法正常调用浏览器能力。原文作者云煮鱼已经给出了OpencloudOS系统的完整配置方案，但Ubuntu系统用户直接照搬教程会出现大量报错，本文将基于原文核心思路，提供Ubuntu系统的完整可执行配置流程，并标注所有踩坑点，帮大家避坑。

## 配置前准备

1. 已购买并启动腾讯云Lighthouse轻量应用服务器，系统为Ubuntu（本文基于Ubuntu 24.04演示）

2. 已在服务器内完成OpenClaw的安装部署

3. 已通过OrcaTerm（Lighthouse自带Web Shell）或SSH工具连接到服务器，拥有root操作权限

## 核心问题说明

OpenClaw浏览器启动失败，核心原因有两点：

1. 绝大多数Linux服务器默认没有预装Chrome浏览器，OpenClaw找不到可调用的浏览器程序

2. 服务器无桌面的Headless环境，需要特殊配置适配；同时root用户运行Chrome，必须关闭沙箱安全策略，否则会被Chrome拒绝启动

---

## Ubuntu系统完整配置步骤（含避坑说明）

### 1. 下载正确的Chrome安装包

**踩坑点**：原文针对OpencloudOS提供的是.rpm格式安装包，Ubuntu属于Debian系，不支持rpm包，直接下载会导致后续安装完全失败，必须下载对应deb格式安装包。

正确下载命令：

```Bash

# Ubuntu/Debian系统专用Chrome稳定版安装包

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

```

### 2. 更新系统源并安装依赖&中文字体

**踩坑点**：原文使用yum包管理器，Ubuntu不支持yum命令，直接执行会提示`Command 'yum' not found`；同时原文的字体、依赖包名在Ubuntu源中无法找到，直接使用会提示`E: Unable to locate package`，必须替换为Ubuntu适配的包名。

正确安装命令：

```Bash

# 更新apt软件源，确保能找到对应安装包

sudo apt update

# 安装Chrome所需依赖、基础字体和中文字体（防止网页中文乱码）

sudo apt install -y fonts-liberation xdg-utils fonts-noto-cjk

```

### 3. 安装Chrome浏览器

**踩坑点**：原文使用`yum localinstall`安装rpm包，Ubuntu不支持该命令，必须使用apt命令本地安装deb包，apt会自动补齐所有缺失的依赖，无需手动逐个安装。

正确安装命令：

```Bash

# 本地安装已下载的Chrome deb安装包

sudo apt install -y ./google-chrome-stable_current_amd64.deb

```

### 4. 验证Chrome安装结果

安装完成后，执行以下命令验证Chrome是否安装成功，并获取可执行文件路径，后续配置需要用到：

```Bash

# 查看Chrome安装路径，正常会返回 /usr/bin/google-chrome

which google-chrome

# 查看Chrome版本，确认安装成功

google-chrome --version

```

### 5. 配置OpenClaw浏览器核心参数

**踩坑点**：不要随意添加教程外的额外配置，本文测试中尝试添加`timeout`、`retry`、`limits`相关配置时，OpenClaw会提示`Unrecognized key`，导致配置校验失败，仅保留原文的4项核心配置即可正常运行。

正确配置命令：

```Bash

# 设置默认使用openclaw浏览器配置文件

openclaw config set browser.defaultProfile "openclaw"

# 开启无桌面Headless模式，适配服务器环境

openclaw config set browser.headless true

# 强制关闭沙箱模式，解决root用户运行Chrome被拒绝的问题

openclaw config set browser.noSandbox true

# 填写上一步获取的Chrome可执行文件路径

openclaw config set browser.executablePath "/usr/bin/google-chrome"

```

### 6. 验证配置并重启OpenClaw服务

配置完成后，先验证配置文件是否合法，再重启服务让配置生效：

```Bash

# 验证配置文件，正常会返回 Config valid 提示

openclaw config validate

# 重启OpenClaw网关服务，加载新配置

openclaw gateway restart

```

### 7. 启动浏览器并验证运行状态

最后执行浏览器启动命令，验证是否成功运行：

```Bash

# 启动OpenClaw浏览器组件

openclaw browser start

# 查看浏览器运行状态，成功会返回 running: true

openclaw browser status

```

成功运行的状态示例：

```Plain Text

🦞 browser [openclaw] running: true

```

---

## 踩坑总结

本文与原文的核心差异及避坑点汇总：

|配置项|原文OpencloudOS方案|Ubuntu系统正确方案|

|---|---|---|

|包管理器|yum|apt|

|Chrome安装包|.rpm格式|.deb格式|

|字体包名|liberation-fonts、google-noto-sans-cjk-fonts|fonts-liberation、fonts-noto-cjk|

|本地安装命令|yum localinstall|apt install ./xxx.deb|

## 最终效果

完成以上配置后，即可正常使用OpenClaw的浏览器能力，绑定的QQ机器人可以正常接收OpenClaw返回的网页搜索截图，也能正常执行打开网页、点击表单、内容填写、页面截图等自动化操作，真正让AI Agent拥有“睁眼看世界”的能力。

> （注：文档部分内容可能由 AI 生成）