跳到主要内容
AI教程

设置并使用支持 Discord 和 Telegram 的 NinjaTrader 机器人

本教程介绍如何在 Windows 上安装 NinjaTrader 机器人，了解其分层配置，使用 Discord 或 Telegram 命令，启用模拟模式，管理配置文件，查看日志，诊断问题，并在自定义自动化交易流程前备份设置。

AI我搜编辑部阅读约 10 分钟
设置并使用支持 Discord 和 Telegram 的 NinjaTrader 机器人

NinjaTrader Bot 的功能

NinjaTrader Bot 是一款由社区驱动的独立 Windows 应用，旨在通过 Discord 或 Telegram 配合 NinjaTrader 工作流使用。它提供聊天命令，用于查看状态、管理配置、检查日志、切换偏好设置、诊断问题以及维护备份。

NinjaTrader Bot 项目预览

该软件包无需单独的依赖链或后台服务即可运行。其策略模块、自动化钩子、通知、交易日志记录及其他功能均已预配置；同时，清晰易读的设置可让你根据交易品种、时间安排和风险规则调整机器人。

自动交易存在财务风险。在实时环境中启用自动信号执行前，请检查每项设置，先使用模拟模式，并确认风险限额。

主要功能

  • 独立桌面版本：自包含的 Windows x64 软件包集成了所需组件，据称大小约为 1.6 GB。
  • 预配置功能：各项功能开箱即用并已完成组织；README 未说明需要单独激活或许可步骤。
  • 分层配置：全局默认设置、用户配置文件和临时会话覆盖设置彼此分离，让日常定制不会影响随软件提供的设置。
  • 独立功能开关：可分别控制策略引擎、通知中继、交易日志记录和模拟模式。
  • 验证：启动检查会在交易开始前识别语法错误、可疑的数值范围和冲突的依赖项。
  • 热重载：活动配置文件保存后可以重新加载，/reload 则提供了显式重新读取配置的方式。
  • 维护工具：相关命令可查看健康状态详情、近期日志、诊断信息、版本、备份及恢复选项。
  • 可移植配置文件：命名配置文件可以备份、共享，并用于不同策略或会话。

要求与准备

安装机器人前，请确认计算机满足文档列出的要求：

  • Windows 10 或 Windows 11，运行于 x64 桌面环境
  • PowerShell 5.1 或更高版本；项目还特别强调 PowerShell 7+
  • 可下载安装脚本和软件包的互联网连接
  • 标准 Windows 用户账户
  • 如果希望通过这些聊天平台操作机器人，则需要 Discord 或 Telegram 访问权限

README 表示，核心软件包安装后可以在本地离线运行，但下载、更新和社区支持仍需要网络连接。文档未介绍详细的 Discord 或 Telegram 凭据创建流程，因此如需特定平台的连接步骤，请查阅项目当前的帮助文档和发布材料。

安装机器人

该仓库通过其安装程序页面提供 PowerShell 安装程序。README 未提供明确的 PowerShell 命令、软件包校验和或详细安装记录，因此请避免复制无关来源中的命令。

  1. 打开仓库，查看当前文件、问题、发布信息和安装程序目标位置。
  2. 确认安装程序来源就是项目链接指向的来源。运行下载的 PowerShell 脚本前，请先检查脚本内容。
  3. 在 Windows 10 或 Windows 11 计算机上使用文档所述的 PowerShell 安装程序。
  4. 将解压后的独立版本保存在专用文件夹中。如果要在多台计算机上安装，请为每个副本使用不同文件夹，以免配置冲突。
  5. 以标准用户身份启动可执行文件。机器人首次运行时，应在可执行文件旁创建初始配置。
  6. 继续操作前阅读所有验证消息。对于报告的语法、范围或依赖问题，应进行修正，不要绕过检查。

由于可执行安装程序和交易软件涉及安全风险，请使用安全工具扫描下载内容，在执行前检查脚本，并先在隔离环境或非生产环境中测试应用程序。

配置首次运行

使用纯文本编辑器打开生成的配置。初始文件包含带注释的部分和保守的默认值。在将配置连接到真实工作流前，请重点检查以下四个方面。

1. 标识设置

将账户和会话备注设置为易于识别的标签。维护多个配置文件或安装实例时，这一点尤其有用。

2. 定义观察列表

仅添加你打算监控或交易的品种代码。根据 README，未列入观察列表的品种将不会被处理。

3. 检查订单默认值

检查默认数量、订单类型和有效期。不要假设软件提供的值适合你的账户、品种或策略。

4. 建立风险护栏

检查每日亏损上限、最大持仓数量和单笔交易限额。除非你明确修改，这些保护措施将保持启用。

README 未公布配置文件的确切语法或键名。请保留生成文件现有的格式和注释，不要自行创建新键。保存编辑内容后，等待配置文件监视器应用更改，或运行 /reload。首次设置时，重启机器人也会触发启动验证。

了解配置优先级

机器人按三个层级解析设置，后面的层级会覆盖前面的层级：

  1. 全局默认值：随构建版本提供的稳定设置。
  2. 用户配置文件：可备份或迁移的持久个人覆盖设置。
  3. 会话覆盖设置：单次运行期间用于实验的临时值。

例如，保留保守的全局默认值，将常用的自选列表和限制存储在用户配置文件中，并使用会话覆盖设置进行临时的模拟交易测试。这样可以避免短期实验覆盖长期配置文件。

