Documents

Twilio 语音频道配置 Twilio 频道为您提供语音通话能力，让智能体可以通过电话与用户交流。系统会自动配置 Cloudflare Tunnel 进行安全连接，您无需手动配置复杂的网络穿透。 第一步：获取 Twilio 凭证 登录 Twilio 控制台。 在主页仪表板 (Dashboard) 上找到 Account Info 区域，复制 Account SID 和 Auth Token。 进入 Phone Numbers → Manage → Active numbers，购买或选择一个现有的电话号码。 点击该电话号码进入详情页，找到 Properties 区域，复制 Phone Number SID（以 PN 开头的字符串）。 第二步：在前端页面配置 进入 前端页面 → 频道 (Channels)，找到 Twilio 卡片，点击配置： Enable：开启开关。 Twilio Account SID：填写刚才复制的 Account SID (以 …

阅读全文

MQTT 频道配置 MQTT 是一种轻量级的消息传输协议，常用于物联网设备。通过配置 MQTT 频道，TradingMate 可以与各种设备或自定义系统进行消息交互。 第一步：进入配置页面 请在前端页面中找到 频道 (Channels) 菜单，然后点击 MQTT 卡片进入配置。 第二步：填写连接信息 请根据您的 MQTT 服务器信息填写以下内容： Enable：开启开关。 Host (连接地址)：必填，例如 127.0.0.1。 Port (连接端口)：必填，例如 1883。 Transport (协议)：必填，通常填 tcp。 Username (用户名)：选填，如果您设置了账号。 Password (密码)：选填，如果您设置了密码。 第三步：配置主题 (Topic) 主题决定了消息如何发送和接收。您需要配置“订阅主题”和“推送主题”。 Subscribe Topic (订阅主题)：TradingMate 监听的消息来源。 Publish Topic (推送主题)：TradingMate 回复消息发送的目标。 配置示例 1：简单模式 最简单的配置，一对一收发。 订阅：server 推送：client 配置示例 2：智能匹配模式（推荐） 支持多设备接入，自动识别回复给谁。 订阅：server/+/up （+ 代表任意设备ID） 推送：client/{client_id}/down …

阅读全文

Mattermost 频道配置 Mattermost 频道支持私聊和群聊场景，在群聊中基于 Thread（盖楼） 划分会话上下文。 第一步：获取凭证 登录你的 Mattermost，进入 系统控制台 (System Console)。 找到 集成 (Integrations) → 机器人账号 (Bot Accounts)，创建一个新的机器人账号。 给予机器人必要的权限（例如 Post all），创建成功后，复制并保存好生成的 Access Token。 第二步：在前端页面配置 进入 前端页面 → 频道 (Channels)，找到 Mattermost 卡片，点击配置： Enable：开启开关。 URL：填写你的 Mattermost 服务器完整地址（例如 https://mattermost.example.com）。 Bot Token：填写刚才获取的 Access Token。 其他可选设置（按需调整）： Show Typing：开启后，机器人回复时会显示“正在输入…”。 Thread Follow Without Mention：开启后，在群聊的盖楼回复中，即使不 @ 机器人，它也会继续回复。 提示： 私聊和群聊的回复策略默认是全部允许 (open)。如果需要限制特定用户使用，可以在策略中选择白名单 (allowlist) 并填写允许的用户 …

阅读全文

iMessage 频道配置（仅 macOS） ⚠️ 注意： iMessage 频道只支持苹果电脑（macOS），不能在 Windows 或 Linux 上用。它需要用你电脑上的“信息”应用。 第一步：登录电脑上的“信息”应用 确保你的电脑已经登录了 Apple ID，并且能用“信息”（Messages）应用收发短信。 第二步：安装辅助工具 我们需要一个小工具来读取消息。请打开电脑上的“终端”（Terminal），复制并运行下面这行命令： brew install steipete/tap/imsg 第三步：开启权限 为了让软件能看到消息，你需要给“TradingMate” 和“信息”开启完全磁盘访问权限。 去系统设置 → 隐私与安全性 → 完全磁盘访问权限，把开关打开。 第四步：在前端页面配置 进入 前端页面 → 频道 (Channels)。 找到 iMessage 卡片。 将 Enable 开关打开。 在 DB Path 中填写数据库路径，默认通常是：~/Library/Messages/chat.db 点击 保存。 第五步：测试 配置好后，拿起你的手机，给登录了电脑 Apple ID 的账号发一条短信，看看软件有没有自动回复。

Discord 频道配置 获取 Bot Token 打开 Discord 开发者门户 新建应用（或选已有应用） 左侧进入 Bot，新建 Bot，复制 Token 下滑，给予 Bot “Message Content Intent” 和 “Send Messages” 的权限，并保存 在 OAuth2 → URL 生成器 里勾选 bot 权限，给予 Bot “Send Messages” 的权限，生成邀请链接 在浏览器中访问该链接，会自动跳转到discord页面。将 Bot 拉进你的服务器 在服务器中可以看到 Bot已被拉入 绑定 Bot 在前端页面配置： 从“控制→频道”找到Discord，点击后填入刚刚获取的Bot Token 注意： 国内网络访问 Discord API 可能需代理。如需代理，请在前端页面的 http_proxy 字段填入代理地址（例如 http://127.0.0.1:7890）。若代理需鉴权，在 http_proxy_auth 填 用户名:密码，否则留空。

Telegram 频道配置 获取 Telegram 机器人凭证 打开 Telegram 并搜索 @BotFather 添加 Bot（注意需要是官方 @BotFather，有蓝色认证标识）。 打开与 @BotFather 的聊天，根据对话中的指引创建新机器人 在对话框中创建 bot_name，复制 bot_token 绑定 Bot 在前端页面配置： 从”控制→频道”找到Telegram，点击后填入刚刚获取的Bot Token 注意： 国内网络访问 Telegram API 可能需代理。如需代理，请在前端页面的 http_proxy 字段填入代理地址（例如 http://127.0.0.1:7890）。若代理需鉴权，在 http_proxy_auth 填 用户名:密码，否则留空。 备注 目前 Telegram 白名单机制仍在施工中，推荐个人场景部署，不暴露 username 到公共环境中。 建议在 @BotFather 设置： /setprivacy -> ENABLED # 设置bot回复权限 /setjoingroups -> DISABLED # 拦截Group邀请

QQ 频道配置 获取 QQ 机器人凭证 打开 QQ 开放平台 创建 机器人应用，点击进入编辑页面 选择回调配置，首先在单聊事件中勾选C2C消息事件，再在群事件中勾选群消息事件AT事件，确认配置 选择沙箱配置中的消息列表配置项，点击添加成员，选择添加自己 在开发管理中获取AppID和AppSecret（即 ClientSecret），填入前端页面，方式见下方。在IP白名单中添加一个IP。 提示： 如果获取自己的IP地址，可在 IP地址查询 中查询。 在沙箱配置中，使用QQ扫码，将机器人添加到消息列表 在前端填写

飞书频道配置 飞书频道通过 WebSocket 长连接 接收消息，无需公网 IP 或 webhook；发送走飞书开放平台 Open API。支持文本、图片、文件收发；群聊场景下会将 chat_id、message_id 放入请求消息的 metadata，便于下游去重与群上下文识别。 创建飞书应用并获取凭证 打开 飞书开放平台，创建企业自建应用 在「凭证与基础信息」中获取 App ID、App Secret 在 前端页面 中填写上述 App ID 和 App Secret，保存 执行 退出并重启软件 启动服务 回到飞书开放平台，在「能力」中启用 机器人 选择「权限管理」中的「批量导入/导出权限」，将以下JSON代码复制进去 { “scopes”: { “tenant”: [ “aily:file:read”, “aily:file:write”, “aily:message:read”, “aily:message:write”, “corehr:file:download”, “im:chat”, “im:message”, “im:message.group_msg”, “im:message.p2p_msg:readonly”, “im:message.reactions:read”, “im:resource”, “contact:user.base:readonly” ], “user”: [] } …

阅读全文

钉钉频道配置（推荐） 创建钉钉应用 视频操作流程： 您的浏览器不支持 HTML5 video 标签。 图文操作流程： 打开 钉钉开发者后台 进入”应用开发→企业内部应用→钉钉应用→创建 应用” 在”应用能力→添加应用能力”中添加 「机器人」 配置机器人基础信息，设置消息接收模式为 Stream 模式（流式接收），点击发布 在”应用发布→版本管理与发布”中创建新版本，填写基础信息后保存 在”基础信息→凭证与基础信息”中获取： Client ID（即 AppKey） Client Secret（即 AppSecret） （可选） 将服务器 IP 加入白名单 — 调用钉钉开放平台 API（如下载用户发送的图片和文件）时需要此配置。在应用设置中进入 “安全设置→服务器出口 IP”，添加运行 CoPaw 的机器的公网 IP。可在终端执行 curl ifconfig.me 查看公网 IP。若未配置白名单，图片和文件下载将报 Forbidden.AccessDenied.IpNotInWhiteList 错误。 绑定应用 方法: 在前端配置 从“控制→频道”找到DingTalk，点击后填入刚刚获取的Client ID和Client Secret 找到创建的应用 视频操作流程： 您的浏览器不支持 HTML5 video 标签。 …

阅读全文