OpenClaw 新手入门 —— 5 分钟完成安装、引导与首次对话

入门安装引导命令行新手 OpenClaw 指南编辑部 📅 2026-09-21 ⏱ 6 分钟

从零开始安装开源 AI 助手 OpenClaw、运行引导向导、完成第一次对话的完整流程。

OpenClaw 是一款完全运行在你本机上的开源 AI 助手，由独立的非营利组织 OpenClaw Foundation（501(c)(3)）维护。它对自己的定位非常坦诚—— "No subscription. No hosted tier. No token. Your memories. Your skills. Your models. Your machines. Your data."（没有订阅、没有云端、没有 Token，记忆、技能、模型、机器、数据都归你）。本文带你 5 分钟从零跑到可用。

准备工作

一台运行 macOS 15+、Windows 10/11（x64 或 ARM64）或 Linux x64 的电脑
大约 500 MB 可用磁盘空间（用于运行时；模型本身按你选择的供应商另算）
一个模型供应商的账号或 API Key（OpenAI、Anthropic、Google、OpenRouter、本地 Ollama 等任选）

桌面应用会自动帮你安装 Node.js 24.16+ 或 26.1+，除非你想自己控制 Node 版本，否则不需要额外准备。

OpenClaw 不是云服务。Gateway 作为后台进程跑在你自己的机器上，提供本地 Dashboard。你的记忆、技能、对话都留在本机硬件上。

桌面应用安装（推荐）

前往官方安装页下载对应平台的安装包。目前最新稳定版为 macOS v2026.9.5、Windows v2026.9.4。
macOS 把应用拖入 /Applications，Windows 直接运行安装包。应用会一次性安装 Gateway、聊天客户端和配置向导。
打开 OpenClaw，按引导完成以下步骤：

选择模型供应商；
登录或粘贴 API Key；
让向导把 Gateway 注册为后台服务；
选择性地连接聊天软件（Telegram、Discord、Slack、WhatsApp、iMessage）。

引导结束后你就进入聊天 Dashboard。试着输入一句话确认通路：

你好！你能做什么？

一行命令安装（终端）

如果你想在服务器或无界面的机器上做干净安装，终端安装器比 GUI 更轻量：

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

安装器会自动下载 Node（如缺失），然后启动引导向导。macOS 上首次运行可能会请求管理员密码以安装 Homebrew。

如果只想安装 CLI 而不进入引导（用于自动化部署）：

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

这种方式会把 Node.js 与 OpenClaw 放在本地前缀（如 ~/.openclaw），不污染系统其他目录。

npm / pnpm / Bun

如果你已经自己管着 Node：

npm i -g openclaw
openclaw onboard

npm 12+ 需要加 --allow-scripts=openclaw 让安装钩子能跑起来。

pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard

Gateway 到底是什么

OpenClaw 自带一个后台运行的 Gateway 服务，负责：

本地 HTTP API（http://127.0.0.1:18789）—— 聊天 UI、技能、SDK 都通过它通信；
聊天渠道适配器 —— 桥接 Telegram、Discord、Slack、WhatsApp、iMessage；
记忆存储 —— 持久化你的长期事实。

你不必直接和 Gateway 打交道，但理解它存在会帮助你理解下面的命令——它们都在操作 Gateway。

通过 CLI 发起首次对话

打开终端：

openclaw chat "帮我写一封礼貌的跟进邮件，致上周见过的一位客户"

首次调用可能需要几秒钟等待模型响应。助手会流式输出 token，最终给你一段可直接粘贴的成稿。

想要一个持续交互的会话：

openclaw chat

输入 exit 或按 Ctrl-D 结束。整段对话会被写入本地记忆，并可在 Dashboard 检索。

用 doctor 自检

doctor 命令会诊断最常见的安装问题：

openclaw doctor

健康的安装会对每一项输出绿色 ✓。红色 ✗ 会精确告诉你哪个依赖缺失。

升级与版本渠道

OpenClaw 默认走 stable 渠道。想提前试用下一个 beta 版：

openclaw update --channel dev

切回 stable：

openclaw update --channel stable

下一步

连接 Telegram、WhatsApp、Discord 等聊天软件，让你能在已有的 IM 里联系助手；
学习如何编写可复用的技能，让助手能调用 API、执行命令或读取你的日历；
配置长期记忆，让关于你的事实能在会话之间保留；
遇到问题时，去看排错指南。

OpenClaw 指南编辑部

独立维护的 OpenClaw 教程与生态解读。

发现问题或需要更正？联系我们.