前缀、文档修改记录
20260315 初始化编辑此文章
20260316 更新内容
20260317 更新内容
20260324 更新内容
20260325 更新内容
20260329 更新内容， 从版本20260322升级为20260328
20260331 更新内容， 版本升级成功，对接微信成功
20260411 更新内容， 优化Windows安装的步骤
20260412 更新内容， 驱动谷歌浏览器
20260418 更新内容， 驱动本地已有的谷歌浏览器,未成功
20260422 更新内容， 版本升级到20260421
未完待续
章节1、需求描述
就是记录一下openclaw的部署，插件安装，功能使用。因为绝大部分人，都是习惯用Windows环境，本篇文章会以Windows 10系统为基础环境进行部署的讲解。也会讲解一下基于Ubuntu 24.04系统的部署。
官网： https://openclaw.ai
源码地址： https://github.com/openclaw/openclaw
章节2、openclaw的部署过程
2.1、系统环境Ubuntu 24.04
2.1.1、 资源规格
因为是个人需求，我这里，使用的2C 4G 60G SSD的规格的虚拟机，带宽有3Mbps应该足够了，保持24小时开机运行，操作系统选择Ubuntu 24.04 或者 Debian 13 。
本篇教程使用Ubuntu最新版本的 ubuntu-24.04.4-live-server-amd64.iso 系统。
2.1.2、 官方安装推荐
根据官方最新的安装推荐指南，目前，openclaw支持一键安装，自备水管通github/nodejs的资源才能正常运行哦。
zhangsan@server$ curl -fsSL https://openclaw.ai/install.sh | bash
2.2、 系统环境Windows 10
2.2.1、 资源规格
因为Windows系统占用的资源比Linux多，这里，虚拟机的规格为8C-4G-120G。
环境主要是 cmake, chrome浏览器, git工具, nodejs环境, visual studio。
2.2.2、 安装步骤
安装nodejs的安装包， node-v24.14.0-x64.exe这个安装包， 在Win环境上的安装简单，安装完成后，CMD/Powershell里面运行如下命令，确认安装成功。
// 检查nodejs版本 v24.14.0
node -v
安装pnpm包管理器，运行如下命令
// 管理员，PowerShell中，执行策略限制的释放。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
选择 A
回车
// 管理员Git Bash，安装pnpm
npm install -g pnpm
// 检查版本 v10.33.0
pnpm -v
解压缩openclaw 的源代码的压缩包，我一般就直接放在我这个用户的目录下，这样Git Bash页面中，初始位置就直接可以快速访问到。
C:\Users\admxn\openclaw-2026.3.23
后续的命令，基本都是在Git Bash管理员权限下运行
// 管理员权限
cd 你的路径/openclaw-2026.4.10
// 首先是设置国内的npm源
// 设置国内镜像源 腾讯
pnpm config set registry https://mirrors.cloud.tencent.com/npm/
// 或者
// 设置国内镜像源 淘宝
pnpm config set registry https://registry.npmmirror.com
// 安装依赖，本次更新发现有1234个包，需要比较久的下载和添加时间。 约30分钟
pnpm install
// 构建 UI 与核心，需要进git bash 且为管理员，执行如下的命令
cd C:
cd Users/admxn/openclaw-2026.4.10
pnpm ui:build
pnpm build
pnpm setup // 全局目录配置
// 关闭原来的Git Bash窗口，重新开启1个Git Bash窗口
cd Users/admxn/openclaw-2026.4.10
pnpm link --global
// 启动初始化openclaw
openclaw onboard --install-daemon
章节4、 对接火山引擎的coding plan
我这里的测试环境，对接的是火山引擎的coding plan，40元/月的那个版本
火山引擎的coding plan的购买地址： https://ark.cn-beijing.volces.com/api/coding
火山引擎的模型，各个版本的作用： https://console.volcengine.com/ark/region:ark+cn-beijing/model?groupType=ModelGroups&vendor=Bytedance&view=DEFAULT_VIEW
官方的对接方案：https://www.volcengine.com/docs/82379/2183190?lang=zh
这种对接，都是比较简单的，保存备份一下配置文件，然后编辑配置文件，增加对应的模型的信息，然后openclaw gateway restart 一下，就可以了。
章节5、 对接腾讯的coding plan
腾讯coding plan的购买地址： https://cloud.tencent.com/act/pro/codingplan
章节6、 对接阿里云的coding plan
阿里云coding plan的购买地址： https://www.aliyun.com/benefit/scene/codingplan
官方的对接方案： https://help.aliyun.com/zh/model-studio/openclaw-coding-plan?spm=a2c4g.11186623.0.0.12984c4dTEXDPy
章节7、 openclaw版本升级
我前面都是用pnpm编译安装的，而不是使用内置的更新命令，这种方式的版本更新，对于整个openclaw版本升级工作来说，这个是最稳定的。
本次版本升级是2026-3-23版本升级到2026-3-28，版本升级成功。
// 构建 UI 与核心，需要进git bash 且为管理员，执行如下的命令
cd C:
cd Users/admxn/openclaw-新版本
pnpm ui:build
pnpm build
pnpm setup
// 管理员身份，新开git bash
pnpm link --global
// 完成 pnpm 编译升级后，一定要运行openclaw
openclaw doctor
章节8、 对接微信
在 20260328 版本中，OpenClaw 已经极大地简化了微信（个人微信和企业微信）的接入流程。你可以通过全新的插件系统 ClawHub 快速完成对接。
手机微信，升级到最新版本，设置，我，插件，选择”微信Clawbot”
官方地址：
https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin-cli
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
启动扫码登录，执行以下命令，终端会弹出一个二维码（或显示二维码链接）
openclaw login wechat
完成绑定，使用你的手机微信扫码并确认登录。此时，OpenClaw 会作为一个后台进程接管你的消息。你可以通过 openclaw config 设置哪些好友或群聊可以触发 AI 响应。
章节9、 对接谷歌浏览器
项目地址： https://github.com/ChromeDevTools/chrome-devtools-mcp
谷歌浏览器，安装最新的版本，然后进 chrome://inspect/#remote-debugging ，开启调试功能。
我已经在电脑上运行了本地版 OpenClaw（CLI/Server 版），可以通过 Chrome DevTools Protocol (CDP) 接口让它控制浏览器。
右击，桌面的谷歌浏览器图标，属性，目标，这个参数位置，修改为
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\Users\admxn\.chrome" --no-performance-crux --no-usage-statistics
–remote-debugging-port=9222：这是最重要的参数，开启 9222 端口供 OpenClaw 连接。
–user-data-dir：建议指定一个独立的文件夹存放配置，防止和日常使用的插件冲突，如果没有这个文件夹，手动创建一个即可。
–no-performance-crux： 性能工具可能会向 Google CrUX API 发送追踪 URL，以获取真实用户的体验数据。通过将实地数据与实验室数据并列展示，此举有助于提供全面的性能概览。这些数据由 Chrome 用户体验报告 (CrUX) 负责收集。增加此参数，可禁用此功能。
–no-usage-statistics： Google 会收集使用统计数据（例如工具调用成功率、延迟及环境信息），以提升 Chrome DevTools MCP 的可靠性和性能。数据收集功能默认处于启用状态。增加此参数，可禁用此功能。
运行谷歌浏览器后，地址栏打开如下地址，确保MCP已正常启动
http://localhost:9222/json
启动远程调试服务器
chrome://inspect/#remote-debugging
重启一下谷歌浏览器。
设置为驱动本地已安装的谷歌浏览器，目标是让它可以驱动已经打开的标签网页。
安装 Chrome DevTools MCP Server
npm install -g chrome-devtools-mcp
启动MCP Server
npx chrome-devtools-mcp@latest --autoConnect
chrome-devtools-mcp --port 3000 --chrome-url http://localhost:9222
openclaw config set browser.executablePath "C:\Program Files\Google\Chrome\Application\chrome.exe"
让 OpenClaw 能够“接管”正在运行的浏览器，需要开启浏览器功能
openclaw config set browser.enabled true
设置为 false 才能看到浏览器界面
openclaw config set browser.headless false
以远程调试模式启动 Chrome，在启动 Chrome 时需要添加一个特定的参数，允许 OpenClaw 连接
chrome.exe --remote-debugging-port=9222
配置 OpenClaw 技能，在 OpenClaw 中安装或启用 browser 或 playwright 相关的技能（Skills）。当你在聊天框中要求 OpenClaw “帮我看看这个网页”或“帮我买张票”时，它会自动寻找并连接到 18800 端口的浏览器实例。
测试命令：
openclaw browser --browser-profile user tabs
= = 分割线 = = = = =
= = 分割线 = = = = =
= = 分割线 = = = = =
= = 分割线 = = = = = 教材已根据官网更新
# 升级版本
openclaw update
# 检查系统状态，确保配置已正确迁移
openclaw doctor
# 重启网关服务以应用新版本
openclaw gateway restart
备份数据： 升级前请务必备份 ~/.openclaw 目录。
2.2、资源部署（Docker方式，推荐）
Docker方式的部署，对于新手村的人，可能更友好一点，故而优先介绍这个方式的部署。
用Docker方式部署，自然先部署docker容器环境。
部署docker环境，建议根据你实际的操作系统版本，根据官方教材安装，参考 https://docs.docker.com/engine/install/ubuntu/ ，可选官方的一键脚本，或者手工分步执行
一键脚本：
root@server# curl -fsSL https://get.docker.com | sh
分步执行
// 注释 Add Docker's official GPG key:
root@server# apt update
root@server# apt install ca-certificates curl
root@server# install -m 0755 -d /etc/apt/keyrings
root@server# curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
root@server# chmod a+r /etc/apt/keyrings/docker.asc
// 注释 Add the repository to Apt sources:
root@server# tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF
// 注释 再次更新
root@server# apt update
// 注释 安装最新版本docker-ce
root@server# apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
本次测试环境安装到的版本 docker-ce (5:29.3.0-1~ubuntu.24.04~noble) 时间戳202603162208
测试是否安装成功：
root@server# docker version
root@server# docker run hello-world
将常用的用户加到用户组里，通过将用户 zhangsan 加入 docker 组，该用户就获得了与 Docker 守护进程通信的同等权限，后续方便用zhangsan用户执行相关docker命令。
root@server# usermod -aG docker zhangsan
参数 -a ：Append（追加）。极其重要！它确保将用户添加到新组时，不会从现有的其他组中移除。
参数 -G ：Groups。后面跟着的是目标用户组的名字。
Docker服务的相关启动/重启/开机自动启动
root@server# systemctl daemon-reload
root@server# systemctl restart docker
root@server# systemctl enable docker
2.3、 Openclaw部署
创建并进入 Openclaw 工作目录，获取项目文件。为了安全性，建议用普通用户执行。
zhangsan@server$ mkdir openclaw && cd openclaw
zhangsan@server$ git clone https://github.com/openclaw/openclaw.git .
获取对应的容器镜像
root@server# docker pull alpine/openclaw:latest
环境变量的配置
cp .env.example .env
必须配置的关键项：
API_KEY: 您的 LLM 提供商密钥（如 元宝，豆包，Claude，OpenAI）。
BASE_URL: 如果使用代理（如 OpenRouter 或国内中转），请在此填写。
ADMIN_PASSWORD: 进入 Web 管理面板的初始密码。
启动openclaw，使用 Docker Compose 启动，创建或检查目录下的 docker-compose.yml 文件。一个典型的配置如下
services:
openclaw:
image: openclaw/openclaw:latest
container_name: openclaw
ports:
- "3000:3000"
volumes:
- ./data:/app/data
- .env:/app/.env
restart: always
执行启动
docker compose up -d
如果需要检查执行日志
docker logs -f openclaw
访问面板： 在浏览器中输入 http://服务器IP:3000
安全提示： 如果无法访问，请检查云服务器的 安全组/防火墙 是否已放行 3000 端口。
权限问题： 如果挂载的 ./data 文件夹无法写入，请执行 chmod -R 777 ./data。
数据库重置： 如果遇到数据库版本冲突，通常可以通过删除 ./data/db.sqlite 并重启容器解决。
浏览器组件： 如果您使用了需要自动化 UI 的插件，确保镜像版本包含 playwright 驱动，否则会出现“Browser not found”错误。
2.3、资源部署（物理系统方式）
附录1、视频操作演示
附录2、@Dasmz
博客内，所有教程为手打原创教程，如果技术教程对您有所帮助，欢迎打赏作者。技术层面，闻道有先后，如有疏漏、错误，欢迎指正。技术博客的内容，一般具有一定的环境依赖，具有一定的年代依赖，酌情参考其中的内容，请勿完全照搬照抄。
对于博客内已提及的专业知识，如果需要技术指导，欢迎联系我，仅需支付工时费
Twitter: Dasmz
Youtube: @DasmzStudio
Telegram: @Dasmz
云乞讨
附录3、其他信息
如果要限定安装某个特定版本的docker-ce，则如下执行：
// 注释 安装某个特定版本docker-ce
root@server# apt list --all-versions docker-ce
docker-ce/noble 5:29.2.1-1~ubuntu.24.04~noble <arch>
docker-ce/noble 5:29.2.0-1~ubuntu.24.04~noble <arch>
root@server# VERSION_STRING=5:29.2.1-1~ubuntu.24.04~noble
root@server# apt install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