从模拟模式开始

在考虑实时自动化之前，请启用模拟模式，并针对模拟成交测试完整工作流。在配置文件通过验证并完成对机器人行为的检查之前，请保持策略引擎禁用。

  1. 使用生成配置中已有的切换开关启用模拟模式。
  2. 确认任何实时交易标志均已禁用。机器人应拒绝相互冲突的模拟和实时设置。
  3. 启用交易日志记录，以便将操作记录在本地供审查。
  4. 如果希望将关键事件发送到选定的聊天界面，请配置通知中继。
  5. 保存配置文件并运行 /reload。
  6. 使用 /diagnose、/status 和 /features 验证最终状态。

使用核心命令

命令采用斜杠命令格式。请从以下基本序列开始：

/start
/status
/features
/config
/diagnose
/ping
/help
  • /start 显示欢迎卡片，其中包含当前配置文件、已启用模块和入门指南。
  • /status 报告连接状态、运行时间、已加载功能以及独立构建版本。
  • /features 对当前构建中启用的功能进行分组并列出。
  • /config 汇总已加载的配置。该命令也可以接受键名，但 README 未指定确切的参数语法。
  • /diagnose 检查机器人的各个子系统，并返回易于理解的报告。
  • /ping 执行简短的往返连接检查。
  • /help 为已安装的构建版本生成命令列表。传入命令名称可查看其详细用法和可用选项。

由于支持的参数可能因版本而异，请依赖 /help，不要假定选项名称。机器人旨在解释缺少的权限，并返回易读的消息，而不是原始数据转储。

应用并检查配置更改

编辑配置文件后，请使用以下工作流：

/reload
/config
/status
/logs
/diagnose

/reload 会重新读取配置，无需完全重启，并报告发生的更改。/config 会在应用所有层级后确认生效设置。随后使用 /status 和 /diagnose 验证运行状况，再检查 /logs 查看近期活动。

日志命令接受数量选项和用于筛选警告或错误的严重性过滤器，但 README 未提供它们的具体语法。在已安装的构建版本中运行 /help logs，以获取有效示例。

管理配置文件和通知

使用 /profile 查看或调整显示名称、默认计划和通知样式等个人偏好设置。更改会立即生效，并在会话之间持久保存。在不同日期运行不同策略时，使用命名配置文件会很有帮助。

社区公告为可选功能：

/subscribe
/unsubscribe

/subscribe 启用项目更新和发行说明通知，而 /unsubscribe 会将其禁用。

安全地备份和恢复

机器人会在进行结构性更改前自动保存上一份配置的快照。你也可以明确管理快照：

/backup
/restore

/backup 创建带时间戳的配置快照，并报告其位置。/restore 会先列出可用备份，然后要求你选择一个。在更改风险规则、启用自动化，或用其他用户提供的配置文件替换当前配置文件之前，请先创建手动备份。

高级提示

使用覆盖设置进行实验

将临时测试放在会话层，而不是修改用户配置文件。会话结束后，你的持久配置仍会保持不变。

保持安装相互隔离

在多台计算机上部署便携版，或在同一系统上保留多个副本时，请将每个副本存放在单独的文件夹中。这样可以避免意外共享或覆盖相邻的配置文件。

验证共享配置文件

配置文件被描述为自包含且可移植，但你仍应检查导入的每个自选列表、订单默认值、功能开关和风险限制。在使用社区配置文件之前，请先在模拟模式下运行验证。

检查已安装的版本

运行 /version，以显示确切的构建标识符、发布渠道和验证日期。报告问题时请附上这些信息，以便其他用户比较相同的构建版本。

收集有用的故障排除证据

如果机器人行为异常，请按以下顺序收集信息：

/status
/diagnose
/logs
/version

保留完整的错误消息和相关日志摘录。在提交重复报告之前，请搜索现有的项目讨论；公开分享日志前，请删除账户详情或其他敏感信息。

使用反馈和社区支持

/feedback 命令用于向维护者提交错误报告、创意或一般意见。README 还鼓励用户通过项目的 Discord 或 Telegram 社区提交 issue、拉取请求、文档改进建议和测试反馈，并参与讨论。

命令参考

  • /start — 打开欢迎卡片并开始初始导览。
  • /status — 查看运行状况、连接状态、运行时间、功能和构建信息。
  • /features — 按类别列出已启用的功能。
  • /config — 查看所有生效的设置，或检查某一项设置。
  • /reload — 从磁盘重新加载配置。
  • /profile — 管理个人偏好和个人资料相关设置。
  • /subscribe — 接收社区更新和发行说明。
  • /unsubscribe — 停止接收社区更新通知。
  • /logs — 获取近期活动记录，可选设置数量和严重级别。
  • /diagnose — 执行子系统检查。
  • /backup — 创建带时间戳的配置快照。
  • /restore — 选择并恢复可用的快照。
  • /version — 显示构建标识符、频道和验证日期。
  • /ping — 测试往返通信。
  • /feedback — 向维护者发送反馈。
  • /help — 显示当前命令文档和选项。

结语

NinjaTrader Bot 将独立的 Windows 软件包与基于聊天的管理、分层配置文件、配置验证、诊断和备份工具结合起来。仅从已验证的来源安装，先使用保守设置和模拟模式，并将 /help 作为已安装构建版本的权威参考。启用或更改自动化功能前，请备份每个重要的配置文件。