1. 准备工作

1.1 配置信息

项目	规格
系统版本	Ubuntu 24.04 LTS
虚拟机CPU	2核
虚拟机内存	4GB
虚拟机硬盘	40GB

1.2 下载虚拟机镜像并导入

访问镜像管理页面

进入虚拟化管理平台，点击「管理」→「镜像」

上传Ubuntu镜像

镜像下载完成后，可以选择：

从本地电脑直接上传
先上传到NAS，再从NAS选择导入

确认镜像导入成功

2. 创建虚拟机

新建虚拟机

点击「新建」按钮

选择镜像和存储位置

选择刚才上传的Ubuntu镜像
选择存放虚拟机文件的存储空间

配置虚拟机参数

根据配置信息设置虚拟机参数：

CPU：2核
内存：4GB
硬盘：40GB
网络设置：保持默认

配置完成后，点击「完成」

启动虚拟机并安装Ubuntu

点击启动按钮，开始安装Ubuntu系统，请按照安装向导完成系统配置。

💡 提示：Ubuntu安装过程中，请耐心等待所有步骤完成后重启虚拟机。

3. 安装OpenClaw

3.1 系统要求检查

在开始安装前，请确保您的系统满足以下要求：

要求项	最低配置	推荐配置
Node.js	>= 22	22.22.0 或更高
操作系统	Ubuntu 24.04、macOS、Linux 或 WSL2	-
权限	用户权限	管理员权限（部分功能）
构建工具	无需	pnpm（仅从源码构建时需要）

⚠️ 安全提示：OpenClaw具备自动化操作能力，如果您的设备存有重要商业资产或个人隐私信息，强烈建议：

准备一台干净的备用设备

或租用云端虚拟机（VPS）来运行OpenClaw

3.2 安装OpenClaw

方式一：快速安装（推荐）

Linux / macOS：

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

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

⚠️ PowerShell用户注意：如果遇到执行策略报错，请先运行以下命令：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

方式二：手动安装

如果已在系统安装Node.js，可通过npm安装：

npm install -g openclaw@latest

方式三：Windows版本管理

Windows用户推荐使用 nvm-windows 管理Node.js版本：

下载安装 nvm-windows
- 下载文件：nvm-setup.exe
- 双击运行安装程序
使用管理员权限打开PowerShell，安装Node.js：

nvm install 22
nvm use 22.22.0

继续执行OpenClaw安装命令

3.3 初始化配置

安装完成后，请执行以下步骤完成初始化配置：

步骤1：运行新手引导

openclaw onboard --install-daemon

或使用快速流程（推荐新手）：

openclaw onboard --flow quickstart

执行后会看到配置向导：

◆ I understand this is powerful and inherently risky. Continue?
│ ● Yes / ○ No
└

请选择「Yes」继续设置。

步骤2：配置向导选项

配置向导会依次询问以下信息：

配置项	推荐选项	说明
AI模型	Anthropic	Claude系列模型效果更好
API Key	填入您的密钥	需提前到对应平台获取
工作空间	使用默认	后续可修改
消息频道	可跳过	非必需功能
技能包	可跳过	后续可随时补充

步骤3：智谱AI配置

查看当前配置状态

首先运行以下命令查看OpenClaw的运行状态和配置文件位置：

openclaw gateway status

输出示例及说明：

root@openclaw:~# openclaw gateway status

🦞 OpenClaw 2026.2.3-1 (d84eb46) — Because Siri wasn't answering at 3AM.

│
◇
Service: systemd (enabled)              # 服务方式：已通过systemd启用
File logs: /tmp/openclaw/openclaw-2026-02-07.log  # 日志文件路径
Command: /usr/bin/node /usr/lib/node_modules/openclaw/dist/index.js gateway --port 18789  # 启动命令
Service file: ~/.config/systemd/user/openclaw-gateway.service  # systemd服务文件
Service env: OPENCLAW_GATEWAY_PORT=18789  # 环境变量配置

Config (cli): ~/.openclaw/openclaw.json  # CLI命令使用的配置文件
Config (service): ~/.openclaw/openclaw.json  # 服务使用的配置文件

Gateway: bind=lan (0.0.0.0), port=18789 (service args)  # 网关绑定地址和端口
Probe target: ws://127.0.0.1:18789  # 探测目标地址
Dashboard: http://127.0.0.1:18789/  # 仪表板访问地址
Probe note: Local probe uses loopback (127.0.0.1). bind=lan listens on 0.0.0.0 (all interfaces); use a LAN IP for remote clients.

Runtime: running (pid 149097, state active, sub running, last exit 0, reason 0)  # 运行状态
RPC probe: ok  # RPC接口探测成功

Listening: *:18789  # 监听地址
Troubles: run openclaw status  # 故障排查命令
Troubleshooting: https://docs.openclaw.ai/troubleshooting  # 故障排查文档链接

