OpenClaw + Telegram

概述

OmniMux 网关统一使用 Base URL：https://api.omnimux.ai（OpenAI 兼容客户端通常填 https://api.omnimux.ai/v1）。控制台为 omnimux.ai/dashboard。文中的模型 ID 仅为示例，请以控制台或 GET /v1/models 为准。

OpenClaw 是一个开源的 AI 智能体 Gateway 网关，充当聊天应用与 AI 智能体之间的桥梁。它通过一个中心化的 Gateway 进程，将 Telegram、WhatsApp、Discord 等聊天平台连接到 AI 编程智能体，实现在聊天窗口中直接与 AI 进行编程交互。通过将 OmniMux API 配置为 OpenClaw 的自定义模型提供商，并接入 Telegram Bot，你可以在 Telegram 中直接使用 OmniMux 提供的 Claude 模型（如 Claude 4.6 Opus、Claude 4.5 Sonnet、Claude 4.5 Haiku）进行 AI 辅助编程对话。 本文将介绍：

安装并配置 OpenClaw Gateway
创建 Telegram Bot 并接入 OpenClaw
将 OmniMux API 配置为自定义模型提供商
验证连接并开始使用

系统环境检查

在开始安装之前，建议先运行环境检查工具，确保你的系统满足 OpenClaw 的运行要求。

下载检查工具

从 GitHub Releases 下载对应平台的检查工具：

平台	文件名
Windows	`openclaw-checker-win-x64.exe`
macOS (Intel)	`openclaw-checker-macos-x64`
macOS (Apple Silicon)	`openclaw-checker-macos-arm64`
Linux	`openclaw-checker-linux-x64`

检查项目

工具会自动检查以下条件：

✅ Node.js 版本（需要 >= 22.12.0）
✅ npm 可用
✅ Git 可用
✅ 网络连通性（github.com、npmjs.org、omnimux.ai）

如果检查未通过，工具会给出具体的修复建议。

使用前准备

在开始配置之前，请确保已完成以下准备工作：

1. 安装 Node.js

OpenClaw 通过 npm 安装，需要先安装 Node.js 22 或更高版本。访问 Node.js 官网,下载 Windows 安装包(.msi 文件),双击运行安装程序。安装完成后,打开 PowerShell 验证:

node --version
npm --version

建议以管理员身份运行 PowerShell,避免后续安装时出现权限问题。 方式 1: 使用安装包 访问 Node.js 官网,下载 macOS 安装包(.pkg 文件),双击运行安装程序。 方式 2: 使用 Homebrew

brew install node

安装完成后,打开终端验证:

node --version
npm --version

如果后续安装时遇到权限问题,可能需要在命令前加 sudo。

2. 获取 OmniMux API Key

登录 OmniMux 控制台
在控制台中找到 API Keys，点击”创建新Key”按钮，然后复制生成的 Key
API Key 通常以 sk- 开头，请妥善保存

3. 准备一个 Telegram 账号

用于后续创建 Bot 和测试接入。

第一步：安装 OpenClaw

在终端中执行：

npm install -g openclaw@latest

第二步：初始化引导

运行新手引导命令，OpenClaw 会引导你完成初始配置并安装后台守护服务：

openclaw onboard --install-daemon

1. 确认安装

系统会提示安装风险说明，确认同意后继续：

2. 选择安装模式

系统会提示选择安装模式，选择 Quickstart 即可：

3. 选择供应商

系统会提示选择模型供应商，这里选择 跳过（Skip），后续我们会手动配置 OmniMux 作为自定义供应商：

4. 选择模型

系统会提示选择要启用的模型，选择 All（全部） 即可：

5. 选择默认模型

系统会提示选择默认模型，选择 Keep current（保持当前） 即可：

第三步：创建 Telegram Bot

引导流程会提示选择要接入的聊天渠道，选择 Telegram (Bot API)。

1. 访问 BotFather

在 Telegram 中访问 @BotFather，点击 START BOT 开始对话：

2. 创建 Bot

在对话框中输入 /start，BotFather 会返回可用命令列表：输入 /newbot，按提示设置一个唯一的 Bot 用户名，名称必须以 bot 结尾（如 my_omnimux_bot）。创建成功后，BotFather 会返回一条包含 Token 的消息，格式类似：

123456789:ABCdefGHIjklMNOpqrsTUVwxyz

复制并保存这个 Token。

3. 填入 Token

回到终端的引导流程，将复制的 Bot Token 粘贴到提示框中并确认：

4. 重启网关

Token 填入完成后，重启 Gateway 网关使配置生效：

第四步：配置 OmniMux API

1. 找到配置文件

找到 OpenClaw 安装目录下的配置文件 openclaw.json 并打开编辑：

2. 配置模型提供商

在 openclaw.json 中找到 models 字段，添加 OmniMux 作为自定义模型提供商：

