教程

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 接入 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教程OpenClaw 接入 Nextcloud Talk:自托管协作平台的 Bot 配置与房间访问控制OpenClaw 接入 Nextcloud Talk 完整教程:occ talk:bot:install 命令注册 Bot、shared-secret 验证、私信和房间访问控制(配对/开放/白名单)、功能支持对照表(DM/房间/反应/Markdown),以及 Webhook 反向代理和房间类型识别的注意事项。2026/3/3教程OpenClaw WebChat 指南:原生聊天 UI、Gateway WebSocket 直连与远程访问OpenClaw WebChat 完整指南:原生 SwiftUI 聊天 UI 直连 Gateway WebSocket(无需独立服务器)、chat.history/send/inject 三种消息类型、中断运行的历史持久化、Control UI 工具面板,以及通过 SSH 隧道或 Tailscale 远程访问的配置方法。2026/3/2教程OpenClaw 接入 Mattermost:自托管团队协作平台的 AI Bot 完整配置OpenClaw 接入 Mattermost 自托管平台完整教程:插件安装、Bot 账号创建���三种聊天模式(oncall/onmessage/onchar)、私信和频道访问控制、消息反应配置、外发消息目标格式,以及多 Mattermost 实例管理。2026/3/2