超详细！OpenClaw 本地部署保姆级实战教学#

1. 简介#

什么是 OpenClaw？#

OpenClaw/Moltbot/Clawdbot 是一个 AI 助手框架，支持：

🤖 多模型支持（MiniMax、Claude、GLM、GPT等）
💬 多平台集成（WhatsApp、Telegram、Discord等）
🛠️ 强大的工具生态（浏览器、文件系统、代码生成等）
🔧 可扩展的技能系统

版本说明#

OpenClaw: 官方名称，最新版本使用的命令
Moltbot/Clawdbot: 旧版本命令，部分用户可能仍在使用

本教程以 openclaw 为准，clawdbot 用户可将命令替换使用。

2. 系统要求#

基础要求#

项目	要求
操作系统	macOS 10.15+ / Windows 10+ / Linux (Ubuntu 20.04+)
Node.js	>= 22.x (必需)
内存	最低 2GB，推荐 4GB+
磁盘空间	最低 1GB，推荐 5GB+
网络	需要访问互联网（API 调用），必须使用代理，否则无法启动 gateway

Windows 额外要求#

推荐: WSL2 (Windows Subsystem for Linux 2) 原因: 原生 Windows 支持不完善，工具兼容性较差

macOS 额外要求#

Xcode Command Line Tools: 可选（仅构建应用时需要）

3. Windows 系统安装#

方法一：安装 WSL2（推荐）#

3.1 安装 WSL2#

以管理员身份打开 PowerShell：

1
# 启用 WSL 功能
2
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
3
# 启用虚拟机平台
4
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

步骤 2：重启电脑

步骤 3：安装 WSL2 内核更新下载并安装：wslstorestorage.blob.core.wslblob/wsl_update_x64.msi

步骤 4：设置 WSL2 为默认

1
wsl --set-default-version 2

步骤 5：安装 Ubuntu 打开 Microsoft Store，搜索 “Ubuntu 22.04 LTS”，安装并启动，设置用户名和密码。

3.2 在 WSL2 中安装 Node.js#

1
# 更新包列表
2
sudo apt update && sudo apt upgrade -y
3
# 安装 curl
4
sudo apt install -y curl
5
# 安装 Node.js 22.x
6
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
7
sudo apt-get install -y nodejs
8
# 验证安装
9
node --version
10
npm --version

3.3 安装 OpenClaw#

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

3
# 验证安装
4
openclaw --version
5

6
# 如果命令找不到，添加到 PATH
7
echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.bashrc
8
source ~/.bashrc

3.4 安装 Docker（可选，用于沙箱）#

1
# 在 WSL2 中安装 Docker
2
curl -fsSL https://get.docker.com | sudo sh
3

4
# 添加当前用户到 docker 组
5
sudo usermod -aG docker $USER
6

7
# 启动 Docker 服务
8
sudo service docker start
9

10
# 验证
11
docker --version

3.5 遇到问题？#

方案 A：使用 Docker Desktop
方案 B：使用虚拟机安装 Ubuntu 22.04

方法二：Windows PowerShell 一键部署#

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

4. Mac 系统安装#

4.1 安装 Homebrew（如果未安装）#

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2
brew --version

4.2 安装 Node.js 22.x#

方案 A：使用 Homebrew#

1
brew install node@22
2
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
3
source ~/.zshrc
4
node --version

方案 B：使用 nvm（推荐）#

1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
2
source ~/.zshrc
3
nvm install 22
4
nvm use 22
5
node --version

4.3 安装 OpenClaw#

1
curl -fsSL https://openclaw.ai/install.sh | bash
2
openclaw --version
3

4
# 找不到命令时添加 PATH
5
echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc
6
source ~/.zshrc

或使用 npm：

1
npm install -g openclaw@latest
2
openclaw --version

或使用 pnpm：

1
npm install -g pnpm
2
pnpm add -g openclaw@latest
3
openclaw --version

4.4 安装 Docker（可选）#

下载地址：https://www.docker.com/products/docker-desktop/

4.5 Xcode Command Line Tools（可选）#

1
xcode-select --install
2
xcode-select -p

5. 首次配置向导#

5.1 启动向导#

1
openclaw onboard

5.2 配置步骤#

选择 Gateway mode：Local
认证选择：Anthropic (API key)
默认模型：claude-sonnet-4-0
工作区：~/clawd
端口：18789，绑定：loopback
认证：Token
Tailscale：No
按需配置频道
安装后台服务
运行时：Node
健康检查 & 安装推荐技能

5.3 完成配置#

看到 🎉 OpenClaw 已准备就绪！ 即完成。

5.4 快速测试#

1
openclaw status
2
openclaw message send --target +15555550123 --message "Hello from Moltbot!"
3
openclaw logs --follow

6. 常用指令大全#

6.1 基础命令#

1
openclaw --version
2
openclaw --help
3
openclaw status
4
openclaw status --all
5
openclaw status --deep

6.2 Gateway 管理#

1
openclaw gateway start
2
openclaw gateway stop
3
openclaw gateway restart
4
openclaw gateway status
5
openclaw gateway config

