命令概述
openclaw channels 是管理 OpenClaw 消息频道的核心命令，支持频道的增删改查、状态监控和故障诊断。
查看频道列表
openclaw channels list
输出：
Channels:
telegram-main Telegram ✓ Connected Agent: default
discord-dev Discord ✓ Connected Agent: code-expert
whatsapp-cs WhatsApp ✗ Disconnected Agent: customer-svc
webchat Web Chat ✓ Active Agent: default
添加频道
交互式添加
openclaw channels add
Add New Channel
===============
Channel type:
[1] Telegram
[2] Discord
[3] WhatsApp
[4] Slack
[5] Web Chat
[6] Matrix
[7] Signal
> 1
Channel name [telegram-default]: telegram-main
Bot token: 123456:ABC-DEF...
Testing connection... ✓ Connected!
Bot name: @my_openclaw_bot
Configure webhook? [Y/n] Y
Webhook URL: https://gateway.example.com/webhook/telegram-main
Setting webhook... ✓ Done
Agent to assign [default]: default
Channel 'telegram-main' added successfully!
命令行直接添加
openclaw channels add telegram-main \
--type telegram \
--token "123456:ABC-DEF" \
--webhook-url "https://gateway.example.com/webhook/telegram-main" \
--agent default
查看频道详情
openclaw channels show telegram-main
Channel: telegram-main
Type: Telegram
Status: Connected
Agent: default
Model: gpt-4o-mini
Webhook: https://gateway.example.com/webhook/telegram-main
System Prompt: 你是一个有用的助手...
History Limit: 20
Rate Limit: 30 msg/min
Allowed Users: all
Created: 2026-03-01
Last Message: 2 minutes ago
Total Messages: 5,230
修改频道配置
# 修改使用的代理
openclaw channels set telegram-main --agent code-expert
# 修改系统提示词
openclaw channels set telegram-main --system-prompt "新的提示词"
# 修改历史记录限制
openclaw channels set telegram-main --history-limit 50
# 修改速率限制
openclaw channels set telegram-main --rate-limit 60
频道状态管理
# 暂停频道（停止处理消息）
openclaw channels pause telegram-main
# 恢复频道
openclaw channels resume telegram-main
# 重新连接
openclaw channels reconnect whatsapp-cs
删除频道
openclaw channels remove telegram-main
频道诊断
openclaw channels diagnose telegram-main
Diagnosing channel: telegram-main
✓ Configuration: valid
✓ Token: valid
✓ Webhook: configured and reachable
✓ Bot permissions: sufficient
✓ Last message: 2 minutes ago
✓ Response time: 1.2s average
频道统计
openclaw channels stats telegram-main
openclaw channels stats telegram-main --period 7d
Channel Stats: telegram-main (last 7 days)
Messages received: 1,520
Messages sent: 1,480
Avg response time: 1.8s
Unique users: 45
Error rate: 0.5%
Token usage: 250,000
用户管理
# 查看频道用户
openclaw channels users telegram-main
# 封禁用户
openclaw channels block telegram-main --user 12345678
# 解封用户
openclaw channels unblock telegram-main --user 12345678
# 设置白名单模式
openclaw channels set telegram-main --allowlist-only
openclaw channels allow telegram-main --user 12345678
批量操作
# 暂停所有频道
openclaw channels pause --all
# 恢复所有频道
openclaw channels resume --all
# 导出频道配置
openclaw channels export channels.json
# 导入频道配置
openclaw channels import channels.json
Webhook 管理
# 查看 webhook 信息
openclaw channels webhook telegram-main
# 重新设置 webhook
openclaw channels webhook telegram-main --set "https://new-url.com/webhook/telegram"
# 删除 webhook
openclaw channels webhook telegram-main --delete
总结
openclaw channels 提供了完整的频道生命周期管理能力。从添加、配置到监控和诊断，所有频道相关操作都可以通过这一组命令完成，是日常运维中使用最频繁的命令之一。