OpenClaw 史上最全手把手的保姆级安装配置教程

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

 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg>

OpenClaw 是 Moltbot/Clawdbot 的最新正式名称。项目经历了多次更名：Clawdbot → Moltbot → OpenClaw（当前名称），本教程基于官方中文社区文档 https://www.moltcn.com/start/getting-started.html 编写。

OpenClaw 是什么？
核心特性
系统要求
安装前准备
安装 OpenClaw
首次配置向导
启动 Gateway
连接即时通讯平台
DM 安全配对
常用命令大全
日常维护
故障排除
安全加固
从源码安装（开发模式）
常见问题

OpenClaw 是由 Peter Steinberger（PSPDFKit 创始人）和 Mario Zechner（Pi 创建者）开发的开源个人 AI 助手项目。

🦞 名字由来

OpenClaw = CLAW + TARDIS — 因为每只太空龙虾都需要一台时间机器。

🎯 核心定位

“Any OS + WhatsApp/Telegram/Discord/iMessage gateway for AI agents (Pi). Send a message, get an agent response — from your pocket.”

OpenClaw 将多个即时通讯平台连接到 AI 编程代理（如 Pi），让你通过熟悉的聊天工具直接控制你的电脑。

📱 支持的平台

平台类型说明 WhatsApp 原生集成通过 Baileys 使用 WhatsApp Web 协议 Telegram Bot API DMs + 群组 via grammY Discord Bot API DMs + 频道 via discord.js iMessage 本地集成 macOS 本地 imsg CLI Mattermost 插件 Bot Token + WebSocket 事件

✨ 主要功能

🤖 AI 代理桥接 — 连接 Pi 代理（RPC 模式），支持工具流式传输
💬 流式响应 — 块流式传输 + Telegram 草稿流式传输
🧠 多代理路由 — 将不同提供者/用户路由到隔离的代理
🔐 订阅认证 — Anthropic (Claude Pro/Max) + OpenAI (ChatGPT/Codex) via OAuth
💬 会话管理 — 私聊合并为共享的 main 会话；群聊隔离
👥 群聊支持 — @提及触发（可配置为始终响应）
📎 媒体支持 — 发送和接收图片、音频、文档
🎤 语音笔记 — 可选的转录钩子
🖥️ WebChat + macOS 应用 — 本地 UI + 菜单栏辅助
📱 iOS/Android 节点 — 配对后暴露 Canvas + 聊天 + 摄像头

🏗️ 架构图

WhatsApp / Telegram / Discord / iMessage (+ plugins)

│

▼

┌───────────────────────────┐

│ Gateway │ ws://127.0.0.1:18789 (loopback-only)

│ (single source) │

│ │ http://:18793

│ │ /openclaw/canvas/ (Canvas host)

└───────────┬───────────────┘

│

├─ Pi agent (RPC)

├─ CLI (openclaw …)

├─ Chat UI (SwiftUI)

├─ macOS app (OpenClaw.app)

├─ iOS node via Gateway WS + pairing

└─ Android node via Gateway WS + pairing

基础要求

项目要求说明 Node.js ≥ 22.x 必需，运行时要求 pnpm 可选但推荐从源码构建时推荐内存最低 2GB，推荐 4GB+ 磁盘空间最低 1GB，推荐 5GB+

各平台要求

macOS：如果要构建应用，需安装 Xcode / Command Line Tools；仅 CLI + Gateway，Node.js 足够
Windows：强烈推荐使用 WSL2（推荐 Ubuntu）；原生 Windows 未测试，问题更多，工具兼容性较差；必须先安装 WSL2，然后在 WSL 内运行 Linux 步骤
Linux：无额外要求

🌐 网络要求

需要访问互联网（API 调用）；国内用户：必须使用代理，否则 Gateway 无法启动

4.1 获取 API Key

OpenClaw 需要连接 AI 模型服务。选择以下其一：

Anthropic Claude （推荐）：访问 Anthropic Console，注册账号并获取 API Key；或使用 claude setup-token 复用 Claude Code 凭证
OpenAI（ChatGPT/Codex）：访问 OpenAI Platform，创建 API Key
其他选项：MiniMax（国内推荐）、GLM（智谱AI）、本地 Ollama 模型

4.2 安装 Node.js

使用 nvm 安装（推荐）：

GPT plus 代充 只需 145

直接安装（macOS）：

4.3 可选：安装 pnpm（推荐用于源码构建）

GPT plus 代充 只需 145

5.1 一键安装（推荐）

macOS / Linux：

Windows (PowerShell)：

GPT plus 代充 只需 145

5.2 NPM 安装（备选）

5.3 验证安装

GPT plus 代充 只需 145

5.4 Windows WSL2 安装

如果使用 Windows，必须通过 WSL2：

然后在 WSL2 终端中：

GPT plus 代充 只需 145

6.1 启动向导

运行向导并安装后台服务：

6.2 向导步骤说明

步骤 1：Gateway 模式

GPT plus 代充 只需 145

步骤 2：认证方式

推荐 Anthropic API key：claude setup-token 也支持用于复用 Claude Code 凭证。

步骤 3：选择模型

GPT plus 代充 只需 145

步骤 4：频道配置

步骤 5：配对安全设置

默认：未知私聊会收到简短代码，需要批准后才能处理消息。

步骤 6：工作区设置

GPT plus 代充 只需 145

步骤 7：技能选择

