openclaw安装-OpenClaw电脑端-本地部署-自动化工具完整指南

在线一对一安装，不成功不收费，👇

📋 目录

• 一、OpenClaw 简介
• 二、环境准备
• 三、安装步骤
  • 3.1 安装 Node.js 和 npm
  • 3.2 配置 Git（解决网络问题）
  • 3.3 安装 OpenClaw
  • 3.4 安装网关
  • 3.5 配置和启动
• 四、Windows 额外依赖
• 五、常见问题解决
• 六、总结

---

一、OpenClaw 简介

OpenClaw 是一款强大的 AI 自动化工具，可以帮助开发者快速构建智能自动化流程。它支持多种集成方式，包括飞书、浏览器自动化等，是提升工作效率的利器。

主要特性：

• 🤖 AI 驱动的自动化流程
• 🔌 丰富的集成能力（飞书、浏览器等）
• 🛠️ 易于配置和使用
• 💻 跨平台支持（Windows、Linux、macOS）

---

二、环境准备

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

必需环境

1. Node.js (版本 16 或更高)
2. npm (通常随 Node.js 一起安装)
3. Git (用于克隆依赖仓库)

检查环境

打开命令行（Windows 使用 PowerShell 或 CMD），运行以下命令检查环境：

node --version
npm --version
git --version

如果命令无法识别，请先安装对应的软件。

---

三、安装步骤

3.1 安装 Node.js 和 npm

如果还没有安装 Node.js，请访问 Node.js 官网 下载并安装最新 LTS 版本。

安装完成后，验证安装：

node --version
npm --version

3.2 配置 Git（解决网络问题）

由于 OpenClaw 的部分依赖来自 GitHub，如果遇到网络访问问题，需要配置 Git 使用镜像站。

配置 Git 使用 HTTPS 替代 SSH

git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"

配置 GitHub 镜像站（可选，如果直接访问 GitHub 不稳定）

git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"

取消 Git 代理（如果之前配置过）

git config --global --unset https.proxy

3.3 安装 OpenClaw

使用 npm 全局安装 OpenClaw：

npm install -g openclaw --omit=optional --ignore-scripts

参数说明：

• --omit=optional: 跳过可选依赖，加快安装速度
• --ignore-scripts: 忽略安装脚本，避免某些环境下的编译问题

安装时间： 根据网络情况，通常需要 5-15 分钟。

验证安装：

openclaw --version

如果显示版本号，说明安装成功！

3.4 安装网关

OpenClaw 需要网关服务来运行，执行以下命令安装：

openclaw gateway install

3.5 配置和启动

步骤 1：获取 Dashboard 访问链接

openclaw dashboard --no-open

这个命令会输出一个包含 token 的访问链接，类似：

Dashboard URL: http://127.0.0.1:18789/#token=xxxxxxxxxxxxx

注意： 请保存这个 token，后续配置需要使用。

步骤 2：设置网关令牌

openclaw config set gateway.auth.token "你的token"

将 你的token 替换为步骤 1 中获取的 token。

步骤 3：快速配置

openclaw onboard --flow quickstart

这个命令会引导你完成基本配置。

步骤 4：启动网关

openclaw gateway start

启动成功后，你会看到类似以下的输出：

[canvas] host mounted at http://127.0.0.1:18789/__openclaw__/canvas/
[heartbeat] started
[health-monitor] started
[gateway] listening on ws://127.0.0.1:18789
[browser/server] Browser control listening on http://127.0.0.1:18791/

步骤 5：访问控制面板

运行以下命令自动打开控制面板：

openclaw dashboard

或者手动访问步骤 1 中获取的 Dashboard URL。

---

四、Windows 额外依赖

如果你在 Windows 系统上安装，可能需要安装以下额外依赖：

1. Visual C++ 构建工具

某些 Node.js 原生模块需要编译，需要安装 Visual C++ 构建工具。

下载地址： Visual Studio Build Tools

2. WebView2 运行时

OpenClaw 的浏览器控制功能需要 WebView2 运行时。

下载地址： Microsoft Edge WebView2

---

五、常见问题解决

问题 1：npm 安装时网络超时

错误信息：

npm error network request to https://codeload.github.com/... failed

解决方案：

1. 增加重试次数和超时时间：

npm config set fetch-retries 5
npm config set fetch-retry-mintimeout 20000
npm config set fetch-retry-maxtimeout 120000
npm config set fetch-timeout 300000

2. 配置 npm 使用国内镜像：

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

3. 清理缓存后重试：

npm cache clean --force
npm install -g openclaw --omit=optional --ignore-scripts

问题 2：Git 克隆失败

错误信息：

fatal: unable to access 'https://github.com/...': Connection reset

解决方案：

使用镜像站配置（已在 3.2 节说明）：

git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"

问题 3：Dashboard 访问显示 “Not Found”

可能原因：

• 网关服务未启动
• 端口被占用
• 防火墙阻止

解决方案：

1. 检查网关状态：

openclaw gateway status

2. 重启网关：

openclaw gateway restart

3. 检查端口是否监听：

# Windows
netstat -an | findstr 18789

应该看到类似输出：

TCP    127.0.0.1:18789        0.0.0.0:0              LISTENING

问题 4：punycode 模块弃用警告

警告信息：

(node:xxxxx) [DEP0040] DeprecationWarning: The `punycode` module is deprecated

说明： 这是 Node.js 的内部警告，不影响功能，可以忽略。等待依赖库更新即可。

问题 5：WebSocket 连接超时

日志信息：

[ws] handshake timeout
[ws] closed before connect

说明： 这通常是客户端连接问题，不影响网关正常运行。可能是：

• 浏览器刷新导致连接中断
• 网络波动
• 客户端主动取消连接

如果网关服务正常运行，这些警告可以忽略。

---

六、总结

在线一对一安装，不成功不收费，👇