TickFlow Assist

基于 OpenClaw 的 A 股监控与分析插件。它使用 TickFlow 获取行情与财务数据，并可选接入 金十数据 MCP 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。

最近更新：v0.3.6 修复 Telegram 告警重复补发，并修复 QQBot 图片告警路径问题，确保图文告警通过 OpenClaw 稳定送达。完整发布记录见 https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md。

当前主线按 OpenClaw v2026.3.31+ 对齐，并已验证社区安装在 v2026.4.11 上兼容。

安装前准备

在执行社区安装前，建议先确认你已经准备好以下配置：

• 核心必需：tickflowApiKey、llmApiKey、llmBaseUrl、llmModel
• 告警投递：alertChannel、alertTarget、alertAccount
• 可选增强：mxSearchApiKey、jin10ApiToken

其中，configure-openclaw 会把上述配置写入 ~/.openclaw/openclaw.json 的 plugins.entries["tickflow-assist"].config，插件启用后会在本地 databasePath 下持久化 LanceDB 数据，并运行监控 / 日更等后台服务。 如果你不想把密钥写进配置文件，运行时也支持环境变量回退，优先级是 openclaw.json / local.config.json > 环境变量 > 默认值。 常用环境变量：TICKFLOW_ASSIST_TICKFLOW_API_KEY / TICKFLOW_API_KEY、TICKFLOW_ASSIST_LLM_API_KEY / LLM_API_KEY、TICKFLOW_ASSIST_LLM_BASE_URL / LLM_BASE_URL、TICKFLOW_ASSIST_LLM_MODEL / LLM_MODEL、TICKFLOW_ASSIST_MX_SEARCH_API_KEY / MX_SEARCH_API_KEY / MX_APIKEY、TICKFLOW_ASSIST_JIN10_API_TOKEN / JIN10_API_TOKEN。 如果你希望尽量避免把密钥落盘，推荐先把这些变量写进 ~/.openclaw/.env，再运行配置向导补齐非密钥项。

安装

社区安装：

openclaw plugins install tickflow-assist
node ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js configure-openclaw
cd ~/.openclaw/extensions/tickflow-assist/python && uv sync
openclaw plugins enable tickflow-assist
openclaw config validate
openclaw gateway restart

安装阶段允许先落插件，再通过第二条命令写入 tickflowApiKey、llmApiKey、llmBaseUrl、llmModel 等正式配置。 configure-openclaw 会写入 ~/.openclaw/openclaw.json 中的 plugins.entries["tickflow-assist"].config，并打印后续建议执行的命令；它不再自动执行 openclaw、uv 或系统包安装命令，也不会重新执行插件安装；如果你已经设置了环境变量，密钥项可留空，输入 - 可主动清空已有配置并切回环境变量。 如果检测到 plugins.installs["tickflow-assist"] 来自 clawhub，向导还会把被旧版本钉死的 spec 归一化为 clawhub:tickflow-assist，避免后续升级继续锁在旧版本。

如果你希望先审阅配置，再只打印最少的后续步骤，可使用：

node ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js configure-openclaw --no-enable --no-restart

如果你在 Linux 或 macOS 上需要 PNG 告警卡正常显示中文，请额外手动安装 fontconfig 与 Noto CJK 一类中文字体，例如：

# Debian / Ubuntu
sudo apt-get update
sudo apt-get install -y fontconfig fonts-noto-cjk
fc-cache -fv

# RHEL / Fedora / Rocky / AlmaLinux
sudo dnf install -y fontconfig google-noto-sans-cjk-ttc-fonts
fc-cache -fv

# Arch / Manjaro
sudo pacman -Sy --noconfirm fontconfig noto-fonts-cjk
fc-cache -fv

# Alpine
sudo apk add fontconfig font-noto-cjk
fc-cache -fv

# macOS (Homebrew)
brew install fontconfig
brew install --cask font-noto-sans-cjk
fc-cache -fv

社区安装后的升级方式：

openclaw plugins update tickflow-assist
openclaw gateway restart

配置

插件正式运行读取：

~/.openclaw/openclaw.json

配置路径：

plugins.entries["tickflow-assist"].config

建议按完整功能显式填写以下字段，不要只填 API Key：

• 核心运行：tickflowApiKey、llmApiKey、llmBaseUrl、llmModel
• 本地数据：databasePath、calendarFile
• 告警投递：alertChannel、alertTarget、alertAccount
• 能力补充：mxSearchApiKey、jin10ApiToken

其中，mxSearchApiKey 用于 mx_search、mx_select_stock 以及非 Expert 财务链路的 lite 补充；jin10ApiToken 用于 24 小时金十数据快讯监控；jin10FlashNightAlert 默认 false（开启夜间静默），设为 true 可恢复 24 小时快讯告警；alertTarget、alertAccount 建议在准备启用 test_alert、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。 如果你使用环境变量，运行时支持以下回退：

• tickflowApiUrl：TICKFLOW_ASSIST_TICKFLOW_API_URL / TICKFLOW_API_URL
• tickflowApiKey：TICKFLOW_ASSIST_TICKFLOW_API_KEY / TICKFLOW_API_KEY
• tickflowApiKeyLevel：TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL / TICKFLOW_API_KEY_LEVEL
• llmBaseUrl：TICKFLOW_ASSIST_LLM_BASE_URL / LLM_BASE_URL
• llmApiKey：TICKFLOW_ASSIST_LLM_API_KEY / LLM_API_KEY
• llmModel：TICKFLOW_ASSIST_LLM_MODEL / LLM_MODEL
• mxSearchApiUrl：TICKFLOW_ASSIST_MX_SEARCH_API_URL / MX_SEARCH_API_URL
• mxSearchApiKey：TICKFLOW_ASSIST_MX_SEARCH_API_KEY / MX_SEARCH_API_KEY / MX_APIKEY
• jin10McpUrl：TICKFLOW_ASSIST_JIN10_MCP_URL / JIN10_MCP_URL
• jin10ApiToken：TICKFLOW_ASSIST_JIN10_API_TOKEN / JIN10_API_TOKEN

功能

• 自选股管理、日 K / 分钟 K 抓取与指标计算
• 技术面、财务面、资讯面的综合分析
• 实时监控、定时日更、收盘后复盘
• 金十数据 24 小时快讯监控与自选关联提醒
• 本地 LanceDB 数据留痕与分析结果查看

运行说明

• 插件会在本地 databasePath 下持久化 LanceDB 数据。
• 后台服务会按配置执行定时日更、实时监控与金十数据快讯监控。
• Python 子模块仅用于技术指标计算，不承担主业务流程。

依赖与可选能力

• TickFlow：提供日线、分钟线、实时行情与财务数据接口。
• 金十数据 MCP：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。
• 东方财富妙想 Skills：可选，用于 mx_search、mx_select_stock 与非 Expert 财务链路的 lite 补充。

仓库

• GitHub: robinspt/tickflow-assist