文档能力扩展
文档目录

远程连接

把 Proma 接进飞书、Slack、微信、钉钉,在聊天窗口里派任务;四个平台可同时启用,飞书和钉钉支持多个 Bot。

更新于 2026年11月11日

远程连接让 Proma 在聊天软件里接收任务:在群里 @ 机器人说明任务,它在本机开启会话执行,结果回到同一聊天。

页面左侧是平台栏:飞书、Slack、微信、钉钉、用法、品牌素材,默认停在飞书。四个平台各带一个状态点:灰是未连接、黄色呼吸是连接中、绿色是已连接、红色是错误。

用法

「默认项目」下拉决定机器人新建会话时落到哪个项目,说明是「通过机器人发起新会话时自动使用的项目」,改完点「保存默认配置」,成功提示「默认配置已保存」。没有任何项目时下拉不显示,改为文字「暂无项目。请先在「配置」中创建项目。」

这里的默认项目和主界面的当前项目是同一个设置项,两边改任一处都会同步。

「机器人命令」是一张只读对照表:

命令作用
/help(/h)命令帮助
/new(/n)新建会话
/list(/ls)列出会话
/stop(/s)停止当前任务
/switch(/sw)切换会话
/workspace(/ws)切换项目
/model(/m)切换本次聊天的模型
/now查看当前绑定

直接发文本会自动新建会话或发到当前绑定的会话。/model 只对该聊天生效,提示里会说明「重启应用后会恢复默认渠道设置」。

飞书

页内两个页签:「Bot 配置」「绑定管理」。

  • 列表右上「扫码创建」「手动添加」。空态是「还没有配置飞书 Bot。点击「扫码创建」一键接入,或「手动添加」用已有 App ID。」
  • 每个 Bot 一张可折叠卡,头部显示状态点、名称、App ID 前 12 位(没配时显示「未配置」)和「启动 / 停止」。
  • 展开后是「Bot 名称」「App ID」「App Secret」、「平台」下拉(飞书中国大陆 / Lark 国际版),以及「测试连接」「保存配置」「删除」。
  • 「扫码创建」会由飞书后端自动建一个应用,弹窗写明「扫码完成后 Proma 会自动保存凭证并启动 Bot,整个过程无需手动复制 App ID / Secret」。状态依次是「正在向飞书申请二维码…」、等待扫码、成功「应用创建成功」、失败「创建失败」加原因。
  • 「手动添加」是图文引导:创建自建应用、取 App ID 与 Secret、启用机器人能力、配权限(可一键复制权限配置 JSON)、配事件订阅(用长连接接收事件与回调)、发布并等审核。
  • 「同步到飞书」可以开启实时同步,一个 Proma 会话对应一个飞书群。另有两项前提:群里免 @ 续聊需要额外两个权限;手动填凭证的 Bot 要先在飞书里给它发过一条消息,否则建不了群。
  • 「绑定管理」显示「N 个活跃绑定,N 个已归档绑定」,可按活跃/已归档切换、按群名或会话搜索、按会话类型与来源筛选。每张绑定卡能给「项目」「会话」重新指认,也能归档或解绑。解绑提示「确定要解除「X」的飞书聊天绑定吗?解除后下次在飞书发消息会自动创建新绑定。」
  • 删除 Bot 的确认写明「删除 Bot "X" 将同时断开连接并清除所有绑定。此操作不可撤销。」

Slack

说明是「通过 Socket Mode 将本机 Proma 安全地接入 Slack,无需公网回调地址。」

  • 每个 Bot 需要「App 名称」(默认 Proma,不能含中文)、「复制 Manifest」、「Bot Token」「App Token」,可选 Home Channel ID。
  • 已保存的 Token 不回显,占位是「已保存;留空保留,粘贴以替换」。
  • 「测试 Token」只验证 Bot API;「保存并连接」成功后提示「Slack Bot 已保存,正在连接 Socket Mode」。
  • 频道里任意成员都能在 Bot 已加入的频道 @ 它发起任务,但「仍只响应 @mention」,不接收私信和 Slash Command。
  • 删除确认:「这会断开本机 Socket Mode 连接并删除已保存的 Token 配置。」

微信

单账号接入,没有多 Bot。

  • 无凭证时按钮是「扫码登录」;有凭证未扫码时是「启动」加「登出」;已连接时是「停止」加「登出」。
  • 状态依次可能是:未连接、等待扫码...、已扫码,确认中...、连接中...、已连接、连接错误。
  • 登录中显示二维码与「打开微信,扫描二维码登录」,扫过后改成「已扫码,请在手机上确认登录」,可「刷新二维码」。
  • 连接成功提示「微信已连接,消息将自动接收。」;凭证过期提示「微信会话已过期,请重新扫码登录」。
  • 页面说明三步:扫码登录(把一个微信账号作为 Bot 接入)、自动连接(凭证加密保存,下次启动自动重连)、收发消息(支持文本、图片、文件)。

钉钉

  • 列表右上「添加 Bot」,空态「还没有配置钉钉 Bot。点击「添加 Bot」开始。」
  • 每张卡展开后有「Bot 名称」「Client ID (AppKey)」「Client Secret (AppSecret)」,以及「测试连接」「保存配置」「删除」;名称或 Client ID 为空时不能保存。
  • 引导页提示:配事件订阅前必须先让 Stream 连上,否则钉钉后台会报「Stream 模式接入失败」。
  • 删除确认:「删除 Bot "X" 将同时断开连接。此操作不可撤销。」

首次消息与会话

外部第一次发来消息时会自动建 Proma 会话并绑定到该聊天。

  • 飞书按「显式指定 > Bot 默认 > 应用设置 > 第一个工作区」选项目;没有项目回「请先在 Proma 设置中创建项目。」,没有渠道回「请先在 Proma 设置中选择渠道。」
  • 微信、钉钉、Slack 用应用设置里的默认项目与默认渠道;缺渠道时回「请先发送一条消息创建会话,或在 Proma 设置中选择 Agent 渠道。」
  • /new 会新建会话并替换该聊天的旧绑定。

注意

  • 四个平台可以同时启用,互不干扰;每个启用的 Bot 在应用启动时自动连接,错误状态每分钟自检一次,系统唤醒或解锁后也会强制重连。
  • 群里默认必须 @ 机器人才会被处理,只有「你 + Bot」的两方群可以免 @;不属于 @ 的消息会被拒并在内部记录原因。
  • 权限确认这类交互在 Slack 里做成卡片,15 分钟不操作就失效并提示「Slack 交互已在 15 分钟后失效」;飞书侧没有接卡片回调,卡住时用 /stop 结束。
  • 实时同步到飞书群会阻止电脑休眠,长期保持会话时需要注意电量。
  • 聊天里发出的是本机任务,关掉 Proma 就收不到后续消息。
本页内容