"models": {
"providers": {
"omnimux-anthropic": {
"api": "anthropic-messages",
"baseUrl": "https://api.omnimux.ai",
"apiKey": "你的 OmniMux API Key",
"models": [
{ "id": "claude-fable-5", "name": "Claude Fable 5" },
{ "id": "claude-opus-5", "name": "Claude Opus 5" },
{ "id": "claude-opus-4-8", "name": "Claude Opus 4.8" },
{ "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
{ "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
{ "id": "claude-sonnet-5", "name": "Claude Sonnet 5" },
{ "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
{ "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
]
},
"omnimux-google": {
"api": "google-generative-ai",
"baseUrl": "https://api.omnimux.ai/v1beta",
"apiKey": "你的 OmniMux API Key",
"models": [
{ "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" },
{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" },
{ "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" },
{ "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
{ "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro" },
{ "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash" }
]
},
"omnimux-openai": {
"api": "openai-completions",
"baseUrl": "https://api.omnimux.ai/v1",
"apiKey": "你的 OmniMux API Key",
"models": [
{ "id": "gpt-5.4", "name": "GPT-5.4" },
{ "id": "gpt-5.2", "name": "GPT-5.2" },
{ "id": "gpt-5.1", "name": "GPT-5.1" },
{ "id": "gpt-5.1-chat", "name": "GPT-5.1 Chat" },
{ "id": "gpt-5.1-thinking", "name": "GPT-5.1 Thinking" },
{ "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro (OpenAI SDK)" },
{ "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash (OpenAI SDK)" },
{ "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro (OpenAI SDK)" },
{ "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash (OpenAI SDK)" },
{ "id": "doubao-seed-2.0-pro", "name": "Doubao Seed 2.0 Pro" },
{ "id": "doubao-seed-2.0-lite", "name": "Doubao Seed 2.0 Lite" },
{ "id": "doubao-seed-2.0-mini", "name": "Doubao Seed 2.0 Mini" },
{ "id": "doubao-seed-2.0-code", "name": "Doubao Seed 2.0 Code" },
{ "id": "kimi-k2-thinking", "name": "Kimi K2 Thinking" },
{ "id": "kimi-k2-thinking-turbo", "name": "Kimi K2 Thinking Turbo" }
]
}
}
}

将 "你的 OmniMux API Key" 替换为你在 OmniMux 控制台获取的实际 API Key。

3. 配置默认模型

在 agents 字段中配置默认使用的模型，将 model.primary 指向刚才添加的 OmniMux 模型：

"model": {
"primary": "omnimux-anthropic/claude-opus-5"
}

4. 确认 Telegram 配置

确认 channels 字段中的 Telegram 配置。botToken 已在引导流程中自动填入，无需修改：

"channels": {
"telegram": {
"enabled": true,
"botToken": "你的Bot Token（已自动填入）",
"dmPolicy": "pairing",
"groups": { "*": { "requireMention": true } }
}
}

enabled：启用 Telegram 渠道
dmPolicy：设为 "pairing"，未授权用户私聊时需通过配对码验证
groups："*" 表示允许所有群组，requireMention 为 true 表示在群组中需要 @Bot 才会响应

第五步：验证连接

1. 访问你的 Bot

在 Telegram 中搜索你刚才创建的 Bot 用户名，打开对话：

2. 获取配对码

向 Bot 发送 /start，Bot 会返回一个配对码（Pairing Code）：

3. 完成配对

新开一个终端窗口，运行以下命令完成配对：

openclaw pairing approve telegram <配对码>

将 <配对码> 替换为 Bot 返回的实际配对码，注意去掉两边的尖括号 <>。

4. 测试对话

回到原来的终端窗口，输入以下内容测试连接是否成功：

Wake up, my friend!

配对成功后，你在 Telegram 中向 Bot 发送消息也会收到 AI 回复，说明接入已完成。

概览

Coding CLI

桌面与 IDE

OpenClaw

OpenClaw + Telegram

概述

系统环境检查

下载检查工具

检查项目

使用前准备

1. 安装 Node.js

2. 获取 OmniMux API Key

3. 准备一个 Telegram 账号

第一步：安装 OpenClaw

第二步：初始化引导

1. 确认安装

2. 选择安装模式

3. 选择供应商

4. 选择模型

5. 选择默认模型

第三步：创建 Telegram Bot

1. 访问 BotFather

2. 创建 Bot

3. 填入 Token

4. 重启网关

第四步：配置 OmniMux API

1. 找到配置文件

2. 配置模型提供商

3. 配置默认模型

4. 确认 Telegram 配置

第五步：验证连接

1. 访问你的 Bot

2. 获取配对码

3. 完成配对

4. 测试对话

​概述

​系统环境检查

​下载检查工具

​检查项目

​使用前准备

​1. 安装 Node.js

​2. 获取 OmniMux API Key

​3. 准备一个 Telegram 账号

​第一步：安装 OpenClaw

​第二步：初始化引导

​1. 确认安装

​2. 选择安装模式

​3. 选择供应商

​4. 选择模型

​5. 选择默认模型

​第三步：创建 Telegram Bot

​1. 访问 BotFather

​2. 创建 Bot

​3. 填入 Token

​4. 重启网关

​第四步：配置 OmniMux API

​1. 找到配置文件

​2. 配置模型提供商

​3. 配置默认模型

​4. 确认 Telegram 配置

​第五步：验证连接

​1. 访问你的 Bot

​2. 获取配对码

​3. 完成配对

​4. 测试对话

概述

系统环境检查

下载检查工具

检查项目

使用前准备

1. 安装 Node.js

2. 获取 OmniMux API Key

3. 准备一个 Telegram 账号

第一步：安装 OpenClaw

第二步：初始化引导

1. 确认安装

2. 选择安装模式

3. 选择供应商

4. 选择模型

5. 选择默认模型

第三步：创建 Telegram Bot

1. 访问 BotFather

2. 创建 Bot

3. 填入 Token

4. 重启网关

第四步：配置 OmniMux API

1. 找到配置文件

2. 配置模型提供商

3. 配置默认模型

4. 确认 Telegram 配置

第五步：验证连接

1. 访问你的 Bot

2. 获取配对码

3. 完成配对

4. 测试对话