安装部署:十分钟跑通第一个助手
从安装 Gateway、配置模型到接入 Telegram,十分钟搭好一个能随时对话的个人助手。
准备与安装
前置要求:Node.js 22+。一条命令安装:
npm install -g openclaw@latest
openclaw onboard # 交互式引导:配模型、选渠道
配置模型
引导向导里选择模型提供商。支持 Claude 订阅、OpenAI、OpenAI 兼容接口(国产模型如智谱 GLM、MiniMax 都走这条路)以及本地模型(Ollama)。国内网络环境建议直接用 OpenAI 兼容的国产模型:
# 配置文件示例(~/.openclaw/ 下)
# 设置 base_url 指向兼容接口 + 对应 api-key 即可
接入 Telegram(推荐渠道)
- 在 Telegram 找 @BotFather 创建 Bot,拿到 Token;
- 把 Token 写进配置(或环境变量),并设置
allowFrom白名单为你的 Telegram 用户名; - 启动 Gateway:
openclaw gateway; - 在 Telegram 给 Bot 发第一条私信,按提示批准配对。
完成后,你在 Telegram 里说的话就会由你配置的模型驱动助手来回复 —— 它已经能使用内置工具(读文件、跑命令)帮你干活了。
常见坑
- 国内网络连不上模型 API → 用兼容接口的国产模型或配置代理;
- WhatsApp 扫码后掉线 → Baileys 是非官方协议,重扫即可,重要场景用 Telegram;
- 忘了配 allowFrom → 任何人私聊都能指挥你的助手,务必第一时间配置。
📝 课后练习
quiz-1 接入 Telegram 渠道需要准备什么?