步骤 8：后台服务安装

GPT plus 代充 只需 145

运行时：Node（推荐；WhatsApp/Telegram 必须）。Bun 不推荐。

步骤 9：Gateway Token

向导会生成一个 Gateway token（即使对于 loopback），并存储在 gateway.auth.token 中。

6.3 认证文件位置（重要）

OAuth 凭证（传统导入）：~/.openclaw/credentials/oauth.json

认证配置文件：~/.openclaw/agents//agent/auth-profiles.json

💡 无头服务器提示：先在普通机器上完成 OAuth，然后复制 oauth.json 到网关主机。

7.1 检查服务状态

如果向导中安装了服务，Gateway 应该已经在运行：

7.2 手动启动

前台运行（调试）：

GPT plus 代充 只需 145

7.3 访问控制 UI

本地访问（Gateway 主机上）：

Dashboard: http://127.0.0.1:18789/

Control UI: http://127.0.0.1:18789/openclaw/

如果配置了 token，需要在 Control UI 设置中粘贴 token（存储为 connect.params.auth.token）。

7.4 停止/重启

7.5 快速验证（2分钟）

GPT plus 代充 只需 145

💡 openclaw status --all 是**的可粘贴、只读调试报告。

8.1 WhatsApp（QR 登录）

扫描说明：

打开手机 WhatsApp
进入设置 → 已关联设备
扫描屏幕上的二维码

8.2 Telegram

方式一：向导配置

向导可以直接配置 Telegram Bot Token。

方式二：手动配置

创建 Telegram Bot：

访问 @BotFather
发送 /newbot
获取 Bot Token

配置：

GPT plus 代充 只需 145

Telegram DM 提示：你的第一条 DM 会返回配对代码。批准后（见下一节）机器人才能回复。

8.3 Discord

方式一：向导配置

向导可以直接配置 Discord Bot Token。

方式二：手动配置

创建 Discord 应用：

访问 Discord Developer Portal
创建应用，添加 Bot
获取 Bot Token
邀请 Bot 到服务器

配置：

8.4 iMessage（仅 macOS）

需要本地安装 imsg CLI：

GPT plus 代充 只需 145

8.5 Mattermost（插件）

需要 Mattermost 插件 Token：

8.6 查看所有频道状态

GPT plus 代充 只需 145

9.1 默认安全策略

默认情况下：未知私聊会收到一个简短代码，消息不会被处理直到你批准。

9.2 批准配对

如果你的第一条 DM 没有回复，批准配对：

9.3 配置配对策略

GPT plus 代充 只需 145

10.1 基础命令

10.2 Gateway 管理

GPT plus 代充 只需 145

10.3 配置管理

10.4 模型管理

GPT plus 代充 只需 145

10.5 频道管理

10.6 配对管理

GPT plus 代充 只需 145

10.7 消息发送

10.8 代理 (Agents)

GPT plus 代充 只需 145

10.9 会话管理

10.10 技能管理

GPT plus 代充 只需 145

10.11 日志和诊断

10.12 目录和工作区

GPT plus 代充 只需 145

10.13 更新和升级

10.14 安全相关

GPT plus 代充 只需 145

11.1 定期检查

11.2 日志管理

GPT plus 代充 只需 145

11.3 备份配置

11.4 更新流程

GPT plus 代充 只需 145

11.5 监控告警（可选）

创建监控脚本：

添加 cron 任务：

GPT plus 代充 只需 145

11.6 清理和维护

12.1 快速诊断流程

GPT plus 代充 只需 145

12.2 常见问题

问题 1：命令找不到

问题 2：Gateway 无法启动

GPT plus 代充 只需 145

问题 3：无 API Key

问题 4：频道无响应

GPT plus 代充 只需 145

问题 5：OAuth 失败

问题 6：模型不可用

GPT plus 代充 只需 145

问题 7：内存不足

问题 8：国内网络问题

GPT plus 代充 只需 145

12.3 Bun 警告

⚠️ Bun + WhatsApp/Telegram：Bun 与这些频道存在已知问题。如果使用 WhatsApp 或 Telegram，请使用 Node 运行 Gateway。

12.4 紧急恢复

GPT plus 代充 只需 145

⚠️ 重要警告：OpenClaw Gateway 默认配置为本地使用，从未考虑过暴露在公网场景。错误配置可能导致：API Key 泄露、跨平台聊天记录泄露、主机系统完整访问权限泄露

13.1 安全检查

13.2 必要的安全措施

绑定本地回环地址

GPT plus 代充 只需 145

启用认证

文件权限加固

GPT plus 代充 只需 145

防火墙配置

13.3 沙箱配置

OpenClaw 支持沙箱隔离，限制代理的访问范围：

GPT plus 代充 只需 145

如果想让主代理始终在主机运行：

13.4 远程访问安全

如果需要远程访问，使用 Tailscale 或 SSH 隧道：

Tailscale（推荐）

GPT plus 代充 只需 145

SSH 隧道

13.5 云服务器安全组

端口来源用途 22 你的 IP SSH 18789 Tailscale IP / VPN OpenClaw Gateway

如果你想为 OpenClaw 本身做贡献：

GPT plus 代充 只需 145

如果还没有全局安装，可以通过 pnpm 运行：

Gateway（从源码运行）

GPT plus 代充 只需 145

Q1: 需要多少内存？

A: 最低 2GB，推荐 4GB+。如果运行多个代理或大量