Browser Linux Troubleshooting

Linux 系统浏览器工具问题排查。

常见问题

1. 浏览器无法启动

错误信息: Failed to launch browser

解决方案:

# 安装依赖
sudo apt-get install -y \
  chromium-browser \
  chromium-codecs-ffmpeg-extra \
  libnss3 libnspr4 \
  libatk1.0-0 libatk-bridge2.0-0 \
  libcups2 libdrm2 libxkbcommon0 \
  libxcomposite1 libxdamage1 libxfixes3 \
  libxrandr2 libgbm1 libpango-1.0-0 \
  libasound2t64

2. 权限问题

错误信息: Permission denied

解决方案:

# 创建用户数据目录
mkdir -p ~/.config/openclaw
chmod 700 ~/.config/openclaw

3. 内存不足

错误信息: Out of memory

解决方案:

# 限制浏览器内存
export MOLTBOT_BROWSER_MEMORY=1024

Docker 环境

如果使用 Docker，需要添加以下参数：

FROM node:20

# 安装浏览器
RUN apt-get update && apt-get install -y \
  chromium \
  chromium-driver

ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
ENV CHROME_PATH=/usr/bin/chromium

相关文档

• browser - 浏览器工具