本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-im-gateway

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-im-gateway

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 微信 / WhatsApp：点击「连接（扫码）」，用手机关联设备。
• 飞书 / QQ / 钉钉 / 企业微信：点击「扫码接入机器人」，使用对应平台 App 扫码确认；也可以手动填写凭据。
• Telegram / Discord / Slack 等：按卡片中的官方文档和凭据表单完成接入。
• /cron list：查看本聊天的定时任务
• /cron rm <id>：删除定时任务

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后从哪里开始？

重启 dsh web，打开「设置 ⚙️ → 🐋 IM 网关」面板；点击任意渠道卡片即可扫码或填凭据接入，无需再次重启。微信/WhatsApp 用手机扫码关联设备，飞书/QQ/钉钉/企业微信支持官方扫码一键创建机器人，其它渠道按需填 token 即可。

不同聊天之间上下文会互相串吗？

默认「per-chat」模式下每个聊天窗口对应独立 agent 会话；可发 /new 开新会话、/sessions 列出当前工作区会话、/continue 跨会话续接，或切到 bound 模式用 /bind 绑定一个本机现有 live 会话。

怎么让某个用户能驱动 agent？

默认 allowAllUsers=true 全部放行。需要管控时在设置面板或 cordis.patch.yml 里把 allowAllUsers 改为 false，并通过「设置 → IM 网关 → 待授权请求」一键批准新用户，或在 allowedUserIds 配置按渠道白名单。

工具需要批准时怎么应答？

agent 触发工具批准时会把请求推送到对应聊天，直接回复「批准/拒绝/yes/no/同意」即可；超过 approvalTimeoutSecs（默认 120 秒）会自动回退到本机批准体系。

手机端怎么把长消息分多次发？

在 IM 里逐段发送，结尾加「..」表示还没说完，5 秒合并窗口内（可调 mergeTimeoutSecs）会拼成一段发往 agent；想立即提交就以「!!」结尾，崩溃或断网后未发送的缓冲区也能恢复。

微信聊天登录态会丢吗？

微信 iLink 登录态（bot_token）会持久化到 $DSH_HOME/dsh-im-gateway/wechat-state.json，重启后自动跳过扫码直接轮询；只有连续 3 次 token 失效才会清除登录态要求重新扫码，建议使用专用小号。

定时提醒是绑在聊天还是会话上？

绑在聊天（chatId）上，与会话轮换无关。在聊天里说「每天 9 点提醒我喝水」，agent 会创建 im_cron 任务；即使 /new 切换会话，定时也会按时推回同一个聊天，支持一次性/每天/按星期与 IANA 时区。

可以中途撤回某个渠道的连接吗？

「断开」只是停止运行态并保留配置，重启 dsh 后会自动恢复；「删除配置」才会清空凭据与白名单，之后需要重新接入。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则