大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



一、OpenClaw 项目简介

OpenClaw 是一款开源的 AI 智能体（数字员工）运行框架，主打低代码、高扩展性，支持对接主流大模型（OpenAI、Anthropic、国内通义千问 / 文心一言等）、本地 Ollama 模型，内置终端控制、浏览器自动化、文件操作、插件扩展等能力，可快速实现自动化办公、AI 任务执行、自定义工作流等场景。

官方仓库：

• 全球官方：https://github.com/openclaw/openclaw
• 国内镜像：https://gitee.com/openclaw/openclaw
• 中国社区文档：https://open-claw.org.cn/

2.1 核心系统要求

表格

2.2 核心依赖要求

• Node.js：必须 >= v22.0.0，官方推荐 v24 稳定版（版本过低会直接导致安装 / 编译失败）
• 包管理器：pnpm（官方强制推荐，npm 处理依赖树易出现卡死 / 兼容问题）
• 可选依赖：Git（源码编译必需）、Python 3.10+（部分工具 / 本地模型依赖）、Docker（容器化部署）

方案一：一键脚本部署（新手首选，5 分钟搞定）

该方案全程自动化，自动完成环境检测、依赖安装、程序配置，无需手动处理环境变量，新手零门槛，全平台通用。

3.1.1 国内用户加速版（优先推荐，解决网络超时问题）

Windows 平台（PowerShell）

1. 右键开始菜单，选择终端 (管理员) / Windows PowerShell (管理员)，必须以管理员身份运行
2. 首次运行需先设置执行策略（避免脚本被拦截），执行后输入y回车确认：

powershell

set-executionpolicy -executionpolicy remotesigned -scope currentuser 

1. 执行国内一键安装命令：

powershell

GPT plus 代充 只需 145iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex 

1. 等待 2-5 分钟，出现openclaw installed successfully即安装完成，自动进入初始化引导。

macOS / Linux / WSL2 平台

1. 打开终端（macOS 按Command+空格搜索 Terminal，WSL2 打开 Ubuntu 终端）
2. 执行国内一键安装命令（需要 sudo 权限，输入系统密码时不显示字符，正常输入回车即可）：

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash 

1. 等待安装完成，自动进入初始化配置向导。

3.1.2 官方原版脚本（海外用户适用）

Windows PowerShell（管理员）

powershell

GPT plus 代充 只需 145iwr -useb https://openclaw.ai/install.ps1 | iex 

macOS / Linux / WSL2

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

方案二：npm/pnpm 全局安装（进阶用户首选，可控性强）

该方案适合有 Node.js 基础的用户，手动管理环境，安装速度快，支持灵活切换版本。

3.2.1 第一步：安装前置环境

Windows 平台

1. 安装 Node.js 22+/24+：官网下载 https://nodejs.cn/ ，选择 LTS 版本，一键安装，全程默认下一步即可
2. 安装完成后，打开管理员 PowerShell，验证版本：

powershell

GPT plus 代充 只需 145node -v npm -v 

1. 安装 pnpm：

powershell

npm install -g pnpm

验证

pnpm -v

1. 国内用户配置镜像加速（必做，否则下载超时）：

powershell

GPT plus 代充 只需 145pnpm config set registry https://registry.npmmirror.com/ npm config set registry https://registry.npmmirror.com/ 

macOS 平台

推荐使用 nvm 管理 Node.js 版本，避免权限问题：

1. 安装 Homebrew（已安装可跳过）：

/bin/bash -c “$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)” 

1. 安装 nvm：

GPT plus 代充 只需 145brew install nvm

配置环境变量（zsh）

echo ‘export NVM_DIR=“$HOME/.nvm”’ >> ~/.zshrc echo ‘[ -s “/usr/local/opt/nvm/nvm.sh” ] && . “/usr/local/opt/nvm/nvm.sh”’ >> ~/.zshrc source ~/.zshrc

1. 安装 Node.js 24 LTS 并切换：

