OpenClaw 从安装到稳定运行：超详细配置教程（Debian/Ubuntu/WSL，含工具权限/浏览器/通道/排错）

## 你将得到什么

按本文做完，你应该能达到以下状态：

1. OpenClaw 正常安装并运行（CLI + Gateway）
2. 模型已接入（官方 API 或中转API）
3. 工具权限理解清楚，不再卡在“没有权限执行此操作”
4. 浏览器能力可用（无头服务器 / WSL 二选一方案）
5. 至少一个消息通道接通（如 Telegram）
6. 遇到故障知道从哪里查、按什么顺序修

## 5 个核心组件

你可以把 OpenClaw 看成这 5 层：

1. **CLI（命令行）**：你输入 `openclaw ...` 的入口
2. **Gateway（服务）**：真正承载会话、路由、工具调用的后台服务
3. **Models（模型）**：LLM 提供方或自建兼容端点
4. **Tools（工具）**：读写文件、执行命令、浏览器、消息发送等能力
5. **Channels（通道）**：Telegram / WhatsApp / Discord 等消息入口

很多“看起来像模型问题”的报错，其实是 **工具权限** 或 **Gateway 状态** 问题。

## 环境与前置检查

### 推荐环境

* 系统：Debian / Ubuntu（WSL 同样适用）

> 完全体的 OpenClaw 还是建议在 macOS 上运行，不过不是所有人都有Mac Mini，也不是所有人都有一个云端或者本地的 Linux 环境，因此如果你是 Windows 用户，更建议你使用 WSL 安装 OpenClaw。

> 虽然 OpenClaw官方支持 Windows 平台，你也能在 Windows 平台上安装 OpenClaw，但是目前所有模型对于 Powershell 命令的支持并不好，因此不建议使用 Windows 部署。

* 用户：建议使用普通用户运行（非 root）

> 如果你跟笔者一样对于 Linux 系统足够有信心，选择 root 用户也未尝不可。

* 网络：可访问 OpenClaw 官方脚本地址、你使用的模型 API 地址。

> 一般来说服务器在中国香港或者国外则没有配置门槛，唯一需要担心的是 IP Quality，即 IP 要足够干净才能正常访问 ChatGPT 或是 Gemini。

### 基础依赖

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git jq
```

### 可选但建议的前置检查

```bash
date
getent hosts openclaw.ai
command -v openclaw || echo "openclaw not found"
```

## npm 安装

### nvm && npm 安装

[https://github.com/nvm-sh/nvm?tab=readme-ov-file#install--update-script](https://github.com/nvm-sh/nvm?tab=readme-ov-file#install--update-script)

遵循上面的安装教程。先执行 `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash` 或 `wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash`

安装后让环境变量立即在当前 session 生效：

```bash
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
```

然后执行下面命令以安装npm和node：

```bash
nvm install --lts
```

### npm 换源

如果你的部署机器在国内，为了加速下载，可将 npm 换为国内淘宝源。

```bash
npm config set registry https://registry.npmmirror.com
npm config get registry # 查看当前镜像源
```

### npm 安装 openclaw

```bash
npm i -g openclaw
```

### 安装后第一轮验收

```bash
openclaw --version
openclaw status
```

如果命令不存在，大概率是 PATH 未生效，开一个新终端再试。

## 模型接入

### 向导配置

如果安装后没自动进入向导，需要手动执行：

```bash
openclaw onboard
```

### 安全警告

等待了一会，出现了安全警示，使用键盘的方向键调整到 Yes ，点击回车

![](https://mjy.js.org/_astro/image-20260308153530659.BEoggNn3_Z13az4t.webp)

### 快速开始

![](https://mjy.js.org/_astro/image-20260308153808914.B5jAAeSN_Z17MOBN.webp)

此处选用快速开始，方便快速配置。

### 模型提供商

向导里最重要的是模型部分（Model / Provider）：

* 你可以选官方提供方
* 也可以选 Custom Provider（兼容 OpenAI/Anthropic 的自建端点）

如果是 Custom Provider，通常需填写：

* `baseUrl`（常见为 `https://xxx/v1`）
* `apiKey`
* `modelId`

