这篇文章的目标只有一个:用最短的路径,让你从零开始跑通 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
这一步会引导你完成几项基础设置:
- 选择 AI 模型提供商(如 OpenAI、Claude 等)
- 填入对应的 API 密钥
- 安装守护进程,让 OpenClaw 可以在后台持续运行
所有配置会写入 ~/.openclaw/openclaw.json 文件。后续如果需要修改配置,直接编辑这个文件即可。
第三步:登录并配置 Telegram 频道
接下来,连接你的第一个聊天频道。先运行登录命令:
openclaw channels login
选择 Telegram 后,系统会要求你输入 Bot Token。如果你还没有 Token,按以下步骤获取:
- 在 Telegram 中搜索
@BotFather并发起对话 - 发送
/newbot,按提示设置机器人名称和用户名 - 创建成功后,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 是你最好的排查起点。