nvm install 24 nvm use 24

验证

node -v

1. 安装 pnpm 并配置镜像：

GPT plus 代充 只需 145npm install -g pnpm pnpm config set registry https://registry.npmmirror.com/ 

Linux（Ubuntu/Debian）平台

1. 更新系统并安装基础工具：

sudo apt update && sudo apt upgrade -y sudo apt install -y curl git wget build-essential 

1. 安装 Node.js 24 LTS：

GPT plus 代充 只需 145curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash - sudo apt install -y nodejs

验证

node -v && npm -v

1. 安装 pnpm 并配置镜像：

sudo npm install -g pnpm pnpm config set registry https://registry.npmmirror.com/ 

3.2.2 第二步：全局安装 OpenClaw

全平台通用命令，执行后自动安装最新稳定版：

GPT plus 代充 只需 145# pnpm安装（推荐） pnpm add -g openclaw@latest

或npm安装

npm install -g openclaw@latest

3.2.3 第三步：验证安装

# 查看版本，输出版本号即安装成功 openclaw –version 

方案三：源码编译部署（开发者 / 二次开发首选）

该方案适合想要修改源码、参与贡献、使用最新开发版功能的用户，完整覆盖从源码拉取到编译构建的全流程。

3.3.1 前置环境准备

必须提前安装好：Node.js >=22.0.0、pnpm、Git，安装步骤参考方案二的前置环境安装。

3.3.2 第一步：克隆源码仓库

GPT plus 代充 只需 145# 官方仓库（海外用户） git clone https://github.com/openclaw/openclaw.git

国内Gitee镜像（国内用户优先，速度更快）

git clone https://gitee.com/openclaw/openclaw.git

进入项目根目录（后续所有命令都必须在该目录下执行）

cd openclaw

可选：切换到指定稳定分支（避免开发版不稳定）

# 查看所有远程分支 git branch -r

切换到最新稳定分支（示例，以实际最新分支为准）

git checkout release/2026.3.x

3.3.3 第二步：安装项目全量依赖

GPT plus 代充 只需 145# 国内用户先执行镜像配置（必做） pnpm config set registry https://registry.npmmirror.com/

安装全量依赖

pnpm install

等待安装完成，无报错即可进入下一步，若出现网络超时，重新执行命令即可。

3.3.4 第三步：全量编译构建

# 一键完整构建（前端UI + 核心服务 + 官方插件） pnpm build 

也可以分步构建，方便排查问题：

GPT plus 代充 只需 145# 1. 构建前端Web UI界面 pnpm ui:build

2. 构建核心框架

pnpm build:core

3. 构建官方插件

pnpm build:plugins

3.3.5 第四步：全局链接，使系统可识别 openclaw 命令

# 全局链接 pnpm link –global

验证链接是否成功

openclaw –version

输出版本号即编译部署完成。

无论哪种安装方式，安装完成后都需要完成初始化配置，才能正常使用 OpenClaw 的全部功能。

4.1 启动初始化引导向导

执行以下命令，进入交互式配置引导：

GPT plus 代充 只需 145# 完整初始化引导，同时安装后台守护进程 openclaw onboard –install-daemon 

若安装完成后自动进入了引导，无需重复执行该命令。

4.2 核心配置步骤详解

1. 风险确认：提示 AI 操作的安全风险，输入Yes回车继续
2. 配置模式选择：新手直接选择QuickStart快速模式，进阶用户可选择Custom自定义模式
3. AI 模型提供商配置：
   • 在线模型：选择 OpenAI、通义千问、文心一言等，输入对应的 API Key 和 API 地址即可
   • 本地模型：选择Ollama，提前安装好 Ollama 并启动服务，配置对应的模型名称即可
4. 消息渠道配置：新手先选择QuickStart，后续可在 Web 面板中配置微信、飞书、钉钉等渠道
5. 权限与工具配置：选择工具权限集，新手选择full全量权限，否则会出现终端、浏览器等功能无法使用的问题
6. 守护进程安装：确认安装后台守护进程，实现开机自启、后台常驻运行

