教程

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教程WorkBuddy 直连微信:发条消息就能远程指挥电脑干活,兼容 OpenClaw 技能体系腾讯 WorkBuddy 微信直连功能详解:配置微信客服号即可远程指挥电脑执行任务,支持企微断网自动重连与定时任务自动化,技能包完全兼容OpenClaw体系可无缝迁移,附向内隔离向外防御安全设计解读。2026/8/15教程OpenClaw Sessions 磁盘维护完全指南:sessions.json 自动清理与 openclaw sessions cleanup 命令详解 OpenClaw session.maintenance 磁盘维护配置:warn/enforce 双模式、清理执行顺序、maxDiskBytes/highWaterBytes 磁盘预算控制,以及 openclaw sessions cleanup 命令的 dry-run 安全用法。2026/8/13教程OpenClaw SecretRef 完全教程:让 API Key 不用再以明文躺在配置文件里详解 OpenClaw SecretRef 密钥引用机制:内存快照运行时模型、active/inactive Surface 判定逻辑、env/file/exec 三种引用来源写法,以及生产环境凭据管理的实战建议。2026/8/12