openclaw本地一键部署教程

北门放羊

部署机器

openclaw支持部署到常见操作系统，包括windows、macos、linux等系统，支持实体机安装，虚拟机安装和docker安装等，出于节约成本和长期开机的考虑，我选择在nas中使用虚拟机安装linux系统来进行部署。操作系统选择的是ubuntu server 2404 LTS版本。

部署过程

1、先更新系统到最新版本

sudo apt update -y
sudo apt upgrade -y

2、使用一键脚本安装

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

3、如果遇到npm报错或者下载慢的情况可以尝试使用国内镜像（我路由器有梯子，没遇到该问题）

npm config set registry https://registry.npmmirror.com

4、然后就是漫长的等待，等待脚本自动安装完成就会进入配置界面（能跳过的尽量跳过，可以后面再配置）

5、配置完成后手动保存下环境变量

source ~/.bashrc

6、配置大模型

openclaw config

按方向键选择model，然后根据你的api提供商给的指导配置对应的模型即可

7、接入飞书，直接参考飞书官方指导即可

https://larkcommunity.feishu.cn/wiki/LDmXwEVhJitBa5kU0mjc16VKneb

8、配置浏览器（可选）

openclaw支持调用搜索服务api来进行联网搜索，也可以调用本地浏览器进行网页查询，通常很多搜索服务api提供的免费额度足够日常使用，但还是自己配置一个浏览器更方便一些。

具体操作步骤如下：

8.1.正确配置chrome源

# 1. 下载并安装 Chrome GPG 密钥（新规范）
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/google-chrome-keyring.gpg

# 2. 创建 Chrome 源列表文件
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome-keyring.gpg] https://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list

# 3. 刷新包索引
sudo apt update

8.2、安装chrome及中文显示依赖

# 安装 Chrome 稳定版
sudo apt install -y google-chrome-stable

# 安装中文显示依赖（避免网页乱码）
sudo apt install -y fonts-liberation xdg-utils fonts-noto-cjk

# 验证 Chrome 安装路径（关键，后续配置要用）
which google-chrome  # 正确输出：/usr/bin/google-chrome

8.3、OpenClaw 浏览器核心配置

# 1. 创建 OpenClaw 浏览器配置目录（避免目录缺失错误，其中xxx为你的用户目录）
mkdir -p /home/xxx/.config/openclaw/browser

# 2. 设置目录权限（解决 Permission denied 问题）
sudo chown -R xxx:root /home/xxx/.config/openclaw/browser
sudo chmod -R 755 /home/xxx/.config/openclaw/browser

# 3. 核心配置（root 用户必须开启 noSandbox）
openclaw config set browser.defaultProfile "openclaw"  # 设置默认配置文件
openclaw config set browser.headless true             # 无头模式（服务器无桌面必开）
openclaw config set browser.noSandbox true            # 关闭沙箱（root 运行 Chrome 必开）
openclaw config set browser.executablePath "/usr/bin/google-chrome"  # 指向正确的 Chrome 路径

8.4、启动并验证浏览器

# 1. 清理残留进程（避免端口占用/多实例错误）
pkill -f "chrome"
pkill -f "google-chrome"
sudo lsof -i :18800 | awk 'NR>1 {print $2}' | xargs -r sudo kill -9

# 2. 重启 OpenClaw 网关
openclaw gateway restart

# 3. 启动浏览器并检查状态
openclaw browser start
openclaw browser status  # 输出 "running: true" 即为成功

说明：1、最好有梯子，能省去很多事

2、尽量不要用root账户来部署，一个是安全风险，还有一个原因是使用root账号会在创建systemd服务时遇到一些问题

3、参考教程：

https://cloud.tencent.com/developer/article/2627246

https://cloud.tencent.com/developer/article/2635167

https://larkcommunity.feishu.cn/wiki/LDmXwEVhJitBa5kU0mjc16VKneb