第 0 章：10 分钟极速上手

龙虾学堂2026年3月23日

安装 OpenClaw，配置 Telegram 通道，完成第一次对话

第 0 章：10 分钟极速上手 ⭐⭐⭐

本章解决什么问题：安装 OpenClaw，配置 Telegram 通道，完成第一次对话

学习目标：能够在本地安装 OpenClaw，配置 Telegram bot，并通过 Telegram 与 AI 助手对话

版本基准：OpenClaw 3.13

0.1 一句话介绍 OpenClaw

OpenClaw = 你的 AI 助手，你动嘴，它干活

OpenClaw 是一个运行在你电脑上的 AI 助手框架。它不是普通的聊天机器人，而是一个能真正帮你干活的智能代理：

📖 读取文件 — 查看代码、文档、配置文件
✍️ 编写代码 — 写函数、改 bug、优化性能
🔍 搜索资料 — 查文档、搜网页、整理信息
🌐 操作网页 — 填表单、点按钮、截图、提取数据
💬 发送消息 — 集成 Telegram、Discord、Slack 等平台

使用方式：安装后通过 Telegram/Discord 等聊天软件与它对话，就像给朋友发消息一样自然。

术语解释

Gateway：OpenClaw 的核心服务，负责处理消息和调度任务

通道 (Channel)：连接的外部聊天平台，如 Telegram、Discord

Bot：你在 Telegram 等平台上对话的机器人账号

0.2 安装 OpenClaw

0.2.1 安装前提

条件	要求	检查方法
Node.js	Node 24 推荐 (Node 22.16+ 兼容)	`node --version`
npm	随 Node.js 一起安装	`npm --version`
系统	macOS / Linux / Windows (WSL)	—

新手建议：Windows 用户推荐使用 WSL2。如果没有 Node.js，先访问 https://nodejs.org 安装 LTS 版本。

0.2.2 安装命令

方式一：官方安装脚本（推荐）

macOS / Linux：

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

Windows (PowerShell)：

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

方式二：npm 安装（备选）

打开终端（Terminal），执行：

npm install -g openclaw

0.2.3 验证安装

openclaw --version

✅ 成功输出示例：

OpenClaw 2026.3.13 (61d171a)

新手常见坑：

npm: command not found → 先安装 Node.js

Permission denied → macOS/Linux 使用 sudo npm install -g openclaw

0.3 运行 Onboarding 并启动 Gateway（推荐）

首次安装推荐运行 onboarding 向导，自动完成配置并安装 Gateway 服务：

openclaw onboard --install-daemon

向导会引导你：

选择模型提供商（Anthropic/OpenAI/Google 等）
设置 API Key
配置 Gateway

手动启动 Gateway（可选）：

方式一：前台运行（推荐新手测试）

# 前台运行 Gateway（占用终端）
openclaw gateway

看到 Listening: 127.0.0.1:18789 表示成功。按 Ctrl+C 停止。

方式二：后台服务（长期使用）

# 安装 systemd 服务
openclaw gateway install

# 启动服务
systemctl --user start openclaw-gateway

# 检查状态
openclaw gateway status

✅ 成功输出示例：

Listening: 127.0.0.1:18789
RPC probe: ok

新手建议：WSL2 用户需要先启用 systemd。编辑 /etc/wsl.conf 添加 [boot]\nsystemd=true，然后运行 wsl --shutdown 重启 WSL。

0.4 配置 Telegram 通道

0.4.1 获取 Bot Token

在 Telegram 中搜索 @BotFather
发送 /newbot 创建新 bot
按提示设置 bot 名称和用户名
BotFather 会给你一个 Token，格式类似：123456789:ABCdefGHIjklMNOpqrsTUVwxyz

安全提示：Bot Token 相当于密码，不要泄露给他人！

0.4.2 配置 Token（二选一）

方式一：配置文件（推荐）

编辑 ~/.openclaw/openclaw.json，添加：

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "你的 BOT_TOKEN",
      dmPolicy: "pairing",  // 默认配对模式
    },
  },
}

方式二：环境变量

export TELEGRAM_BOT_TOKEN="你的 BOT_TOKEN"

然后重启 Gateway：

openclaw gateway restart

0.4.3 配对审批（重要！）

Telegram DM 默认需要配对审批，否则 bot 不会回复：

在 Telegram 中给你的 bot 发送任意消息（如 /start）
查看配对请求：
```
openclaw pairing list telegram
```
批准配对（替换 <CODE> 为上一步显示的配对码）：
```
openclaw pairing approve telegram <CODE>
```

配对码 1 小时后过期，过期后需要重新发送消息获取新配对码。

0.4.4 验证配置

openclaw channels list

✅ 成功输出示例：

telegram: your_bot_name (@your_bot)

0.4.5 开始对话

在 Telegram 中搜索你的 bot 用户名
点击"Start"或发送 /start
发送第一条消息："你好！用一句话介绍你自己"

✅ 你会看到 bot 的回复！

新手建议：把 bot 添加到群聊后，它也能在群里回答问题（需要配置权限）。

0.5 快速体验

现在你已经可以跟 OpenClaw 对话了，试试这些功能：

体验一：读文件

在 Telegram 中发送：

请读取当前目录的 README.md 文件内容

体验二：搜资料

在 Telegram 中发送：

搜索 "OpenClaw 教程"，告诉我主要讲什么

体验三：写代码

在 Telegram 中发送：

写一个 Python 斐波那契函数，要求使用递归实现

新手建议：问题描述越具体，回答质量越高。比如"写一个 Python 快速排序函数，带中文注释"比"写排序"结果更精准。

0.6 故障排除

问题	可能原因	解决方案
`npm: command not found`	Node.js 未安装	访问 https://nodejs.org 安装
`Permission denied`	权限不足	使用 `sudo npm install -g openclaw`
Gateway 启动失败	端口被占用	`openclaw gateway --force` 强制重启
Bot 不回复	Token 错误或未配置	重新运行 `openclaw channels add`
回复很慢	网络或模型问题	检查网络连接，确认 API Key 有效

常见问题自查清单

Node.js 安装了吗？ → node --version
OpenClaw 安装成功了吗？ → openclaw --version
Gateway 运行了吗？ → openclaw gateway status
Telegram 配置了吗？ → openclaw channels list
Bot 能在 Telegram 找到吗？ → 搜索 bot 用户名

自测题（3 题）

1. 安装验证命令是什么？

答案：openclaw --version

2. 前台启动 Gateway 的命令是什么？

答案：openclaw gateway

3. 配置 Telegram 通道的命令是什么？

答案：openclaw channels add --channel telegram --token "BOT_TOKEN"

✅ 你已解锁能力

能力	状态
安装 OpenClaw	✅ 已掌握
启动 Gateway	✅ 已掌握
配置 Telegram 通道	✅ 已掌握
通过 Telegram 与 AI 对话	✅ 已解锁

下一步：第 1 章，我们将学习更多通道配置和高级功能。

本文由郭峰主导，基于 GPT-5.4、OpenClaw Agent 完成，并经人工审校定稿。

课后练习（可选）

尝试让 bot 读取一个文件

尝试让 bot 搜索一个话题

尝试让 bot 写一段代码

有任何问题，随时在群里提问！ 🚀

#openclaw#tutorial#教程