6.3 配置管理#

1
openclaw configure
2
openclaw config get
3
openclaw config set gateway.port 18789
4
openclaw config unset gateway.port

6.4 模型管理#

1
openclaw models list
2
openclaw models set anthropic/claude-sonnet-4-0
3
openclaw models probe <model-name>

6.5 频道管理#

1
openclaw channels login
2
openclaw channels logout
3
openclaw channels status

6.6 配对管理#

1
openclaw pairing list whatsapp
2
openclaw pairing approve whatsapp <code>

6.7 消息发送#

1
openclaw message send --target +15555550123 --message "Hello!"

6.8 代理 & 会话 & 技能#

1
openclaw agents list
2
openclaw sessions list
3
openclaw skills list

6.9 日志与诊断#

1
openclaw logs --follow
2
openclaw health
3
openclaw doctor
4
openclaw doctor --fix

6.10 更新升级#

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

7. 日常维护#

7.1 定期检查#

1
openclaw status
2
openclaw health
3
openclaw doctor

7.2 日志管理#

1
openclaw logs --follow
2
openclaw logs --limit 1000 | grep -i "error\|failed"

7.3 备份配置#

1
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d)
2
tar -czvf ~/backups/clawd-backup.$(date +%Y%m%d).tar.gz ~/clawd/

7.4 更新流程#

1
openclaw gateway stop
2
curl -fsSL https://openclaw.ai/install.sh | bash
3
openclaw doctor
4
openclaw gateway start
5
openclaw status

7.5 监控告警（可选）#

1
cat > ~/clawd/monitor.sh << 'EOF'
2
#!/bin/bash
3
echo "=== $(date) ==="
4
openclaw status
5
openclaw health
6
openclaw logs --limit 100 | grep -i error | tail -5
7
if ! openclaw gateway status | grep -q "running"; then
8
  echo "⚠️ Gateway 未运行，尝试重启..."
9
  openclaw gateway restart
10
fi
11
EOF
12
chmod +x ~/clawd/monitor.sh

定时任务：

1
0 * * * * ~/clawd/monitor.sh >> ~/clawd/monitor.log 2>&1

7.6 清理维护#

1
find /tmp/moltbot -name "openclaw-*.log" -mtime +7 -delete
2
rm -rf ~/.openclaw/tmp/*

8. 故障排除#

8.1 快速诊断#

1
openclaw status --all
2
openclaw logs --follow
3
openclaw doctor
4
openclaw doctor --fix

8.2 常见问题#

命令找不到#

1
npm list -g --depth=0 | grep openclaw
2
echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc
3
source ~/.zshrc

Gateway 无法启动#

1
openclaw gateway --verbose
2
lsof -i :18789

无 API Key#

1
openclaw configure
2
export ANTHROPIC_API_KEY="sk-ant-api03-..."

频道无响应#

1
openclaw channels status --probe

8.3 紧急恢复#

1
openclaw gateway stop
2
cp ~/.clawdbot/clawdbot.json ~/.openclaw/openclaw.json.emergency
3
openclaw setup --reset config
4
openclaw onboard

9. 进阶配置#

9.1 多代理配置#

1
{
2
  "agents": {
3
    "list": [
4
      {
5
        "id": "main",
6
        "name": "主助手",
7
        "workspace": "~/clawd",
8
        "default": true,
9
        "model": {
10
          "primary": "minimax/MiniMax-M2.1",
11
          "fallbacks": ["glm-4"]
12
        }
13
      }
14
    ]
15
  }
16
}

9.2 模型主备配置#

1
{
2
  "agents": {
3
    "defaults": {
4
      "model": {
5
        "primary": "minimax/MiniMax-M2.1",
6
        "fallbacks": [
7
          "anthropic/claude-sonnet-4-0",
8
          "glm-4",
9
          "openai/gpt-4o"
10
        ]
11
      }
12
    }
13
  }
14
}

9.3 频道配置示例#

1
{
2
  "channels": {
3
    "whatsapp": {
4
      "dmPolicy": "pairing",
5
      "allowFrom": ["+15555550123"]
6
    }
7
  }
8
}

10. 常见问题#

内存：最低 2GB，推荐 4GB+
支持模型：Anthropic、OpenAI、MiniMax、GLM、Moonshot
切换模型：openclaw models set minimax/MiniMax-M2.1
支持平台：WhatsApp、Telegram、Discord 等

云服务器推荐#

腾讯云：https://curl.qcloud.com/52zSMIJx
阿里云：https://www.aliyun.com/activity/ecs/clawdbot
小免云（推荐） https://www.moebun.com/aff/CPMKQYVR 超便宜服务器 -小免云介绍小免云介绍

资源链接#

官方文档：docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw

✅ 快速参考卡#

1
# 日常
2
openclaw status
3
openclaw health
4
openclaw logs --follow
5

6
# 配置
7
openclaw configure
8

9
# Gateway
10
openclaw gateway start
11
openclaw gateway restart
12

13
# 修复
14
openclaw doctor
15
openclaw doctor --fix

音乐

音乐

超详细！OpenClaw 本地部署保姆级实战教学