4.3 启动核心网关服务

# 前台启动网关（调试用，关闭终端服务停止） openclaw gateway start

后台守护进程启动（推荐，关闭终端不影响）

openclaw daemon start

4.4 访问 Web 管理面板

1. 网关启动成功后，默认访问地址：http://127.0.0.1:18789
2. 登录需要的 Token，可通过以下命令获取：

GPT plus 代充 只需 145openclaw config get gateway.auth.token 

1. 浏览器打开地址，输入 Token，即可进入 OpenClaw 的 Web 管理界面。

完成以上步骤后，执行以下操作，确认部署完全成功：

5.1 基础状态检查

# 检查全局配置健康状态 openclaw health

检查网关服务运行状态

openclaw gateway status

检查守护进程状态

openclaw daemon status

所有项均显示healthy/running，即服务正常运行。

5.2 功能测试

1. 在 Web 面板中，发送测试消息：你好，介绍一下自己，AI 正常回复即对话功能正常
2. 测试工具调用：发送帮我查看当前系统的CPU占用情况，能正常执行终端命令并返回结果，即工具权限配置正常
3. 测试插件功能：在插件市场安装一个简单插件，验证插件加载和运行正常。

6.1 常用配置修改

GPT plus 代充 只需 145# 修改网关默认端口（解决18789端口占用问题） openclaw config set gateway.port 8080

开启/关闭网关鉴权

openclaw config set gateway.auth.enabled false

配置模型默认参数

openclaw config set model.default.provider openai openclaw config set model.default.model gpt-4o

修改配置后，需要重启网关服务生效：openclaw gateway restart

6.2 后台常驻与开机自启

通过守护进程实现，执行以下命令即可：

# 安装守护进程并设置开机自启 openclaw daemon install

重启守护进程

openclaw daemon restart

查看守护进程日志

openclaw daemon logs

6.3 插件安装与管理

GPT plus 代充 只需 145# 查看官方插件市场 openclaw plugin list

安装官方插件

openclaw plugin install 插件名称

卸载插件

openclaw plugin uninstall 插件名称

查看已安装插件

openclaw plugin installed

6.4 本地 Ollama 模型对接

1. 提前安装 Ollama：https://ollama.com/，并启动服务
2. 拉取想要使用的模型，例如：ollama pull qwen2.5:7b
3. 在 OpenClaw 中配置 Ollama 提供商，地址默认http://127.0.0.1:11434，模型名称填写拉取的模型名即可
4. 配置完成后，即可在对话中使用本地大模型，无需联网。

7.1 安装阶段常见问题

问题 1：一键脚本执行报错，提示 Node.js not found

原因：脚本自动安装 Node 失败，或系统路径未配置。解决方案：

1. 手动去 Node.js 官网下载安装 v22 + 版本，安装完成后重启终端
2. 执行node -v确认版本正常，再重新执行安装脚本，或直接使用 npm 全局安装方式。

问题 2：安装完成后，执行 openclaw 提示 “命令不存在 / 不是内部或外部命令”

原因：Node.js 的全局包目录没有加入系统环境变量。解决方案：

• Windows：找到 Node 的全局安装目录（默认C:Users你的用户名AppDataRoaming pm），手动添加到系统环境变量Path中，重启终端即可
• macOS/Linux：执行以下命令，将全局目录加入环境变量，同时写入配置文件永久生效：

# zsh用户（macOS默认） echo ‘export PATH=$PATH:~/.npm-global/bin’ >> ~/.zshrc source ~/.zshrc

bash用户

echo ‘export PATH=$PATH:~/.npm-global/bin’ >> ~/.bashrc source ~/.bashrc

问题 3：pnpm install 下载依赖超时 / 失败

原因：网络问题，默认源访问速度慢。解决方案：必须配置国内镜像源，执行：

