SuperAPI AI 工具集

Channels Guide

部署与运维

查看项目

更新于 10-16 08:38

技能介绍

用途:本指南说明 Research-Claw(RC)如何通过 Telegram、Discord、微信、飞书、QQ、Slack、WhatsApp 收发消息。通道属于 OC 基础设施,RC 完整复用。

主要能力与用法:仪表盘左侧边栏提供通道管理界面,位置为左侧边栏 → 扩展面板(🔗 图标)→ 通道标签。可查看各通道实时状态(已连接/已配置/错误/已禁用),用开关启用或禁用,用红色垃圾桶按钮删除,底部“添加通道”按钮会发送聊天消息请求协助,错误或未配置通道上还有“让 Agent 修复/配置”按钮。微信和 WhatsApp 点击 Connect 打开二维码弹窗扫码;不要在聊天中生成二维码。机器人令牌类通道(Telegram、Discord、飞书、QQ、Slack)通过聊天引导获取令牌,再用 config.patch 写入,或点击“让 Agent 配置”。仅 IM 场景(无仪表盘)可用 weixin_login / whatsapp_login 工具回退:先 action:"start" 返回二维码,再 action:"wait" 等待扫码,超时按 timeoutMs 设置。

配置与重启:config.patch 触发 gateway 收到 SIGUSR1,先排空活动任务(最长 90 秒)再重启并重载配置,仪表盘自动重连。启用/禁用写入 enabled 字段,删除写入 null。令牌无效会以 401 循环重启(指数退避至多 10 次后停止)。

通道内限制:回复控制在 2000 字符内,不要用 Markdown 表格,审批卡片降级为文本,媒体需绝对路径,WeChat 无法主动发送消息。

排障:检查令牌是否占位符、plugins.allow 是否含插件 ID、微信凭据路径 ~/.openclaw/openclaw-weixin/accounts/<accountId>.json、gateway 日志中的 401/ENOTFOUND/channel exited;必要时用 gateway.restart(需审批)。新通道插件需在四处同步注册。