OpenClaw 快速入门指南
学习如何安装、配置并开始使用 OpenClaw AI 网关。从 CLI 安装到首次 AI 对话，只需几分钟。
你将学到
- 使用 curl、npm 或 pnpm 安装 OpenClaw CLI
- 运行配置向导完成环境设置
- 启动 OpenClaw Gateway 服务
- 配对并连接 WhatsApp、Telegram 等渠道
- 通过 OpenClaw 发送你的第一条 AI 消息
目录导航
0前置条件
开始之前，请确保你已经：
- 系统已安装 Node.js 22 或更高版本
- （可选但推荐）pnpm（如果从源码构建）
- （推荐）Brave Search API 密钥，用于网页搜索。最简单的方式：openclaw configure --section web（存储为 tools.web.search.apiKey）
- macOS：如果计划构建应用程序，请安装 Xcode / CLT。仅安装 CLI + gateway，Node 就足够了
- Windows：使用 WSL2（推荐 Ubuntu）。WSL2 强烈推荐；原生 Windows 未测试，问题更多，工具兼容性更差。请先安装 WSL2，然后在 WSL 内运行 Linux 步骤
1安装 CLI（推荐）
选择你喜欢的安装方式：
使用 curl（Linux/macOS）
一键快速安装：
curl -fsSL https://openclaw.ai/install.sh | bash使用 PowerShell（Windows）
Windows 快速安装：
iwr -useb https://openclaw.ai/install.ps1 | iex使用 npm
通过 npm 包管理器安装：
npm install -g openclaw@latest使用 pnpm
通过 pnpm 安装（更快的替代方案）：
pnpm add -g openclaw@latest2运行配置向导（并安装服务）
配置向导将引导你完成初始配置和守护进程安装：
openclaw onboard --install-daemonWhat the wizard does:
- 1配置本地与远程 Gateway
- 2认证：OpenAI Code (Codex) 订阅（OAuth）或 API 密钥。对于 Anthropic，建议使用 API 密钥；也支持 claude setup-token
- 3提供商：WhatsApp QR 登录、Telegram/Discord 机器人令牌、Mattermost 插件令牌等
- 4守护进程：后台安装（launchd/systemd；WSL2 使用 systemd）
- 5运行时：Node（推荐；WhatsApp/Telegram 必需）。不推荐 Bun
- 6Gateway 令牌：向导默认生成一个（即使在 loopback 上）并存储在 gateway.auth.token 中
认证配置位置（重要）
推荐 Anthropic 路径：设置 API 密钥（向导可以存储它供服务使用）。如果想要重用 Claude Code 凭据，也支持 claude setup-token。OAuth 凭据（传统导入）：~/.openclaw/credentials/oauth.json。认证配置文件（OAuth + API 密钥）：~/.openclaw/agents/[agentId]/agent/auth-profiles.json。无头/服务器提示：先在正常机器上进行 OAuth，然后将 oauth.json 复制到 gateway 主机。
3启动 Gateway
如果在配置期间安装了服务，Gateway 应该已经在运行：
检查 Gateway 状态
openclaw gateway status手动启动（前台）
openclaw gateway --port 18789 --verbose快速验证（2 分钟）
验证 OpenClaw 安装是否正常工作：
检查状态
openclaw status显示整体系统状态和配置
运行健康检查
openclaw health验证所有组件正常运行
安全审计
openclaw security audit --deep检查安全漏洞
4配对并连接你的第一个聊天平台
连接你喜欢的消息平台，开始与 AI 对话：
📱WhatsApp（二维码登录）
通过 WhatsApp → Settings → Linked Devices 扫描：
openclaw channels login💬Telegram / Discord / 其他平台
向导可以为你写入令牌/配置。如果更喜欢手动配置，从以下开始：Telegram：Telegram；Discord：Discord；Mattermost（插件）：Mattermost。Telegram DM 提示：你的第一个 DM 返回配对代码。批准它（见下一步），否则机器人不会响应。
私信安全（配对批准）
默认姿态：未知 DM 获得简短代码，消息在批准前不被处理。如果你的第一个 DM 没有回复，批准配对：
列出待批准配对
openclaw pairing list whatsapp批准配对
openclaw pairing approve whatsapp \<code\>从源码安装（开发）
如果你正在开发 OpenClaw 本身，从源码运行：
克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw安装依赖
pnpm install构建 UI
pnpm ui:build # 首次运行时自动安装 UI 依赖构建项目
pnpm build运行配置向导
openclaw onboard --install-daemon启动 Gateway
node openclaw.mjs gateway --port 18789 --verbose端到端验证
在新终端中，发送测试消息：
openclaw message send --target +15555550123 --message "Hello from OpenClaw"💡 如果 openclaw health 显示'未配置认证'，请返回向导并设置 OAuth/key 认证 —— agent 没有它将无法响应。提示：openclaw status --all 是最好的可粘贴、只读调试报告。健康探测：openclaw health（或 openclaw status --deep）询问运行中的 gateway 以获取健康快照。
后续步骤（可选，但推荐）
- macOS 菜单栏应用 + 语音唤醒：<a href="https://docs.openclaw.ai/platforms/macos" target="_blank" rel="noopener noreferrer" class="text-primary hover:underline">macOS 应用</a>
- iOS/Android 节点（Canvas/摄像头/语音）：<a href="https://docs.openclaw.ai/nodes" target="_blank" rel="noopener noreferrer" class="text-primary hover:underline">节点</a>
- 远程访问（SSH 隧道 / Tailscale Serve）：<a href="https://docs.openclaw.ai/remote" target="_blank" rel="noopener noreferrer" class="text-primary hover:underline">远程访问和 Tailscale</a>
- 始终在线 / VPN 设置：<a href="https://docs.openclaw.ai/remote" target="_blank" rel="noopener noreferrer" class="text-primary hover:underline">远程访问</a>、<a href="https://exe.dev" target="_blank" rel="noopener noreferrer" class="text-primary hover:underline">exe.dev</a>、<a href="https://docs.openclaw.ai/platforms/hetzner" target="_blank" rel="noopener noreferrer" class="text-primary hover:underline">Hetzner</a>、<a href="https://docs.openclaw.ai/platforms/macos-remote" target="_blank" rel="noopener noreferrer" class="text-primary hover:underline">macOS 远程</a>
故障排查
安装脚本失败
Gateway 无法启动
无法连接 WhatsApp
消息无法发送
继续学习
OpenClaw 已运行，探索更多功能：