前缀、文档修改记录
20260315 初始化编辑此文章
20260316 更新内容
20260317 更新内容
20260324 更新内容
20260325 更新内容
20260329 更新内容， 从版本20260322升级为20260328
20260331 更新内容， 版本升级成功，对接微信成功
20260411 更新内容， 优化Windows安装的步骤
20260412 更新内容， 驱动谷歌浏览器
未完待续
章节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 1 0
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包管理器，运行如下命令
// 管理员，CMD中，执行策略限制的释放。
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
章节6、 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
章节7、 对接微信
在 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 响应。
章节8、 对接谷歌浏览器
我已经在电脑上运行了本地版 OpenClaw（CLI/Server 版），你可以通过 Chrome DevTools Protocol (CDP) 接口让它控制浏览器。
以远程调试模式启动 Chrome，在启动 Chrome 时需要添加一个特定的参数，允许 OpenClaw 连接
chrome.exe --remote-debugging-port=18800
配置 OpenClaw 技能，在 OpenClaw 中安装或启用 browser 或 playwright 相关的技能（Skills）。当你在聊天框中要求 OpenClaw “帮我看看这个网页”或“帮我买张票”时，它会自动寻找并连接到 18800 端口的浏览器实例。
= = 分割线 = = = = =
= = 分割线 = = = = =
= = 分割线 = = = = =
= = 分割线 = = = = = 教材已根据官网更新
# 升级版本
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
