openclaw安装指南

OpenClaw 是开源自托管的 AI 智能体网关（龙虾 Agent），核心是把大模型接入多聊天平台、可本地私有化部署、具备持久记忆与主动执行能力。下面从系统要求、四种部署方式、初始化配置、模型 / 通道接入、常见问题给出完整指南。

一、系统要求（必看）

操作系统
：Windows 10+/11、macOS 12+、Linux（Ubuntu 20.04+/Debian 11+）
Node.js
：≥22.x LTS（推荐 22.12+）
内存
：最低 2GB，推荐 4GB+（跑本地模型需 8GB+）
磁盘
：安装约 500MB，数据目录预留 10GB+
网络
：联网调用 API；离线可用 Ollama 本地模型
可选
：Python 3.10+（部分技能）、Git（源码编译）

二、部署方式（四选一，推荐顺序：一键脚本→Docker→npm→WSL）

方式 1：一键脚本（macOS/Linux，官方推荐）

# 国外原版curl-fsSL https://openclaw.ai/install.sh |bash# 国内镜像（网络差时）curl-fsSL https://open-claw.org.cn/install-cn.sh |bash

自动装 Node.js 与依赖，完成后自动进入配置向导

方式 2：Windows 一键安装（PowerShell，管理员）

powershell

# 国外原版curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd# 国内镜像（推荐）iwr-useb https://open-claw.org.cn/install-cn.ps1 |iex

或下载便携包：解压→双击Openclaw Windows 一键启动.exe

方式 3：npm 手动安装（已有 Node.js）

# 国外源npminstall-g openclaw@latest# 国内镜像（推荐）npm config set registry https://registry.npmmirror.comnpminstall-g openclaw@latest# 或pnpmnpm install -g pnpmpnpm add -g openclaw@latest

方式 4：Docker 部署（服务器 / 隔离环境）

bash

# 拉取镜像docker pull openclaw/openclaw:latest# 创建数据目录（持久化配置/日志/记忆）mkdir-p ~/.openclaw/{config,skills,logs,memory,workspace}# 启动容器（后台运行，开机自启）docker run -d\--name openclaw \--restart always \-p18789:18789 \-v ~/.openclaw/config:/app/config \-v ~/.openclaw/skills:/app/skills \-v ~/.openclaw/logs:/app/logs \-v ~/.openclaw/memory:/app/memory \-v ~/.openclaw/workspace:/app/workspace \-e TZ=Asia/Shanghai \  openclaw/openclaw:latest

三、初始化配置（安装后必做）

1. 启动配置向导

# 一键安装/ npm 安装后openclaw onboard --install-daemon# Docker 进入容器执行dockerexec-it openclaw openclaw onboard

向导自动生成~/.openclaw/config/config.json，配置网关端口、认证、模型密钥

2. 目录结构（关键）

plaintext

~/.openclaw/├── config/       # 配置文件（核心）├── skills/       # 自定义技能（插件）├── logs/         # 运行日志├── memory/       # 持久化记忆（对话历史）└── workspace/    # 临时文件/执行环境

四、接入大模型（二选一：API / 本地）

方案 A：API 调用（推荐，快速）

支持 GPT-3.5/4、Claude、通义千问、智谱、MiniMax 等，在配置向导输入密钥，或手动编辑config.json：

json{"models":{"default":"gpt-3.5-turbo","providers":{"openai":{"apiKey":"sk-xxx","baseUrl":"https://api.openai.com/v1"},"tongyi":{"apiKey":"xxx"}}}}

方案 B：本地模型（Ollama，离线）

1.安装 Ollama：https://ollama.com/
2.拉取模型（如 Llama 3、Qwen）：

ollama run qwen:7b

3.OpenClaw 配置 Ollama（config.json）：

json{"models":{"default":"ollama/qwen:7b","providers":{"ollama":{"baseUrl":"http://host.docker.internal:11434"}}}}

五、接入聊天通道（以 WhatsApp/Telegram 为例）

1. WhatsApp（最常用）

openclaw channels login

终端输出二维码→手机 WhatsApp→设置→已连接设备→扫码→连接成功

凭证存于~/.openclaw/credentials/whatsapp/

2. Telegram

1.找@BotFather创建 Bot，获取API_TOKEN
2.配置：

openclaw channels configure telegram --token YOUR_API_TOKEN

3.私聊 Bot 发送/start，批准配对码即可

支持通道

Discord、Slack、飞书、企业微信、微信（需插件）、Signal、iMessage 等 50+

六、启动 / 停止 / 查看状态

# 启动服务（守护进程，后台运行）

openclaw start# 停止服务openclaw stop# 查看状态openclaw status# 查看日志openclaw logs -f

七、常见问题与避坑

Node.js 版本过低
：用nvm管理版本，安装 22.x LTS
Windows 权限不足
：PowerShell 以管理员身份运行，关闭 360 / 火绒拦截
Docker 端口占用
：改-p 18789:18789为-p 8080:18789
模型调用失败
：检查密钥 / 网络，国内用户优先用通义 / 智谱 / MiniMax
WhatsApp 扫码失败
：用专用手机号，避免 VoIP 号码（易封禁）

八、升级与卸载

升级

# npmnpm update -g openclaw# Dockerdocker pull openclaw/openclaw:latestdocker restart openclaw

卸载

# npmnpm uninstall -g openclawrm-rf ~/.openclaw

# Dockerdocker stop openclawdocker rm openclawrm-rf ~/.openclaw