首页 教程 分类 Skills下载 关于
ZH EN JA KO
安装部署

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

· 4 分钟

这篇文章的目标只有一个:用最短的路径,让你从零开始跑通 OpenClaw 的完整流程——安装、配置、连上 Telegram、发出第一条消息并收到 AI 的回复。不讲原理,不做扩展,只走最快路线。

OpenClaw 是什么

OpenClaw 是一个开源的 AI Agent 网关,支持 macOS、Linux 和 Windows。它的核心能力是把你日常使用的聊天工具(WhatsApp、Telegram、Discord、iMessage 等)统一接入各种 AI 模型,让你在熟悉的聊天界面里直接和 AI 对话。

它的几个核心特性值得提前了解:

  • 多频道网关:一个实例同时接管多个聊天平台
  • 多 Agent 路由:不同对话可以路由到不同的 AI 模型
  • 会话隔离:每个用户、每个频道的对话上下文互不干扰
  • 插件扩展:通过 Skill 系统扩展功能
  • 媒体支持:图片、语音等多媒体消息的处理能力

了解这些就够了,下面开始动手。

前置条件

你只需要准备两样东西:

  • Node.js 22+:运行 node -v 确认版本,低于 22 请先升级
  • 一个 Telegram 账号:Telegram 是所有频道中配置最快的,只需要一个 Bot Token 即可

第一步:安装 OpenClaw

打开终端,执行全局安装:

npm install -g openclaw@latest

安装完成后,运行内置的环境检查工具,确认一切就绪:

openclaw doctor

如果所有检查项都通过,说明安装没有问题。如果有报错,按照提示修复后重新运行 openclaw doctor 即可。

第二步:初始化并安装守护进程

执行 onboard 命令完成初始化配置,同时安装后台守护进程:

openclaw onboard --install-daemon

这一步会引导你完成几项基础设置:

  1. 选择 AI 模型提供商(如 OpenAI、Claude 等)
  2. 填入对应的 API 密钥
  3. 安装守护进程,让 OpenClaw 可以在后台持续运行

所有配置会写入 ~/.openclaw/openclaw.json 文件。后续如果需要修改配置,直接编辑这个文件即可。

第三步:登录并配置 Telegram 频道

接下来,连接你的第一个聊天频道。先运行登录命令:

openclaw channels login

选择 Telegram 后,系统会要求你输入 Bot Token。如果你还没有 Token,按以下步骤获取:

  1. 在 Telegram 中搜索 @BotFather 并发起对话
  2. 发送 /newbot,按提示设置机器人名称和用户名
  3. 创建成功后,BotFather 会返回一个 Token(格式类似 7123456789:AAHxxx...

将 Token 粘贴到终端中,频道配置就完成了。

第四步:启动网关

一切就绪,启动 OpenClaw 网关:

openclaw gateway --port 18789

看到终端输出网关已启动的提示后,打开 Telegram,找到你刚才创建的机器人,发送一条消息——比如"你好"。

如果一切正常,几秒钟内你就会收到 AI 的回复。恭喜,你的第一次 AI 对话已经成功跑通。

接下来可以做什么

完成基础流程后,以下几个方向值得继续探索:

  • Web 仪表盘:OpenClaw 提供了可视化的管理后台,方便监控对话和调整配置
  • 移动端配对:通过 Mobile Node 功能,可以将 iOS 或 Android 设备与 OpenClaw 实例配对
  • 接入更多频道:在 openclaw channels login 中添加 WhatsApp、Discord、Slack 等其他平台
  • 安装插件:通过 Skill Marketplace 浏览和安装社区开发的功能插件

最小可用路径就是这四步。整个过程顺利的话,确实只需要 5 分钟。遇到问题时,openclaw doctor 是你最好的排查起点。

OpenClaw 是开源免费的个人AI助手,支持 WhatsApp、Telegram、Discord 等多平台接入