![](https://mjy.js.org/_astro/image-20260308153847096.DwOa1bG9_Z1HO05A.webp)

这里我们选用来自互联网大善人 OpenAI 的 ChatGPT（实际上是 Codex），个人免费账户有一定的额度但不多，这边建议购买一个月抛的 Team 席位。

你可前往小黄鱼购买，也可使用笔者提供的这两个链接：

[ChatGPT Business Team 自助开通](https://codexcn.com/)

[Team Invite](https://chong.team/)

购买成功后去邮箱里加入团队空间即可。

说明：开通后团队席位有效30天，30天后工作空间将无法进入。因此到期后你在工作空间里的聊天记录将不可访问。这里我们主要用到的是 Team 版的 Codex 额度，因此有关聊天记录在空间之间迁移的教程不做说明。

选择 OpenAI 后回车，使用 OAuth 方法登录。

![](https://mjy.js.org/_astro/image-20260308154257055.GSvg0hjF_BiqQe.webp)

这里需要保证你的配置机器可以访问 OpenAI。如果你在 WSL 中部署，请试图打开相关代理软件的虚拟网卡模式，或自行搜索 WSL 如何配置代理。连接实验室 WIFI OnePlus 13T 6666的同学可以直接使用，无需进行代理配置。

![](https://mjy.js.org/_astro/image-20260308154450891.DKoeheq2_2NFtP.webp)

按住 Ctrl，单击链接，用本机浏览器打开 OpenAI OAuth 页面。登录你的 ChatGPT 账户，选择团队空间后登录。如果没有显示团队空间，请检查是否已经同意邀请加入团队空间。登录完成后会跳转到 localhost 页面，此时复制地址栏中地址粘贴回终端的 `Paste the redirect URL` 处回车即可。如图所示。

![](https://mjy.js.org/_astro/image-20260308154915091.wHAuz26P_ZzMhwy.webp)

选择模型，若无特殊需求选择最前沿模型即可。笔者这里选择了 `openai-codex/gpt-5.4`

![](https://mjy.js.org/_astro/image-20260308155007753.DBs3q-4H_ibCGo.webp)

### 配置消息渠道

此处以 Telegram 渠道为例，如果你想配置 QQ 渠道，请先选择Skip for now。如果你想配置其他渠道，请查阅对应文档。

![](https://mjy.js.org/_astro/image-20260308155128186.BqJcLQ_-_Z1h7U2n.webp)

此处配置以 Telegram 渠道为例。同样的，需要保证你的机器支持连接 Telegram。假定你有 Telegram 账号，给 `@BotFather` 发消息 `/newbot` 创建新机器人。

![](https://mjy.js.org/_astro/image-20260308153318046.E1FGp0w5_Z12DXId.webp)

新版 Telegram 似乎会在新弹出的窗口中让你创建机器人，如下图所示。

![](https://mjy.js.org/_astro/image-20260308153335225.dzTPeSQC_1nsdgm.webp)

点击 `Create a New Bot`， 创建一个新机器人。

![](https://mjy.js.org/_astro/image-20260308153410980.B89lxseZ_Z2m87V2.webp)

请详细阅读页面上的说明。机器人名字任取，但机器人的 username 需要以 _bot 结尾。

![](https://mjy.js.org/_astro/image-20260308153450331.DWRZZVoj_ZAHtVK.webp)

在此页面复制你的机器人密钥。请注意一定要妥善保管你的密钥，不要泄露。

![](https://mjy.js.org/_astro/image-20260308155714733.CxyBjd9N_Z1TC40f.webp)

此处选择 `Enter Telegram bot token` 后回车。

![](https://mjy.js.org/_astro/image-20260308160135672.Vu55vXx4_2hpaqi.webp)

粘贴密钥后回车

### 配置Web Search服务

![](https://mjy.js.org/_astro/image-20260308160222227.CvxT8UHK_EEOBS.webp)

这一块先跳过，因为这些api注册有点麻烦，箭头移动到最后的 Skip for now 暂时跳过。

### 配置 Skills

![](https://mjy.js.org/_astro/image-20260308160400412.BxF-OyQz_Z2lt6ga.webp)

选择你想安装的 Skills，按空格打上勾，然后回车。

大部分 Skills 还是为 macOS 而设计，Skills 也可以后续让 AI 自动配置，因此如果这里你不想配置那么用空格打上 `Skip for now` 的勾然后回车。

### 其他 API 配置

![](https://mjy.js.org/_astro/image-20260308160626340.BGelO_qb_Zcvwu0.webp)

这些目前都不需要配置，不影响使用。如果你懂如何配置，请自行配置。

### 配置 Hooks

![](https://mjy.js.org/_astro/image-20260308160712142.D9NsPIRa_Zg2MrL.webp)

这里这四个都要启用，然后回车。

### 完成配置

![](https://mjy.js.org/_astro/image-20260308160816756.CwOhvwA4_1K4IDN.webp)

如图正在安装 OpenClaw Gateway。

![](https://mjy.js.org/_astro/image-20260308160844957.BdmUPM4u_Zs8rJU.webp)

此处选择 `Do this later`，因为你目前没有配置 ssh隧道，也没有图形化浏览器

完成后先不要急着聊天，先体检：

```bash
openclaw config validate
openclaw doctor --deep
```

### Telegram 侧配置

Telegram 私聊默认通常是 `pairing` 机制（首次联系人需要配对批准）。

先查看待批准配对请求：

```bash
openclaw pairing list telegram
```

再用机器人回复给你的 code 进行批准：

```bash
openclaw pairing approve telegram <PAIRING_CODE>
```

> 例如 `openclaw pairing approve telegram JNCRAMPD`。

搜索找到你当时创建的机器人。例如我的是：`@mjy_oc_bot`

![](https://mjy.js.org/_astro/image-20260308161437517.DaMN54TZ_20TpQI.webp)

点击 `消息`（或 Message），输入 `Start`

![](https://mjy.js.org/_astro/image-20260308161512423.V10LJAij_2u29T.webp)

按照提示在终端进行配置（把 code 换成你自己的）：

```bash
openclaw pairing approve telegram <PAIRING_CODE>
```

![](https://mjy.js.org/_astro/image-20260308161618763.BintJriT_4MPJ9.webp)

而后在 Telegram 对话窗口再次输入 `/start`

![](https://mjy.js.org/_astro/image-20260308161751081.DOuwT3vA_Z1fYUhO.webp)

按照 AI 回复你的提示配置你的专属 OpenClaw。直接用中文回复即可。

![](https://mjy.js.org/_astro/image-20260308162938627.DWkOciH1_S1oH2.webp)

### 配置与自检

配置文件一般在：`~/.openclaw/openclaw.json` 每次改完配置建议先跑：

```bash
openclaw doctor --fix
```

再重启网关：

```bash
openclaw gateway restart
```

## Gateway 服务管理

这是最常用的一组命令：

```bash
openclaw gateway status
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
```

如果你需要重装服务（例如服务注册坏掉）：

```bash
openclaw gateway install --force
openclaw gateway restart
```

如果只想打开控制台 UI：

```bash
openclaw dashboard
# 或只打印地址不自动打开浏览器（自行打通 ssh 隧道）
openclaw dashboard --no-open
```

### 远程服务器访问 Dashboard（SSH 隧道）

如果 OpenClaw 跑在远程服务器，本地用 SSH 隧道访问最稳：

```bash
# 本地电脑执行
ssh -N -L 18789:127.0.0.1:18789 <user>@<server-ip>
```

然后本地浏览器打开：`http://127.0.0.1:18789`

如果页面提示未授权，先在服务器执行 `openclaw dashboard --no-open`，复制带 token 的地址打开即可。

## 配置文件管理

先找到真实配置路径：

```bash
openclaw config file
```

建议每次大改前先备份：

```bash
openclaw backup create
```

常用配置命令：

```bash
openclaw config get tools.profile
openclaw config set tools.profile coding
openclaw config unset tools.web.search.apiKey
openclaw config validate
```

> 配置改完一定要 `openclaw gateway restart`，再做验证。

## 工具权限：解决“没有权限执行此操作”

这是新手最常见坑点。

先看当前工具策略：

```bash
openclaw config get tools.profile
```

常见策略理解：

* `messaging`：偏聊天
* `coding`：适合大多数本地读写/命令场景（推荐）
* `full`：全开权限（强但风险最大）

推荐做法：

```bash
# 先用 coding，多数场景够用
openclaw config set tools.profile coding
openclaw gateway restart
```

你明确知道风险、且确实需要全工具时再切 `full`：

```bash
openclaw config set tools.profile full
openclaw gateway restart
```

> 建议：公网环境下优先 `coding`，并配合最小暴露策略

## 浏览器能力

OpenClaw 的浏览器控制常见两种思路：

1. `openclaw profile`（独立托管浏览器）：更适合服务器
2. `chrome profile`（扩展接管你本地 Chrome 标签）：更适合桌面端

### 无头服务器（Debian/Ubuntu）推荐方案

#### 第一步：安装浏览器

```bash
# 1. 更新本地软件包索引，确保获取最新的依赖信息
sudo apt update
# dl.google.com 可能需要国际互联网连接
# 2. 下载适用于 Debian/Ubuntu 的 64位安装包 (.deb 格式)
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
# 3. 安装 Google Chrome
# apt install 会自动处理并安装缺失的依赖库（如 libgbm1, xdg-utils 等）
sudo apt install -y ./google-chrome-stable_current_amd64.deb
# 4. 安装中文字体，防止中文网页显示为方框（Tofu）
sudo apt install -y fonts-noto-cjk
```

#### 第二步：写入 OpenClaw 浏览器配置

```bash
# 1. 使用独立浏览器需要此配置
openclaw config set browser.defaultProfile "openclaw"
# 2. 服务器没有显示器，必须开启 无头模式 才能在后台静默运行
openclaw config set browser.headless true
# 3. 在 Linux 服务器（尤其是以 root 身份运行时）必须开启 禁用沙盒模式 ，否则 Chrome 会因权限安全机制无法启动
openclaw config set browser.noSandbox true
# 4. 使用 $(which google-chrome) 自动获取二进制文件的实际安装路径（通常是 /usr/bin/google-chrome），动态设置 Chrome 可执行文件路径
openclaw config set browser.executablePath "$(which google-chrome)"
# 5. 重启 openclaw 网关
openclaw gateway restart
# 6. 为 openclaw 打开浏览器
openclaw browser start
```

#### 第三步：重启并验证

```bash
openclaw gateway restart
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw tabs
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot
```

#### WSL 场景（Xvfb 虚拟显示）

当你需要 headed 行为时，可用 Xvfb 包一层 Chromium：

```bash
sudo apt install -y chromium xvfb
mkdir -p ~/.local/bin

cat > ~/.local/bin/chromium-xvfb << 'EOF'
#!/usr/bin/env bash
if ! pgrep -f "Xvfb :99" >/dev/null 2>&1; then
  Xvfb :99 -screen 0 1920x1080x24 -ac +extension GLX +render -noreset &
  sleep 1
fi
export DISPLAY=:99
exec /usr/bin/chromium "$@"
EOF

chmod +x ~/.local/bin/chromium-xvfb

openclaw config set browser.defaultProfile "openclaw"
openclaw config set browser.headless false
openclaw config set browser.executablePath "$HOME/.local/bin/chromium-xvfb"
openclaw gateway restart
openclaw browser --browser-profile openclaw start
```

#### 本地桌面 Chrome 扩展接管（可选）

如果你想让 OpenClaw 接管已有 Chrome 标签页：

```bash
openclaw browser extension install
openclaw browser extension path
```

然后去 `chrome://extensions`：

1. 打开开发者模式
2. 加载 unpacked 扩展目录（上一步输出路径）
3. 使用 `--browser-profile chrome` 进行操作

## 通道接入（Telegram / QQ / …）

先看当前能力和要求：

```bash
openclaw channels capabilities
```

### Telegram 示例

```bash
openclaw channels add --channel telegram --token <BOT_TOKEN>
openclaw channels status
openclaw channels list
```

### QQ 机器人配置

此处教程来源：猫猫摸大鱼 原文地址：`https://iloli.love/archives/1772284805466`

也可参考仓库README：`https://github.com/sliverp/qqbot`

运行下面的命令，安装 QQ 通道插件

```bash
openclaw plugins install @sliverp/qqbot@1.5.4
```

然后创建 QQ 机器人，访问 QQ 开放平台 `https://q.qq.com/`

或 `https://q.qq.com/qqbot/openclaw/login.html`

如果你尚未注册过，需要先注册账号（需要实名信息，扫脸，以及一个 QQ 号作为管理员 QQ 号），非常简单，这里就不赘述了。

## 转载说明

本文从 [OpenClaw 从安装到稳定运行：超详细配置教程（Debian/Ubuntu/WSL，含工具权限/浏览器/通道/排错） - TranquilYu's Blog](https://mjy.js.org/posts/openclaw-installation-and-configuration-guide/) 转载并进行了部分修改，符合 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议

AI摘要

本文提供了一个详细的OpenClaw配置教程，包括安装、模型接入、工具权限、浏览器能力配置、消息通道接通以及故障排查。教程适用于Debian/Ubuntu/WSL系统，涵盖了从基础依赖安装到配置文件管理的全过程。文章还提供了如何通过命令行管理Gateway服务、设置工具权限以及解决常见问题的方法。此外，还介绍了如何在不同环境下配置浏览器能力，以及如何接入Telegram和QQ等消息通道。

你将得到什么

按本文做完，你应该能达到以下状态：

OpenClaw 正常安装并运行（CLI + Gateway）
模型已接入（官方 API 或中转API）
工具权限理解清楚，不再卡在“没有权限执行此操作”
浏览器能力可用（无头服务器 / WSL 二选一方案）
至少一个消息通道接通（如 Telegram）
遇到故障知道从哪里查、按什么顺序修

5 个核心组件

你可以把 OpenClaw 看成这 5 层：

CLI（命令行）：你输入 openclaw ... 的入口
Gateway（服务）：真正承载会话、路由、工具调用的后台服务
Models（模型）：LLM 提供方或自建兼容端点
Tools（工具）：读写文件、执行命令、浏览器、消息发送等能力
Channels（通道）：Telegram / WhatsApp / Discord 等消息入口

很多“看起来像模型问题”的报错，其实是 工具权限 或 Gateway 状态 问题。

环境与前置检查

基础依赖

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git jq

可选但建议的前置检查

date
getent hosts openclaw.ai
command -v openclaw || echo "openclaw not found"

npm 安装

nvm && npm 安装

https://github.com/nvm-sh/nvm?tab=readme-ov-file#install--update-script

遵循上面的安装教程。先执行 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash 或 wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

安装后让环境变量立即在当前 session 生效：

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

然后执行下面命令以安装npm和node：

nvm install --lts

npm 换源

如果你的部署机器在国内，为了加速下载，可将 npm 换为国内淘宝源。

npm config set registry https://registry.npmmirror.com
npm config get registry # 查看当前镜像源

npm 安装 openclaw

npm i -g openclaw

安装后第一轮验收

openclaw --version
openclaw status

如果命令不存在，大概率是 PATH 未生效，开一个新终端再试。

模型接入

向导配置

如果安装后没自动进入向导，需要手动执行：

openclaw onboard

安全警告

等待了一会，出现了安全警示，使用键盘的方向键调整到 Yes ，点击回车

快速开始

此处选用快速开始，方便快速配置。

模型提供商

向导里最重要的是模型部分（Model / Provider）：

你可以选官方提供方
也可以选 Custom Provider（兼容 OpenAI/Anthropic 的自建端点）

如果是 Custom Provider，通常需填写：

baseUrl（常见为 https://xxx/v1）
apiKey
modelId

这里我们选用来自互联网大善人 OpenAI 的 ChatGPT（实际上是 Codex），个人免费账户有一定的额度但不多，这边建议购买一个月抛的 Team 席位。

你可前往小黄鱼购买，也可使用笔者提供的这两个链接：

ChatGPT Business Team 自助开通

Team Invite

购买成功后去邮箱里加入团队空间即可。

选择 OpenAI 后回车，使用 OAuth 方法登录。

按住 Ctrl，单击链接，用本机浏览器打开 OpenAI OAuth 页面。登录你的 ChatGPT 账户，选择团队空间后登录。如果没有显示团队空间，请检查是否已经同意邀请加入团队空间。登录完成后会跳转到 localhost 页面，此时复制地址栏中地址粘贴回终端的 Paste the redirect URL 处回车即可。如图所示。

选择模型，若无特殊需求选择最前沿模型即可。笔者这里选择了 openai-codex/gpt-5.4

配置消息渠道

此处以 Telegram 渠道为例，如果你想配置 QQ 渠道，请先选择Skip for now。如果你想配置其他渠道，请查阅对应文档。

此处配置以 Telegram 渠道为例。同样的，需要保证你的机器支持连接 Telegram。假定你有 Telegram 账号，给 @BotFather 发消息 /newbot 创建新机器人。

新版 Telegram 似乎会在新弹出的窗口中让你创建机器人，如下图所示。

点击 Create a New Bot，创建一个新机器人。

请详细阅读页面上的说明。机器人名字任取，但机器人的 username 需要以 _bot 结尾。

在此页面复制你的机器人密钥。请注意一定要妥善保管你的密钥，不要泄露。

此处选择 Enter Telegram bot token 后回车。

粘贴密钥后回车

配置Web Search服务

这一块先跳过，因为这些api注册有点麻烦，箭头移动到最后的 Skip for now 暂时跳过。

配置 Skills

选择你想安装的 Skills，按空格打上勾，然后回车。

大部分 Skills 还是为 macOS 而设计，Skills 也可以后续让 AI 自动配置，因此如果这里你不想配置那么用空格打上 Skip for now 的勾然后回车。

其他 API 配置

这些目前都不需要配置，不影响使用。如果你懂如何配置，请自行配置。

配置 Hooks

这里这四个都要启用，然后回车。

完成配置

如图正在安装 OpenClaw Gateway。

此处选择 Do this later，因为你目前没有配置 ssh隧道，也没有图形化浏览器

完成后先不要急着聊天，先体检：

openclaw config validate
openclaw doctor --deep

Telegram 侧配置

Telegram 私聊默认通常是 pairing 机制（首次联系人需要配对批准）。

先查看待批准配对请求：

openclaw pairing list telegram

再用机器人回复给你的 code 进行批准：

openclaw pairing approve telegram <PAIRING_CODE>

例如 openclaw pairing approve telegram JNCRAMPD。

搜索找到你当时创建的机器人。例如我的是：@mjy_oc_bot

点击 消息（或 Message），输入 Start

按照提示在终端进行配置（把 code 换成你自己的）：

openclaw pairing approve telegram <PAIRING_CODE>

而后在 Telegram 对话窗口再次输入 /start

按照 AI 回复你的提示配置你的专属 OpenClaw。直接用中文回复即可。

配置与自检

配置文件一般在：~/.openclaw/openclaw.json 每次改完配置建议先跑：

openclaw doctor --fix

再重启网关：

openclaw gateway restart

Gateway 服务管理

这是最常用的一组命令：

openclaw gateway status
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

如果你需要重装服务（例如服务注册坏掉）：

openclaw gateway install --force
openclaw gateway restart

如果只想打开控制台 UI：

openclaw dashboard
# 或只打印地址不自动打开浏览器（自行打通 ssh 隧道）
openclaw dashboard --no-open

远程服务器访问 Dashboard（SSH 隧道）

如果 OpenClaw 跑在远程服务器，本地用 SSH 隧道访问最稳：

# 本地电脑执行
ssh -N -L 18789:127.0.0.1:18789 <user>@<server-ip>

然后本地浏览器打开：http://127.0.0.1:18789

如果页面提示未授权，先在服务器执行 openclaw dashboard --no-open，复制带 token 的地址打开即可。

配置文件管理

先找到真实配置路径：

openclaw config file

建议每次大改前先备份：

openclaw backup create

常用配置命令：

openclaw config get tools.profile
openclaw config set tools.profile coding
openclaw config unset tools.web.search.apiKey
openclaw config validate

配置改完一定要 openclaw gateway restart，再做验证。

工具权限：解决“没有权限执行此操作”

这是新手最常见坑点。

先看当前工具策略：

openclaw config get tools.profile

常见策略理解：

messaging：偏聊天
coding：适合大多数本地读写/命令场景（推荐）
full：全开权限（强但风险最大）

推荐做法：

# 先用 coding，多数场景够用
openclaw config set tools.profile coding
openclaw gateway restart

你明确知道风险、且确实需要全工具时再切 full：

openclaw config set tools.profile full
openclaw gateway restart

建议：公网环境下优先 coding，并配合最小暴露策略

浏览器能力

OpenClaw 的浏览器控制常见两种思路：

openclaw profile（独立托管浏览器）：更适合服务器
chrome profile（扩展接管你本地 Chrome 标签）：更适合桌面端

无头服务器（Debian/Ubuntu）推荐方案

第一步：安装浏览器

# 1. 更新本地软件包索引，确保获取最新的依赖信息
sudo apt update
# dl.google.com 可能需要国际互联网连接
# 2. 下载适用于 Debian/Ubuntu 的 64位安装包 (.deb 格式)
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
# 3. 安装 Google Chrome
# apt install 会自动处理并安装缺失的依赖库（如 libgbm1, xdg-utils 等）
sudo apt install -y ./google-chrome-stable_current_amd64.deb
# 4. 安装中文字体，防止中文网页显示为方框（Tofu）
sudo apt install -y fonts-noto-cjk

第二步：写入 OpenClaw 浏览器配置

# 1. 使用独立浏览器需要此配置
openclaw config set browser.defaultProfile "openclaw"
# 2. 服务器没有显示器，必须开启 无头模式 才能在后台静默运行
openclaw config set browser.headless true
# 3. 在 Linux 服务器（尤其是以 root 身份运行时）必须开启 禁用沙盒模式 ，否则 Chrome 会因权限安全机制无法启动
openclaw config set browser.noSandbox true
# 4. 使用 $(which google-chrome) 自动获取二进制文件的实际安装路径（通常是 /usr/bin/google-chrome），动态设置 Chrome 可执行文件路径
openclaw config set browser.executablePath "$(which google-chrome)"
# 5. 重启 openclaw 网关
openclaw gateway restart
# 6. 为 openclaw 打开浏览器
openclaw browser start

第三步：重启并验证

openclaw gateway restart
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw tabs
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

WSL 场景（Xvfb 虚拟显示）