教程

OpenClaw 安装与快速上手:5 分钟从零到第一次 AI 对话

OpenClaw 极速入门教程:Node.js 22 环境准备、一键安装脚本(macOS/Linux/Windows)、引导向导配置(认证/Gateway/频道/Hooks)、验证 Gateway 状态、打开控制台,5 分钟完成从零到第一次 AI 对话的全流程。

2026/3/112分钟 阅读ClaudeEagle

本文是 OpenClaw 的极速入门指南,目标是帮你在 5 分钟内从零开始,完成安装、配置并发起第一次 AI 对话。

前提条件

  • Node.js 22 或更高版本
bash
node --version  # 确认版本 >= 22

第一步:安装 OpenClaw

macOS / Linux(推荐)

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

Windows(PowerShell)

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

安装脚本会自动处理依赖、PATH 配置等,一键完成。

第二步:运行引导向导

bash
openclaw onboard --install-daemon

向导会引导你完成:

  • 认证配置(Anthropic API Key 等)
  • Gateway 设置(端口、绑定地址等)
  • 可选频道(Telegram、WhatsApp、Discord 等)
  • 推荐 Hooks(如 session-memory 自动记忆)

--install-daemon 参数会将 Gateway 安装为系统服务,开机自启动。

第三步:验证 Gateway 状态

bash
openclaw gateway status

如果服务已在运行,会显示 running 状态。

第四步:打开控制台

bash
openclaw dashboard

或者直接在浏览器访问:http://127.0.0.1:18789/

控制台加载成功,说明你的 Gateway 已经就绪,可以开始对话了!

可选操作

前台运行 Gateway(用于调试)

bash
openclaw gateway --port 18789

发送测试消息(需要配置频道)

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

实用环境变量

如果你用服务账户运行 OpenClaw,或需要自定义路径:

变量说明
OPENCLAW_HOME内部路径解析使用的主目录
OPENCLAW_STATE_DIR覆盖状态目录路径
OPENCLAW_CONFIG_PATH覆盖配置文件路径

完成后你拥有了什么

  • ✅ 一个运行中的 Gateway
  • ✅ 已配置的 AI 认证
  • ✅ 可访问的控制台(或已连接的消息频道)

下一步

  • 连接 Telegram Bot:Telegram 频道配置
  • 连接更多频道:WhatsApp、Discord、Slack
  • 配置多 Agent 路由:让不同频道使用不同 AI 人格
  • 设置定时任务:让 Agent 主动发送早报、提醒等

原文:Getting Started - OpenClaw | 来源:OpenClaw 官方文档

相关文章推荐

教程OpenClaw 安装完全指南:从脚本一键安装到 Docker 容器化部署OpenClaw 安装完全指南:一键脚本(推荐)、npm/pnpm 手动安装、源码构建、Docker 容器化部署四种主流方式,以及 Fly.io/Railway/Hetzner 云端部署选项、安装后验证步骤和常见 PATH 问题排查。2026/3/1教程OpenClaw Windows 安装完全指南:WSL2 配置、PowerShell 安装与常见问题OpenClaw 在 Windows 上的完整安装教程:为什么推荐 WSL2、WSL2 安装与配置步骤、PowerShell 一键安装脚本、Windows 防火墙与端口设置、Telegram/Discord 频道配置、开机自启动设置,以及 Windows 特有的常见问题排查(路径问题、权限问题、WSL 网络访问)。2026/3/17教程OpenClaw 快速入门:5 分钟搭建你的跨平台 AI 助手OpenClaw 是一个开源自托管 AI 网关,支持通过 WhatsApp、Telegram、Discord 等消息应用与 AI 助手对话。本文介绍如何在 5 分钟内完成安装配置,包括 CLI 安装、引导向导、Gateway 启动和控制面板访问的完整流程。2026/2/27教程Claude Code 新手完全入门指南 2026:从安装到第一个功能的 30 分钟教程Claude Code 零基础入门完整教程:系统要求和安装(npm 全局安装)、两种认证方式(Claude.ai 账号 vs API Key)、CLAUDE.md 快速配置(/init 生成草稿)、正确的提问方式(说目标不说步骤)、/plan 先规划后执行的工作流、最常用 10 个命令速查、新手常见 4 个错误,以及 7 天上手计划。2026/4/23教程OpenClaw Skills 开发完全指南:从零编写高质量 SKILL.md 自定义技能文件OpenClaw Skills 开发完整教程:SKILL.md 文件结构详解、自动触发 vs 显式触发原理、三个实战模板(GitHub 仓库管理/每日信息简报/代码健康检查)、让技能精准自动触发的描述写法,以及技能质量标准和 clawhub.ai 使用方法。2026/4/19教程OpenClaw 零基础完全入门:安装、Telegram 配置、记忆系统和技能插件完整指南OpenClaw 从零开始完整教程:用宠物龙虾类比理解架构、npm 安装步骤、Telegram Bot 配置、SOUL.md 性格定义、三层记忆系统(每日日志/长期记忆/MEMORY.md)、HEARTBEAT.md 主动任务、技能安装,以及安全配置和常见问题解决。2026/4/18