编辑配置文件

OpenClaw的主配置文件位于：~/.openclaw/openclaw.json

使用文本编辑器打开：

vim ~/.openclaw/openclaw.json

智谱AI模型配置说明

在配置文件中找到 models 部分，配置如下：

"models": {
  "mode": "merge",  // 模式：merge（合并）或 override（覆盖）
  "providers": {
    "zhipu-cn": {  // 智谱AI提供商ID
      "baseUrl": "https://open.bigmodel.cn/api/anthropic",  // API基础URL
      "apiKey": "YOUR_API_KEY_HERE.xxxxxxxxxxxxxx",  // ⚠️ 替换为您的智谱AI API密钥
      "api": "anthropic-messages",  // API类型
      "models": [
        {
          "id": "glm-4.7",  // 模型ID
          "name": "GLM-4.7 (China)",  // 模型显示名称
          "reasoning": true,  // 支持推理能力
          "input": ["text"],  // 支持的输入类型
          "cost": {  // 成本配置（每百万tokens价格，单位：元）
            "input": 0.1,      // 输入价格
            "output": 0.1,     // 输出价格
            "cacheRead": 0,    // 缓存读取价格
            "cacheWrite": 0    // 缓存写入价格
          },
          "contextWindow": 200000,  // 上下文窗口大小（tokens数量）
          "maxTokens": 8192  // 最大输出tokens数
        }
      ]
    }
  }
}

获取智谱AI API密钥

访问智谱AI开放平台
注册/登录账号
进入「API密钥」页面
创建新API密钥
复制密钥并妥善保管（仅显示一次）

智谱AI参数说明

参数	说明	推荐值
`id`	模型标识符	`glm-4.7`（付费版）或 `glm-4-flash`（免费版）
`reasoning`	是否启用推理能力	`true`（需要复杂推理时）
`contextWindow`	上下文窗口大小	200000（GLM-4.7）或128000（GLM-4-flash）
`maxTokens`	最大输出长度	8192
`cost`	价格配置	按实际价格设置

⚠️ 注意：

不要使用截图中的示例API密钥，必须替换为您自己的密钥

API密钥具有完整权限，请妥善保管，不要泄露给他人

免费版模型（GLM-4-flash）有一定调用次数限制

步骤4：网络配置

网络配置参数说明

在 openclaw.json 中，修改 gateway 部分：

"gateway": {
  "port": 18789,  // 网关端口号
  "mode": "local",  // 运行模式：local / lan / remote
  "bind": "lan",  // 绑定模式：local / lan / remote
  "controlUi": {
    "allowInsecureAuth": false  // ⚠️ 生产环境请设置为 false
  },
  "auth": {
    "mode": "token",  // 认证模式：none / token / basic
    "token": "REPLACE_WITH_SECURE_TOKEN_HERE"  // 登录令牌（建议32位随机字符串）
  },
  "tailscale": {
    "mode": "off",  // Tailscale支持：off / connect / listen
    "resetOnExit": false
  }
}

bind模式详解

模式	绑定地址	访问范围	适用场景
`local`	`127.0.0.1`	仅本机访问	本地开发测试
`lan`	`0.0.0.0`	局域网访问	家庭/办公室网络内多设备访问
`remote`	公网IP	公网访问	远程连接（需配合Tailscale或VPN）

认证模式说明

mode	说明	安全性
`none`	无需认证	🔴 不安全，仅供测试
`token`	Token令牌认证	🟢 推荐
`basic`	用户名密码认证	🟡 较安全

生成安全Token（可选）

使用以下命令生成32位随机Token：

# 方法1：使用openssl
openssl rand -hex 32

# 方法2：使用Python
python3 -c "import secrets; print(secrets.token_hex(32))"

# 方法3：使用Node.js
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

配置示例（推荐配置）

"gateway": {
  "port": 18789,
  "mode": "lan",
  "bind": "lan",
  "controlUi": {
    "allowInsecureAuth": false  // 🔒 关闭不安全认证
  },
  "auth": {
    "mode": "token",
    "token": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"  // 替换为您生成的token
  },
  "tailscale": {
    "mode": "off",
    "resetOnExit": false
  }
}

重启网关使配置生效

# 重启OpenClaw网关服务
openclaw gateway restart

# 或使用systemd
systemctl --user restart openclaw-gateway.service

# 验证配置
openclaw gateway status

网络访问测试

同一局域网内其他设备：

在浏览器中访问：
```
http://服务器IP地址:18789
```
例如：http://192.168.1.100:18789
输入Token进行登录：

首次访问会提示输入Token，填入您配置的令牌即可登录。

📌 提示：如果局域网内无法访问，请检查防火墙设置：
# Ubuntu允许18789端口
sudo ufw allow 18789/tcp