GPT plus 代充 只需 145pnpm config set registry https://registry.npmmirror.com/ 

配置完成后重新执行安装命令即可。

问题 4：源码编译报错，提示 node-gyp / 构建工具相关错误

原因：系统缺少 C++ 编译工具链。解决方案：

• Windows：安装 Visual Studio 2022 生成工具，勾选 “C++ 桌面开发”，或执行：

powershell

npm install -g windows-build-tools 

• macOS：执行xcode-select –install安装命令行工具
• Ubuntu/Debian：执行sudo apt install -y build-essential python3

7.2 运行阶段常见问题

问题 1：启动网关报错，提示listen EADDRINUSE :::18789

原因：默认端口 18789 被其他程序占用。解决方案：

1. 要么终止占用端口的进程，要么修改 OpenClaw 的网关端口
2. 修改端口命令：openclaw config set gateway.port 8080，重启网关即可

问题 2：Web 面板能登录，但只能聊天，终端 / 浏览器 / 文件操作等功能用不了

原因：工具权限配置被限制，默认是最小权限集。解决方案：

1. 执行openclaw config edit打开配置文件
2. 找到tools配置项，将profile的值从basic改成full
3. 保存文件，重启网关服务openclaw gateway restart，功能即可正常使用

注意：修改配置前必须先关闭 OpenClaw 服务，否则配置会被自动还原。

问题 3：配置了 API Key，但模型调用失败 / 超时

原因：API 地址配置错误、API Key 无效、网络无法访问模型服务商接口。解决方案：

1. 核对 API Key 和 API Endpoint 是否正确，国内模型需要配置对应的代理地址
2. 检查网络是否能访问模型接口，比如 OpenAI 需要代理，可配置全局代理，或使用国内可直连的模型服务商
3. 执行openclaw health检查模型配置的健康状态，根据报错信息调整。

问题 4：守护进程启动失败，服务无法后台运行

原因：权限不足，或初始化时未正确安装守护进程。解决方案：

1. Windows 必须以管理员身份运行终端，macOS/Linux 需要 sudo 权限
2. 重新执行openclaw daemon install安装守护进程，再执行openclaw daemon start启动
3. 查看日志openclaw daemon logs，根据具体报错排查问题。

7.3 平台特有问题

Windows 平台：原生 PowerShell 安装后，很多功能异常

原因：OpenClaw 官方对 Windows 原生环境支持有限，很多 Linux 工具和命令无法兼容。解决方案：官方强烈推荐使用 WSL2 + Ubuntu 环境部署，可获得和 Linux 一致的兼容性和稳定性。WSL2 安装步骤：

1. 管理员 PowerShell 执行：

powershell

GPT plus 代充 只需 145wsl –install 

1. 重启电脑，打开 Ubuntu 设置用户名和密码
2. 进入 Ubuntu 终端，按照 Linux 方案执行安装即可。

macOS Apple Silicon 芯片：安装后提示架构不兼容

原因：Node.js 安装了 x86 版本，通过 Rosetta 转译导致兼容问题。解决方案：

1. 使用 nvm 安装原生 arm64 版本的 Node.js
2. 执行node -p process.arch，确认输出arm64，而非x64
3. 重新安装 OpenClaw 即可。

本文完整覆盖了 OpenClaw 从新手一键安装到开发者源码编译的全流程，同时提供了完整的配置、验证和踩坑解决方案，按照步骤操作即可完成全平台部署。

后续拓展方向：

1. 自定义插件开发，扩展 OpenClaw 的能力
2. 对接企业微信、飞书、钉钉等渠道，实现 AI 助手在办公软件中使用
3. 结合自动化脚本，实现办公场景的全流程自动化
4. 容器化部署，使用 Docker 将 OpenClaw 部署到服务器，实现公网访问和多端使用

如果本文对你有帮助，欢迎点赞、收藏、评论，有问题可以在评论区留言，我会一一解答。