OpenClaw 初阶教程：从 0 到 1 搭建 Telegram AI 助手（2026）

OpenClaw 初阶教程封面

如果你想把 AI 助手放进 Telegram/Discord 里用，而不是每次都开网页，这篇就是给你的。本文按「准备 → 安装 → 配置 → 排错 → 安全」顺序写，新手照着做基本都能跑通。

OpenClaw 是什么？适合谁用？#

OpenClaw 可以理解为一个本地运行的 AI 网关：

你的设备运行 Gateway（中转服务）
Gateway 连接聊天平台（Telegram/Discord/WhatsApp）
Gateway 再连接大模型（GPT/Claude/DeepSeek 等）
你在聊天软件发消息，Gateway 转给模型并返回结果

它适合：

希望在聊天软件里随时调用 AI 的用户
不想频繁切换多个 AI 网页/客户端的人
想保留本地配置和可控工作流的进阶用户

先看基础
如果你是纯新手，建议先补一下 what-is-proxy，再继续本文。

开始前准备（务必先做）#

1）系统与运行环境#

macOS：体验最好，原生支持
Windows：建议使用 WSL2 + Ubuntu 22.04（可参考 WSL 将 Ubuntu 换成 Debian 的操作思路）
Linux：可直接安装

如果打算 24 小时在线，可选低功耗设备（如 Mac mini）或 VPS。

2）模型 API 准备#

OpenClaw 本身不是模型，它需要你接入模型提供商。新手建议：

先用按量计费方案（如 OpenRouter / AI/ML API）快速试错
稳定使用后再考虑订阅型方案
不建议一上来就用不稳定中转，排错成本高

3）网络环境检查（关键）#

Telegram/Discord 需要可用代理环境。常见客户端可参考：

终端快速验证：

1
curl -I https://api.telegram.org

返回 200 或 301/302 通常说明链路可达。

安装 OpenClaw（按顺序执行）#

Step 1：安装 Node.js（要求 >= 22）#

1
node --version
2
npm --version

如果版本低于 22，请先升级 Node.js。

Step 2：安装 OpenClaw#

推荐官方安装脚本：

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

安装后验证：

1
openclaw --version

Step 3：初始化并安装守护进程#

1
openclaw onboard --install-daemon

--install-daemon 表示后台常驻运行，重启后可自动恢复。

首次配置流程（最容易卡住的部分）#

1）选择模型提供商#

已有官方账号：按向导授权
使用第三方 API：先选 Skip，稍后手动配置

2）选择聊天平台#

新手建议先接 Telegram（Bot API）：

配置简单，出错面较小
Bot 管理成熟，验证流程清晰

如果你还没有 Telegram 账号，可先看 Telegram 注册使用教程。

3）创建 Telegram Bot#

在 Telegram 中搜索 @BotFather，依次执行：

/start
/newbot
设置 Bot 名称
设置用户名（必须以 _bot 结尾）

随后会得到 Token（例如 123456:xxxx），粘贴回 OpenClaw 向导即可。

4）完成引导并确认启动#

正常情况下会看到类似输出：

1
Gateway started on http://127.0.0.1:18789
2
Telegram channel connected
3
Ready to chat

配置第三方模型（以 OpenRouter 为例）#

方式 A：Web UI（推荐）#

访问：http://127.0.0.1:18789

路径：Settings -> Models -> Add Provider

填写：

Provider Name：openrouter
Base URL：https://openrouter.ai/api/v1
API Key：你的密钥
Model ID：如 anthropic/claude-opus-4

方式 B：直接改配置文件#

1
nano ~/.openclaw/openclaw.json

示例（按你自己的 key 与模型替换）：

1
{
2
  "models": {
3
    "providers": {
4
      "openrouter": {
5
        "baseUrl": "https://openrouter.ai/api/v1",
6
        "apiKey": "your-api-key-here",
7
        "api": "openai-completions",
8
        "models": [
9
          {
10
            "id": "anthropic/claude-opus-4",
11
            "name": "Claude Opus 4",
12
            "reasoning": true
13
          }
14
        ]
15
      }
16
    }
17
  },
18
  "agents": {
19
    "defaults": {
20
      "model": {
21
        "primary": "openrouter/anthropic/claude-opus-4"
22
      }
23
    }
24
  }
25
}

重启服务：

1
openclaw restart

代理设置（Bot 不回消息时先看这里）#

先确认本地代理端口（如 7890/7891），再设置环境变量：

1
# zsh
2
nano ~/.zshrc
3

4
# bash
5
nano ~/.bashrc

追加：

1
export http_proxy=http://127.0.0.1:7890
2
export https_proxy=http://127.0.0.1:7890
3
export all_proxy=socks5://127.0.0.1:7891

生效并重启：

1
source ~/.zshrc   # 或 source ~/.bashrc
2
openclaw restart

如果你代理本身还不稳定，建议先按 how-to-proxy-on-pc 或 how-to-proxy-on-mobile 把基础链路跑通。

常见问题排查（先执行这三步）#

1）Bot 不回消息#

1
openclaw status
2
openclaw logs --tail 50
3
openclaw agent --message "测试" --thinking high

ECONNREFUSED / timeout：通常是网络或代理问题
401 Unauthorized：API Key 错误或失效
rate limit：额度不足或触发限流

2）端口占用（18789）#

1
lsof -i :18789
2
kill -9 YOUR_PID
3
openclaw restart

3）Telegram 配对失败#

1
openclaw pairing list
2
openclaw pairing approve telegram YOUR_TELEGRAM_USER_ID

User ID 可通过 Telegram 的 @userinfobot 获取。

安全加固（强烈建议）#

OpenClaw 能力很强，安全配置不能省：

在模型提供商后台设置每日/每月预算上限
对高风险工具启用审批（如 exec、email）
Gateway 保持本地监听（127.0.0.1），不要改成 0.0.0.0

审批示例：

1
{
2
  "tools": {
3
    "exec": {
4
      "enabled": true,
5
      "approvalRequired": true
6
    },
7
    "email": {
8
      "enabled": true,
9
      "approvalRequired": true
10
    }
11
  }
12
}

成本建议（新手版）#

轻度尝鲜：按量 API + 本地设备，优先验证可用性
稳定使用：按月评估成本后再升级模型档位
不建议：在未跑通流程前直接年付或重投入

先跑通再优化，是最省钱的路径。

本站相关文章（建议收藏）#

写在最后#

OpenClaw 的价值，在于把 AI 使用场景从「打开网页」变成「在聊天软件里直接工作」。

如果你第一次配置没成功，优先检查三件事：代理是否可用、API Key 是否有效、日志是否有明确报错。按本文顺序排查，基本都能定位问题。