文档

文档

modelriver listen

通过 WebSocket 接收 Webhook 事件：无需公网 URL 或 ngrok。类似于专门用于 AI 工作流的 `stripe listen`。

概述

listen 命令通过 WebSocket 连接到 ModelRiver，并实时接收 Webhook 事件。与需要公开访问 URL 的传统 Webhooks 不同，这种方法完全通过 WebSocket 进行：无需 ngrok，无需公网 URL，无需防火墙配置。

使用方法

Bash
# 开始监听 Webhooks（类似于 `stripe listen`）
modelriver listen --print
 
# 转发到本地服务器
modelriver listen --port 3001 --print
 
# 使用自定义 API 密钥
modelriver listen --api-key mr_live_YOUR_KEY --print
 
# 转发到外部服务器（不启动本地服务器）
modelriver listen --port 3002 --forward --print

工作原理

  1. 使用您的 API 密钥进行身份验证
  2. 获取安全的 WebSocket 令牌（有效期 24 小时）
  3. 通过 WebSocket 连接到 ModelRiver
  4. 实时接收 Webhook 事件：无需公网 URL 或 ngrok！
  5. （可选）转发到本地服务器

输出示例

✓ 正在连接 ModelRiver...
✓ WebSocket 已连接
✓ 已加入 Webhook 频道
 
> 就绪！正在监听 Webhook 事件
> 用户 ID: user-id-123
> 频道: cli_webhooks:user-id-123
> 本地端口: 3001
 
> 按 Ctrl+C 停止
 
[2026-01-07 15:20:30] 通过 WebSocket 收到 Webhook：
频道 ID: abc-123-def
状态: success
数据: {"result": "..."}

选项说明

选项描述
--print将收到的 Webhooks 打印到控制台
--port <number>设置转发到的本地服务器端口
--forward启用转发到本地服务器
--api-key <key>指定 ModelRiver API 密钥
--verbose显示详细日志

下一步