# OpenClaw Gateway 在 WSL 环境中 systemd 用户服务故障排查手册


当openclaw安装成功后，想使用systemctl --user管理服务时，就出现了坑爹的一幕

```shell
cool@DESKTOP-UH68ET8:~$ systemctl --user enable openclaw-gateway.service
Failed to connect to bus: No such file or directory
```

# 1.诊断当前环境
```shell
1. 检查用户级的 systemd 运行时目录是否存在
ls -ld /run/user/$(id -u)

2. 查看 XDG_RUNTIME_DIR 环境变量是否设置正确
echo $XDG_RUNTIME_DIR

3. 直接尝试查看用户服务状态（看看是不是一样的报错）
systemctl --user status

4. 检查系统是否安装了用户会话必需的 D-Bus 模块
dpkg -l | grep dbus-user-session

5.检查 /etc/wsl.conf 配置，确保包含 systemd=true
cat /etc/wsl.conf

```
需要注意的
- 第一条命令如果返回 No such file or directory，说明系统根本没有为你当前的用户创建运行时目录，这是用户服务无法启动的根本原因之一 。

- 第二条命令应该输出类似 /run/user/1000 的路径，并且这个路径应该和第一条命令的路径一致。若没有可以执行手动设置命令 export XDG_RUNTIME_DIR=/run/user/$(id -u)；

- 第四条命令用于确认系统是否安装了 dbus-user-session 包。这个包对于用户级 D-Bus 的支持至关重要。如果 dbus-user-session 没有安装：请使用以下命令安装，然后重启系统以确保所有组件正确加载
```shell
sudo apt install dbus-user-session
```

# 2.手动重启 systemd 用户实例

```shell
sudo systemctl restart user@$(id -u).service
```
重启成功后验证是否生效

```shell
systemctl --user status
```

openclaw的systemd问题

## 在服务端安装完 OpenClaw 后，让小龙虾查找网页，截图等操作无法执行，接下来一步一步带你安装
其实 OpenClaw 的浏览器组件在无桌面环境（Headless）下需要特定的‘打开方式’
1. 我们需要从谷歌下载chrome软件包，每个系统安装chrome的软件包不一样，大家需要根据系统进行下载

Debian/Ubuntu (.deb):
```shell
# 下载浏览器
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

# 安装浏览器
sudo dpkg -i google-chrome-stable_current_amd64.deb

# 更新软件源
sudo apt update

# 安装Noto字体核心包
sudo apt install fonts-noto fonts-noto-cjk fonts-noto-color-emoji

# 刷新字体缓存
fc-cache -fv
```
或Centos(.rpm)安装包:
```shell
wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm

# 安装依赖包
yum install -y liberation-fonts
yum install -y xdg-utils

#安装字体，防止浏览器文字加载不出来
yum install -y google-noto-sans-cjk-fonts

# 安装google包 ，注意：这里用 yum localinstall，它会自动补齐依赖
yum localinstall -y ./google-chrome-stable_current_x86_64.rpm

```
2. 配置Openclaw
```shell
# 设置默认使用 openclaw 模式
openclaw config set browser.defaultProfile "openclaw"

# 再次确认无桌面模式开启
openclaw config set browser.headless true

# 2. 强制开启 NoSandbox （否则以root用户运行的openclaw，Chrome 出于安全策略拒绝启动）
openclaw config set browser.noSandbox true

# 确认chrome路径
openclaw config set browser.executablePath "/usr/bin/google-chrome"
```
3. 重启Openclaw
```shell
openclaw gateway restart
```
4. 启动浏览器
```shell
openclaw browser start
```
5. 查看浏览器配置,running: true
```shell
openclaw browser status
```

OpenClaw安装Google Chrom浏览器



:::info{title=""}
在 Ubuntu 24.04 LTS 上，虽然可以通过 Ubuntu 的官方仓库直接安装 Docker，但是这种方法通常无法获取到最新的 Docker 版本，而且安全更新也可能延迟。

因此，推荐从 Docker 的官方仓库进行安装，确保可以用上最新版本并和自动更新。
:::
1. 更新软件包
```shell
sudo apt update
``` 
2. 添加 Docker 仓库所需的前置软件包
```shell
sudo apt install apt-transport-https curl
```
3. 下载并导入 Docker 官方的 GPG 密钥
```shell
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
```
4. Docker官方仓库添加到 Ubuntu 24.04 LTS 的软件源列表
```shell
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
5. 更新软件包
```shell
sudo apt update
```
6. 安装最新版本的 Docker，包括 Docker 引擎及其相关组件
```shell
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
7. 检查Docker运行状态
```shell
sudo systemctl is-active docker
```
8. 替换国内源
```shell
sudo vim /etc/docker/daemon.json
```
```shell
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker-0.unsee.tech",
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live"
  ]
}
```
9. 重启 Docker 服务：保存配置文件并重启 Docker 服务以应用更改
```shell
sudo systemctl daemon-reload
```
```shell
sudo systemctl restart docker
```
10. 将当前登录的用户添加到 docker 组，以便以非 root 用户身份运行 Docker 命令
```shell
sudo usermod -aG docker ${USER}
```

在Ubuntu 24.04 LTS 上安装 Docker

1、下载浏览器安装包
```shell
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
```
2、执行安装（WSL中需sudo权限）
```shell
sudo dpkg -i google-chrome-stable_current_amd64.deb
```
3、如遇依赖问题，执行
```shell
sudo apt install -f
```

Ubuntu 25.10|25.04|24.04|22.04|20.04|18.04 用CLI安裝Chrome  

-rw------- (600)    只有拥有者有读写权限。
-rw-r--r-- (644)    只有拥有者有读写权限；而属组用户和其他用户只有读权限。
-rwx------ (700)    只有拥有者有读、写、执行权限。
-rwxr-xr-x (755)    拥有者有读、写、执行权限；而属组用户和其他用户只有读、执行权限。
-rwx--x--x (711)    拥有者有读、写、执行权限；而属组用户和其他用户只有执行权限。
-rw-rw-rw- (666)    所有用户都有文件读、写权限。
-rwxrwxrwx (777)    所有用户都有读、写、执行权限。