360 Secure SkillHub
360 安全技能中心

Telegram Routing

这是OpenClaw配套工具,通过/telegram-routing系列命令管理Telegram消息到Claude模型后端的路由。核心功能包括:查看当前路由配置状态、切换Opus/Sonnet/Haiku等主模型、查看消息处理日志、切换到轻量API模式或恢复默认CLI路由。典型场景如主模型不可用时切换 fallback、需快速响应时切API模式、排查路由问题时查日志。输入为Telegram命令,输出为配置状态、操作结果等,配置存储在本地指定JSON文件中。

josephtandle
josephtandle
热度 53.74
最近更新 2026-05-11 17:30:03
分类:自动化依赖:读写文件 / 代码执行应用场景:DevOps / 自动化脚本

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add message-routing
Metadata
name
claude-code-switchboard
slug
message-routing
version
1.2.0
description
Manage how OpenClaw routes Telegram messages to different Claude model backends. Switch between CLI and API providers with simple config changes.
command
/telegram-routing

/telegram-routing — Telegram Message Routing Manager

Manage how Telegram messages are routed between different Claude model backends in OpenClaw.

Usage

/telegram-routing status       # Show current routing config
/telegram-routing model <ref>  # Switch primary model (e.g. opus, sonnet, haiku)
/telegram-routing logs         # Show recent message processing logs
/telegram-routing fallback     # Switch to lightweight API mode
/telegram-routing restore      # Restore default CLI-based routing

Config Location

All settings live in ~/.openclaw/openclaw.json under agents.defaults.

Key fields:

  • model.primary — The primary model/provider reference
  • model.fallbacks — Ordered fallback chain when primary is unavailable

Commands

status

Read the OpenClaw config and display current routing settings including:

  • Active primary model
  • Configured fallback models
  • Whether CLI backend is active

model

Switch the primary model. Valid shorthand references:

Shorthand Resolves to
opus claude-cli/opus
sonnet claude-cli/sonnet
haiku anthropic/claude-haiku-4-5

Steps:

  1. Read ~/.openclaw/openclaw.json
  2. Update agents.defaults.model.primary to the resolved model reference
  3. Write the updated config
  4. Restart the gateway service
  5. Verify via gateway logs

logs

Show recent Telegram message processing activity from the gateway log.

fallback

Quick switch to API-only mode for faster, lightweight responses.

restore

Restore the default CLI-based routing configuration.

Architecture

Messages flow through the OpenClaw Gateway, which reads the configured model provider and dispatches to the appropriate backend. CLI-based providers use the local Claude Code installation, while API providers make direct API calls.

Troubleshooting

Issue Fix
Config errors on restart Run openclaw doctor to validate config
Slow responses Try switching to sonnet for faster responses
Gateway issues Check ~/.openclaw/logs/gateway.log for details
Falling back to secondary model Primary backend may be unavailable — check logs