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



OpenClaw（曾用名 Clawdbot、Moltbot）是一款完全开源、本地优先、模型无关的 AI 智能体执行框架，核心是用自然语言指挥设备，让 AI 替你完成真实操作。

核心优势

• 本地可控：数据不上传云端，隐私安全
• 跨平台：支持 Windows、macOS、Linux（含 WSL2）
• 全能力：文件操作、浏览器自动化、OCR、Shell 执行、多模型兼容
• 易扩展：插件化架构，支持自定义技能与工具
• 免费开源：MIT 协议，社区活跃，GitHub Star 超 20 万

系统要求

• 操作系统：Windows 10/11、macOS 12+、Ubuntu 20.04+/Debian 10+
• 内存：≥4GB（推荐 8GB+）
• 磁盘：≥5GB 可用空间
• 核心依赖：Node.js ≥ v22 LTS（必须）

OpenClaw 提供 3 种主流部署方式，按需选择：

表格

---

1. Windows（PowerShell，管理员）

powershell

# 允许执行脚本（临时） Set-ExecutionPolicy RemoteSigned -Scope Process -Force

一键安装

iwr -useb https://openclaw.ai/install.ps1 | iex

2. macOS/Linux/WSL2

bash

运行

# 一键安装（自动检测并安装Node.js） curl -fsSL https://openclaw.ai/install.sh | bash 

3. 初始化配置（必做）

安装完成后，自动进入配置向导，或手动执行：

bash

运行

# 启动配置向导（含后台服务安装） openclaw onboard –install-daemon 

按提示完成：

• 选择 AI 模型（OpenAI/Claude/Ollama 本地模型）
• 配置 API 密钥
• 选择交互渠道（Web Dashboard/Telegram/Discord 等）

---

1. 安装 Node.js（v22+）

• Windows/macOS：官网下载 LTS 版安装（自动配置 PATH）
• Linux（Ubuntu）：

bash

运行

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs 

2. 验证环境

bash

运行

node -v # 应≥v22 npm -v 

3. 全局安装 OpenClaw

bash

运行

# 安装主程序 npm install -g openclaw@latest

安装技能管理工具（可选）

npm install -g clawhub

4. 验证安装

bash

运行

openclaw –version openclaw help 

出现版本号即成功。

5. 初始化工作目录

bash

运行

mkdir -p ~/openclaw-workspace && cd ~/openclaw-workspace openclaw init # 生成配置文件 

---

1. 拉取官方镜像

bash

运行

docker pull openclaw/openclaw:latest 

2. 安全启动容器（推荐）

bash

运行

docker run -d –name openclaw –restart always -p 127.0.0.1:3000:3000 # Web面板 -p 127.0.0.1:18789:18789 # 网关端口 -v ~/.openclaw:/root/.openclaw # 数据持久化 –cap-drop=ALL # 最小权限 –security-opt no-new-privileges:true openclaw/openclaw:latest 

3. 容器内初始化

bash

运行

docker exec -it openclaw openclaw onboard 

---

1. 启动服务

bash

运行

# 启动网关（后台运行） openclaw gateway start

启动Web面板

openclaw dashboard

2. 访问 Web UI

浏览器打开：http://127.0.0.1:18789/（默认端口 18789，可在配置中修改）

---

1. 端口占用（EADDRINUSE）

bash

运行

# Linux/macOS lsof -i :18789 kill -9 
       
    
         

Windows

netstat -ano | findstr :18789 taskkill /F /PID

永久换端口（推荐）

编辑 ~/.openclaw/openclaw.json

“gateway”: { “port”: 18790 }

2. npm 权限错误（EACCES）

bash

运行

# Linux/macOS sudo chown -R \(USER ~/.npm sudo chown -R \)USER /usr/local/lib/node_modules

Windows（管理员PowerShell）

npm config set prefix “C: pm-global”

将C:

pm-global加入系统PATH

3. 国内网络安装失败

bash

运行

# 切换npm淘宝源 npm config set registry https://registry.npmmirror.com/

重新安装

npm install -g openclaw@latest

4. 无法访问 Web 面板

• 检查防火墙是否放行 18789 端口
• 确认服务已启动：openclaw gateway status
• 服务器部署需在云平台安全组开放端口

---

1. 接入本地模型（Ollama）

bash

运行

# 安装Ollama curl -fsSL https://ollama.com/install.sh | sh

下载模型

ollama pull llama3

OpenClaw配置

openclaw configure –section models.ollama

设置为默认模型

openclaw configure –set defaultModel=ollama/llama3

2. 后台自启（Linux）

bash

运行

# 安装systemd服务 openclaw service install

启动并开机自启

systemctl –user enable –now openclaw

---

本文覆盖了 OpenClaw 的3 种部署方式、全平台操作、常见问题排查，新手可直接用一键脚本快速体验，开发者可通过 npm 或 Docker 灵活定制。