3.4 安装验证

执行以下命令逐一验证安装和配置：

1️⃣ 检查安装状态

openclaw doctor

预期结果：显示所有组件状态正常

2️⃣ 检查Gateway网关状态

openclaw status

预期结果：显示gateway运行状态为"running"

3️⃣ 检查健康状态

openclaw health

预期结果：各项健康检查指标正常

4️⃣ 启动网关服务

openclaw gateway --port 18789 --verbose

💡 说明：此命令会在前台运行，终端将被占用。启动成功后，可通过浏览器访问 http://localhost:18789 查看控制台。按 Ctrl+C 可停止服务。

5️⃣ 打开仪表板（可选）

openclaw dashboard

3.5 安装成功确认

完成验证后，请确认以下检查项：

openclaw doctor 显示所有组件状态正常
openclaw status 显示gateway运行状态为 running
openclaw health 报告健康状态良好
浏览器可正常访问 http://localhost:18789 控制台
可通过自然语言执行基础测试任务

3.6 常见问题排查

问题1：命令找不到

现象：openclaw 命令无法执行

排查步骤：

# 检查命令是否在PATH中
which openclaw # Linux/macOS
where openclaw # Windows

解决方案：重新安装或手动添加到系统PATH环境变量

问题2：Node版本过低

现象：提示需要Node.js 22或更高版本

排查步骤：

node -v

解决方案：使用nvm安装Node 22

nvm install 22
nvm use 22

问题3：权限不足

现象：执行命令时提示权限不足

解决方案：使用sudo运行需要管理员权限的命令

sudo openclaw onboard --install-daemon

问题4：Gateway无法启动

现象：执行gateway命令后启动失败

排查步骤：检查端口是否被占用

# Linux/macOS
lsof -i :18789

# Windows
netstat -ano | findstr :18789

解决方案：

杀掉占用进程
或修改端口：openclaw gateway --port 18889

问题5：安装脚本执行失败

现象：安装命令无响应或报错

排查步骤：

# 检查网络连接
curl -I https://openclaw.ai

# 手动下载脚本后执行
curl -O https://openclaw.ai/install.sh
bash install.sh

4. 浏览器配置

功能概览

OpenClaw浏览器是一个专为AI智能体设计的隔离浏览器配置，用于自动化任务和验证操作，它不是日常使用的浏览器。

特性	说明
独立配置文件	名为 `openclaw` 的独立浏览器配置文件（默认橙色主题）
确定性控制	智能地列出/打开/聚焦/关闭标签页
智能体操作	支持点击、输入、拖动、选择等交互操作
多媒体支持	快照、截图、PDF导出
多配置文件	支持 `openclaw`、`work`、`remote` 等多个配置文件

⚠️ 重要：此浏览器具有自动化操作能力，为保障安全性，建议只让OpenClaw智能体访问可控的网站，避免访问包含敏感信息或高权限操作的平台。

安装 Google Chrome（推荐）

前置检查

首先检查系统架构：

uname -m

输出 x86_64 表示可以使用 .deb 包安装。

安装步骤

下载Chrome安装包：

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

安装Chrome：

sudo dpkg -i google-chrome-stable_current_amd64.deb

修复依赖问题（如需要） ：

sudo apt --fix-broken install -y

验证安装：

google-chrome --version

预期输出类似：Google Chrome 131.0.6778.86 (Official Build) (64-bit)

配置OpenClaw使用Chrome

编辑配置文件 ~/.openclaw/openclaw.json，添加或修改 browser 部分：

"browser": {
  "enabled": true,  // 启用浏览器功能
  "executablePath": "/usr/bin/google-chrome-stable",  // Chrome可执行文件路径
  "headless": true,  // 无头模式（无界面运行）
  "noSandbox": true,  // 禁用沙箱（root环境下必需）
  "args": [
    "--disable-gpu",
    "--disable-dev-shm-usage",
    "--no-first-run",
    "--no-default-browser-check"
  ],
  "profiles": {
    "openclaw": {  // 配置文件名称
      "cdpPort": 9222,  // Chrome DevTools协议端口
      "color": "#FF6600"  // 配置文件标识颜色
    }
  }
}

配置参数说明

参数	类型	说明
`enabled`	boolean	是否启用浏览器功能
`executablePath`	string	浏览器可执行文件的完整路径
`headless`	boolean	是否无界面运行（生产环境建议 `true`）
`noSandbox`	boolean	是否禁用沙箱（root环境下必须为 `true`）
`args`	array	Chrome启动参数（优化性能和稳定性）
`cdpPort`	number	Chrome DevTools协议端口（每个配置文件需唯一）

重启网关使配置生效

openclaw gateway restart

快速开始

基础命令

