📋 目录

• [什么是 OpenClaw](#什么是-openclaw)

• [系统要求]

• [安装前准备]

• [安装方法]

• [首次配置]

• [启动和使用]

• [连接即时通讯平台]

• [常用命令

• [故障排除]

什么是 OpenClaw

支持的平台

• WhatsApp：通过 Baileys 使用 WhatsApp Web 协议

• Telegram：Bot API，支持私聊和群组

• Discord：Bot API，支持私聊和频道

• iMessage：macOS 本地集成

• Mattermost：插件支持

系统要求

基础要求

各平台要求

macOS

• 如果要构建应用：安装 Xcode / Command Line Tools

• 仅 CLI + Gateway：Node.js 足够

Windows

• 强烈推荐使用 WSL2（推荐 Ubuntu）

• 原生 Windows 未测试，问题更多，工具兼容性较差

• 必须先安装 WSL2，然后在 WSL 内运行 Linux 步骤

Linux

• 无额外要求

网络要求

• 需要访问互联网（API 调用）

• 国内用户：必须使用代理，否则 Gateway 无法启动

安装前准备

获取 API Key

Anthropic Claude（推荐）

1. 访问 Anthropic Console

2. 注册账号并获取 API Key

3. 或使用 claude setup-token 复用 Claude Code 凭证

OpenAI（ChatGPT/Codex）

1. 访问 OpenAI Platform

2. 创建 API Key

其他选项

• MiniMax（国内推荐）

• GLM（智谱 AI）

• 本地 Ollama 模型

安装 Node.js

使用 nvm 安装（推荐）

直接安装（macOS）

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

安装方法

一键安装（推荐）

macOS / Linux

Windows (PowerShell)

NPM 安装（备选）

验证安装

Windows WSL2 安装

首次配置

启动配置向导

向导步骤说明

步骤 1：Gateway 模式

步骤 2：认证方式

步骤 3：选择模型

步骤 4：频道配置

步骤 5：配对安全设置

步骤 6：工作区设置

步骤 7：技能选择

步骤 8：后台服务安装

启动和使用

检查服务状态

手动启动

访问控制 UI

• Dashboard: http://127.0.0.1:18789/

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

停止 / 重启

连接即时通讯平台

WhatsApp（QR 登录）

1. 打开手机 WhatsApp

2. 进入 设置 → 已关联设备

3. 扫描屏幕上的二维码

Telegram

方式一：向导配置

方式二：手动配置

1. 创建 Telegram Bot：
1. 访问 @BotFather
2. 发送 /newbot
3. 获取 Bot Token

2. 配置：

Discord

方式一：向导配置

方式二：手动配置

1. 创建 Discord 应用：
1. 访问 Discord Developer Portal
2. 创建应用，添加 Bot
3. 获取 Bot Token
4. 邀请 Bot 到服务器

2. 配置：

iMessage（仅 macOS）

查看所有频道状态

常用命令

基础命令

Gateway 管理

配置管理

频道管理

故障排除

常见问题

1. 端口被占用

2. 无法连接到 AI 服务

• 检查网络连接

• 确保 API Key 正确

• 国内用户需要使用代理

3. 频道无法连接

• 检查 Bot Token 是否正确

• 确保 Bot 有足够的权限

• 检查网络连接

查看日志

诊断和修复