要让qclaw同时响应qq、飞书、钉钉三个平台的消息，必须在config.json的channels字段下分别为qq、feishu、dingtalk独立启用并填入对应凭证，且飞书需设置bot_prefix、钉钉需加ip白名单、qq需校验凭证格式，缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让QClaw同时响应QQ、飞书、钉钉三个平台的消息，必须在配置文件中为每个通道独立启用并填入对应凭证，缺一不可——否则某平台消息将完全无法送达，且无任何报错提示。
确认QClaw运行环境与配置入口
打开终端，执行 ps aux | grep qclaw 确认进程正在运行；若未启动，先执行 qclaw start。配置文件默认位于 ~/.qclaw/config.json，直接编辑该文件生效，无需重启服务。
【注意：不要修改 config.json 的顶层结构，只改动 channels 字段下的子项】
QQ通道配置（需提前创建机器人）
方法一：手动填写凭证
1. 登录QQ开放平台 → 创建机器人应用 → 获取 AppID 和 AppSecret
2. 在 config.json 的 "channels" 对象内新增 "qq" 字段：
"qq": { "enabled": true, "app_id": "xxx", "client_secret": "xxx" }
3. 保存文件后，QClaw会在5秒内自动重载配置。
方法二：使用CLI快速注入（推荐）
执行 qclaw channel set qq --app-id=xxx --app-secret=xxx --enable，命令会校验格式并写入 config.json。
飞书语音消息发送器。基于 Edge TTS，一键将文字转为语音发送到飞书。 使用场景： - 发送语音通知/提醒到飞书 - 文字转语音自动播报 触发词：飞书语音、语音发送、tts、文字转语音
飞书通道配置（WebSocket长连接模式）
第一步：登录飞书开放平台 → 创建企业自建应用 → 开启「机器人能力」→ 在「事件订阅」中勾选「接收消息v2.0」→ 发布版本
第二步：复制「App ID」和「App Secret」
第三步：在 config.json 中添加：
"feishu": { "enabled": true, "bot_prefix": "[FS]", "app_id": "xxx", "app_secret": "xxx" }
【bot_prefix 必须设置，否则飞书消息无法被正确路由到QClaw处理链路】
第四步：确保已安装依赖 pip install lark-oapi>=2.17.0，低版本会导致长连接握手失败且日志无明确错误。
钉钉通道配置（Stream模式接入）
进入钉钉开发者后台 → 创建「企业内部应用」→ 添加「群机器人」能力 → 消息接收模式选「Stream」→ 发布应用
复制基础信息页的 Client ID 与 Client Secret
在 config.json 的 channels 下插入：
"dingtalk": { "enabled": true, "bot_prefix": "[DT]", "client_id": "xxx", "client_secret": "xxx" }
如服务器部署在内网，需将QClaw所在机器公网IP加入钉钉应用「安全设置→IP白名单」，否则文件类消息下载会超时失败。
验证三通道是否全部激活
执行 qclaw channel list，输出应包含 qq、feishu、dingtalk 且状态均为 enabled。
分别在QQ私聊、飞书群@机器人、钉钉群@机器人发送任意文本（如“hi”），观察QClaw终端日志是否出现三条带不同前缀（[QQ]/[FS]/[DT]）的接收记录。
任一平台无日志，说明该通道配置未生效或凭证无效。
