6 步完成部署

OpenClaw 快速开始

从零开始，按照以下步骤完成 OpenClaw 的安装和配置

最快体验路径

如果你只想快速体验，一行命令即可启动 Dashboard 开始聊天：

$ openclaw dashboard

http://127.0.0.1:18789/

OpenClaw 环境要求

在开始之前，请确保你的系统满足以下要求

Node.js ≥ 22

必需，用于运行 OpenClaw

操作系统

macOS、Linux 或 Windows（推荐 WSL2）

Brave Search API（可选）

用于启用网络搜索功能

Windows

Windows 用户强烈建议使用 WSL2 环境，可获得更好的兼容性和性能。

安装 OpenClaw

选择适合你的安装方式，推荐使用 One-liner 一键安装

$ curl -fsSL https://openclaw.bot/install.sh | bash

One-liner 会自动检测并安装 Node.js 和所有依赖，无需手动配置环境。

OpenClaw 配置向导

配置向导会引导你完成所有必要的设置，包括网关、认证和聊天平台连接

$ openclaw onboard --install-daemon

向导将配置以下内容

网关类型 - 选择本地或远程网关
AI 模型认证 - OpenAI (OAuth/API Key) 或 Anthropic (推荐 API Key，也支持 claude setup-token)
聊天平台 - WhatsApp 二维码、Telegram/Discord Bot Token 等
守护进程 - 后台服务安装 (macOS: launchd, Linux/WSL2: systemd)

配置文件存放位置（重要）

主配置目录~/.openclaw/
OAuth 凭证~/.openclaw/credentials/oauth.json
认证配置文件 (OAuth + API Key)~/.openclaw/agents/<agentId>/agent/auth-profiles.json

如果你已经安装了 Claude Code，可以通过 claude setup-token 复用现有凭证，无需重新配置。

无显示器的服务器部署提示：先在有浏览器的机器上完成 OAuth 认证，然后将 oauth.json 文件复制到服务器的对应目录。

启动 OpenClaw 网关

网关是 OpenClaw 的核心服务，负责处理所有消息

检查服务状态

$ openclaw gateway status

手动启动网关（如需指定端口）

$ openclaw gateway --port 18789

访问 Web Dashboard

http://127.0.0.1:18789/

快速验证（确认服务正常运行）

$ openclaw status

$ openclaw health

$ openclaw security audit --deep

连接聊天平台

配对并连接你的第一个聊天界面

WhatsApp (二维码登录)

$ openclaw channels login

运行命令后会显示 QR 码，打开 WhatsApp → 设置 → 已连接设备 → 扫描二维码即可完成连接。

建议使用专用手机号码，不推荐使用 VoIP 号码（容易被封禁）。凭证存储在 ~/.openclaw/credentials/whatsapp/ 目录。

Telegram / Discord / 其他

向导可以帮你配置 Token。如果你更喜欢手动配置，请参考以下文档：

Telegram:查看文档
Discord:查看文档
Mattermost (插件):查看文档

Telegram 提示：你的第一条私信会返回一个配对码，需要批准它（见下一步），否则机器人不会回应。

OpenClaw 安全配置

确保只有授权用户可以使用你的 AI 助手

默认状态：未知的 DM 会获得一个简短代码，消息不会在未经批准前处理。如果你的第一条 DM 没有收到回复，请批准配对：

查看待批准的配对请求

$ openclaw pairing list whatsapp

批准配对（将 [code] 替换为实际代码）

$ openclaw pairing approve whatsapp <code>

这是一个重要的安全措施，防止未授权用户访问你的 AI 助手。你也可以在配置文件中设置 allowlist 来自动允许特定号码。

验证 OpenClaw

在新终端中，发送一条测试消息

发送测试消息（替换为你的目标号码）

$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"

如果 openclaw health 显示「未配置授权」，请返回向导并设置 OAuth/密钥授权—没有这些，代理将无法响应。

调试提示

openclaw status --all最佳的、可复制且只读的调试报告
openclaw health或openclaw status --deep向正在运行的网关请求健康快照

OpenClaw 配置完成

恭喜！你已成功完成 OpenClaw 的安装和配置。现在可以开始使用 AI 助手了。