命令	功能
`openclaw browser --browser-profile openclaw status`	查看浏览器状态
`openclaw browser --browser-profile openclaw start`	启动浏览器服务
`openclaw browser --browser-profile openclaw open https://example.com`	打开指定网址
`openclaw browser --browser-profile openclaw snapshot`	获取当前页面快照
`openclaw browser --browser-profile openclaw screenshot`	截取当前页面截图
`openclaw browser --browser-profile openclaw close-all`	关闭所有标签页

执行示例

# 1. 检查浏览器状态
openclaw browser --browser-profile openclaw status

# 预期输出：
# Browser: ready
# Profile: openclaw
# CDP: ws://127.0.0.1:9222

# 2. 启动浏览器服务
openclaw browser --browser-profile openclaw start

# 3. 打开网站
openclaw browser --browser-profile openclaw open https://www.baidu.com

# 4. 获取页面快照
openclaw browser --browser-profile openclaw snapshot

# 5. 截图保存为PNG
openclaw browser --browser-profile openclaw screenshot --output /tmp/page.png

常见问题排查

问题1：提示"Browser disabled"

症状：执行浏览器命令时提示 Browser disabled

原因：配置文件中未启用浏览器功能

解决方法：

检查配置文件：

cat ~/.openclaw/openclaw.json | grep -A 2 '"browser"'

设置 "enabled": true
重启网关：

openclaw gateway restart

问题2：Chrome无法启动

症状：浏览器启动失败，日志显示 chrome exited unexpectedly

常见原因及解决方法：

原因	检查命令	解决方法
Chrome未安装	`which google-chrome-stable`	安装Chrome
路径错误	-	修改 `executablePath` 为正确路径
缺少依赖	`ldd /usr/bin/google-chrome-stable`	安装缺失的依赖库
权限不足	-	添加 `noSandbox: true`

调试命令：

# 查看详细日志
openclaw gateway logs

# 手动测试Chrome启动
/usr/bin/google-chrome-stable --headless --no-sandbox --no-first-run --dump-dom https://www.example.com

问题3：浏览器性能问题

症状：浏览器响应缓慢或占用内存过高

优化方案：

限制并发标签页数（在配置文件中）：

"agents": {
  "defaults": {
    "maxConcurrent": 2  // 减少并发数
  }
}

添加Chrome性能参数：

"browser": {
  "args": [
    "--disable-gpu",
    "--single-process",  // 单进程模式（节省内存）
    "--disable-background-networking",
    "--disable-features=IsolateOrigins,site-per-process"
  ]
}

定期清理缓存：

# 停止网关
openclaw gateway stop

# 清理Chrome用户数据
rm -rf ~/.config/openclaw/chrome/*

# 重启网关
openclaw gateway start

问题4：端口冲突

症状：提示端口 9222 或 18789 已被占用

排查命令：

# 检查9222端口
lsof -i :9222

# 检查18789端口
lsof -i :18789

解决方法：

修改端口配置：

"browser": {
  "profiles": {
    "openclaw": {
      "cdpPort": 9223  // 改为其他端口
    }
  }
}

或停止占用进程：

# 查找进程
pgrep -f "chrome.*9222"

# 杀掉进程
kill -9 <PID>

📚 相关资源

发表于 2026-02-07 22:12 Hellc_07 阅读(853) 评论(0) 收藏举报

从零到一：绿联NAS部署OpenClaw完整指南

1. 准备工作

1.1 配置信息

1.2 下载虚拟机镜像并导入

2. 创建虚拟机

3. 安装OpenClaw

3.1 系统要求检查

3.2 安装OpenClaw

方式一：快速安装（推荐）

方式二：手动安装

方式三：Windows版本管理

3.3 初始化配置

步骤1：运行新手引导

步骤2：配置向导选项

步骤3：智谱AI配置

查看当前配置状态

编辑配置文件

智谱AI模型配置说明

获取智谱AI API密钥

智谱AI参数说明

步骤4：网络配置

网络配置参数说明

bind模式详解

认证模式说明

生成安全Token（可选）

配置示例（推荐配置）

重启网关使配置生效

网络访问测试

3.4 安装验证

1️⃣ 检查安装状态

2️⃣ 检查Gateway网关状态

3️⃣ 检查健康状态

4️⃣ 启动网关服务

5️⃣ 打开仪表板（可选）

3.5 安装成功确认

3.6 常见问题排查

问题1：命令找不到

问题2：Node版本过低

问题3：权限不足

问题4：Gateway无法启动

问题5：安装脚本执行失败

4. 浏览器配置

功能概览

安装 Google Chrome（推荐）

前置检查

安装步骤

配置OpenClaw使用Chrome

配置参数说明

重启网关使配置生效

快速开始

基础命令

执行示例

常见问题排查

问题1：提示"Browser disabled"

问题2：Chrome无法启动

问题3：浏览器性能问题

问题4：端口冲突

📚 相关资源

公告