教程

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教程OpenClaw Standing Orders 完全指南:让 AI 记住你的长期规则和行为偏好OpenClaw Standing Orders(常驻指令)功能完整教程:Standing Orders 与 SOUL.md 的区别(动态运行时规则 vs 静态人格文件)、通过对话动态添加/查看/删除常驻指令、指令的持久化存储与跨会话生效机制、适合写入 Standing Orders 的内容类型(格式偏好/禁止行为/固定工作流)、与 Hooks 的协同使用、按渠道/Agent 设置不同的 Standing Orders,以及常驻指令的最佳实践(写清晰的规则、避免矛盾冲突、定期清理过时规则)。2026/3/26教程OpenClaw 多媒体处理完全指南:图片识别、音频转写与视频理解实战OpenClaw 多媒体处理(Media)完整教程:发送图片给 AI 进行视觉分析(OCR/物体识别/图表解读/代码截图)、音频消息自动转写为文字(Whisper/系统STT)、视频消息关键帧提取与理解、Node 摄像头实时拍照触发分析、媒体消息的渠道支持差异(各渠道的图片/音频/视频支持情况对比)、大文件处理策略(分割/压缩/超时设置)、媒体消息在不同 AI 模型上的能力对比(Claude Vision/GPT-4V/Gemini Pro Vision),以及本地媒体文件分析(read 工具读取图片路径)。2026/3/25教程OpenClaw TUI 完全指南:纯键盘操作的终端管理界面使用详解OpenClaw TUI(Terminal User Interface,终端用户界面)完整使用指南:TUI 与 Control UI(浏览器)的定位对比、适合 TUI 的场景(SSH 远程/无浏览器服务器/低带宽环境)、启动命令(openclaw tui)及参数、界面布局(Agents 面板/Sessions 面板/Channels 状态/Logs 实时流)、全键盘快捷键手册(导航/选择/搜索/刷新/退出)、在 TUI 中发送测试消息、实时日志过滤与搜索,以及 TUI 与 tmux/screen 配合使用的后台运行方案。2026/3/25