教程

OpenClaw 快速入门:5 分钟搭建你的跨平台 AI 助手

OpenClaw 是一个开源自托管 AI 网关,支持通过 WhatsApp、Telegram、Discord 等消息应用与 AI 助手对话。本文介绍如何在 5 分钟内完成安装配置,包括 CLI 安装、引导向导、Gateway 启动和控制面板访问的完整流程。

2026/2/272分钟 阅读ClaudeEagle

OpenClaw 是一个自托管的 AI 网关,让你可以通过 WhatsApp、Telegram、Discord、iMessage 等任意聊天应用与 AI 编程助手对话。你在自己的机器上运行一个 Gateway 进程,它就成为你的消息应用与永远在线的 AI 助手之间的桥梁。

什么是 OpenClaw?

OpenClaw 的核心特点:

  • 自托管:运行在你的硬件上,数据你做主
  • 多频道:一个 Gateway 同时服务 WhatsApp、Telegram、Discord 等
  • Agent 原生:为编程 Agent 量身打造,支持工具调用、会话管理、记忆和多 Agent 路由
  • 开源:MIT 协议,社区驱动

你需要准备: Node 22+、一个 API Key(推荐 Anthropic)、5 分钟时间。

前置要求

  • Node.js 22 或更高版本

用以下命令检查你的 Node 版本:

bash
node --version

快速安装(CLI)

第 1 步:安装 OpenClaw

macOS / Linux:

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

Windows(PowerShell):

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

第 2 步:运行引导向导

bash
openclaw onboard --install-daemon

向导会帮你配置:

  • AI 模型认证(API Key)
  • Gateway 基本设置
  • 可选的消息频道(Telegram、WhatsApp 等)

第 3 步:检查 Gateway 状态

bash
openclaw gateway status

第 4 步:打开控制面板

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_HOME自定义主目录路径
OPENCLAW_STATE_DIR覆盖状态目录
OPENCLAW_CONFIG_PATH覆盖配置文件路径

安装完成后你将拥有

  • ✅ 一个运行中的 Gateway
  • ✅ 已配置的认证信息
  • ✅ 可通过控制面板或连接频道与 AI 对话

下一步

  • 配置 Telegram Bot:连接 Telegram 频道
  • 连接更多频道:WhatsApp、Discord、Signal
  • 深入学习:Skills 系统、多 Agent 架构

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

相关文章推荐

教程OpenClaw 零基础完全入门:安装、Telegram 配置、记忆系统和技能插件完整指南OpenClaw 从零开始完整教程:用宠物龙虾类比理解架构、npm 安装步骤、Telegram Bot 配置、SOUL.md 性格定义、三层记忆系统(每日日志/长期记忆/MEMORY.md)、HEARTBEAT.md 主动任务、技能安装,以及安全配置和常见问题解决。2026/4/18教程OpenClaw 快速入门:用 Telegram 控制 AI Agent,5 分钟搭建个人 AI 助理OpenClaw 5 分钟快速入门:用 Telegram 控制 AI Agent,含安装配置、Bot 创建、Skills 定义、多渠道支持、Claude Code 编程任务集成,以及与 Claude Code CLI 的区别和互补关系。2026/4/13教程OpenClaw 多 Agent 架构入门:用 Telegram Bot 控制你的 AI Agent 集群OpenClaw 多 Agent 架构入门指南:通过 Telegram 控制 AI Agent 集群,支持子 Agent 编排、MCP 集成和多节点部署。含快速开始教程。2026/4/7教程OpenClaw 接入 Nextcloud Talk:自托管视频会议平台 AI 助手完全配置指南OpenClaw 接入 Nextcloud Talk 的完整教程:Nextcloud Talk 的自托管通信平台特点(视频会议+聊天+文件协作)、插件安装(@openclaw/nextcloud-talk)、通过 occ CLI 创建 Bot 账户并注册 Webhook、OpenClaw 最简配置(serverUrl+appPassword+sharedSecret)、DM 私信与房间(Room)访问控制、Markdown 消息格式和表情反应支持、局域网/内网部署注意事项(WebSocket vs Polling),以及 Nextcloud Talk AI 助手的典型使用场景(会议摘要/文件问答/任务分派)。2026/3/24教程OpenClaw 接入 Mattermost:自托管团队聊天平台的 AI 助手配置完全指南OpenClaw 接入 Mattermost 的完整教程:插件安装方式(openclaw plugins install @openclaw/mattermost)、创建 Mattermost Bot 账户并获取 Token、最简配置(botToken + baseUrl + dmPolicy)、原生斜杠命令注册(oc_* 命令)、频道/群组/私信三种消息模式、线程会话管理、多账户配置、DM 白名单权限控制、交互式按钮支持,以及 Mattermost 与 Slack 的功能对比。2026/3/22教程OpenClaw 安装与快速上手:5 分钟从零到第一次 AI 对话OpenClaw 极速入门教程:Node.js 22 环境准备、一键安装脚本(macOS/Linux/Windows)、引导向导配置(认证/Gateway/频道/Hooks)、验证 Gateway 状态、打开控制台,5 分钟完成从零到第一次 AI 对话的全流程。2026/3/11