远程连接
把 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 就收不到后续消息。