Claude Code Switchboard
/install claude-code-switchboard
/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 \x3Cref> # 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 referencemodel.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 \x3Cref>
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:
- Read
~/.openclaw/openclaw.json - Update
agents.defaults.model.primaryto the resolved model reference - Write the updated config
- Restart the gateway service
- 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 |
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install claude-code-switchboard - 安装完成后,直接呼叫该 Skill 的名称或使用
/claude-code-switchboard触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Claude Code Switchboard 是什么?
Manage how OpenClaw routes Telegram messages to different Claude model backends. Switch between CLI and API providers with simple config changes. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 366 次。
如何安装 Claude Code Switchboard?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install claude-code-switchboard」即可一键安装,无需额外配置。
Claude Code Switchboard 是免费的吗?
是的,Claude Code Switchboard 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Claude Code Switchboard 支持哪些平台?
Claude Code Switchboard 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Claude Code Switchboard?
由 josephtandle(@josephtandle)开发并维护,当前版本 v1.2.0。