用途 本技能用于在 Grok Bot 的持久 Linux 机器(box)中理解、安装并运行 OpenAlgo。box 由用户所有机器人共享,以 /workspace 为工作区,通过浏览器子智能体操作,并支持定时例行任务和用于机密与一次性验证码的安全聊天表单。所有流程已在 box 上以 Zerodha、Python 3.13、OpenAlgo 2.0.2.8、.env 版本 1.0.7 端到端验证。
主要能力 处理 OpenAlgo 相关问题:先读 references/openalgo-knowledge.md,再按任务打开对应参考、文档或技能。可安装/重装与启停 OpenAlgo;查询券商所需凭据与登录方式;手动连接券商(登录与安全表单输入 TOTP);为印度券商创建每日 8:00 AM IST 自动登录例行任务;升级 OpenAlgo 并设置每周日 6:00 AM IST 升级;从 Python 获取行情、历史、期权链并下沙盒订单;订阅实时行情与订单更新;用 openalgo.ta 计算指标;用 OpenScript 编写 /trading 图表策略;编写 JavaScript 图表指标;构建无代码 Flow 与 webhook 下单流程;设计多腿期权策略与风控;接入 TradingView、ChartInk、Amibroker、MCP、Telegram、WhatsApp;处理 Delta Exchange 加密符号与设置;以及修改 OpenAlgo 自身代码时按 CLAUDE.md 和相关技能执行。
使用方式与关键规则 任何 OpenAlgo 问题先读知识文件;不确定的参数、字段、限制或行为必须查仓库 docs/ 或 docs.openalgo.in(链接后加 .md),都没有则说明未记录;文档冲突时以实际运行的包为准(检查 /workspace/pyenv 中的 SDK 或仓库代码)。安装只使用 uv(uv sync、uv run、uv add),不用 pip 或裸 python。机密只通过安全表单调取,存放时 chmod 600,绝不在聊天、日志、例行任务或报告中回显。默认沙盒:先用 analyzerstatus() 读取模式,只有用户明确要求时才切到 Live 或下 Live 单。box 无静态 IP,Live API 订单会被拒绝,须提前告知。用交易者语言(Live、Sandbox,不用 paper 或 armed),不用表情符号,说明原因与下一步而非状态码。安装或启动前先检查是否已有代码检出和运行中的应用(端口 5000、8765),因为 box 为多个机器人共享。
安装与启动要点 在 /workspace/repos 克隆 openalgo,执行 uv sync --locked,复制 .sample.env 为 .env 并 chmod 600;首次启动前替换 APP_KEY、API_KEY_PEPPER、FERNET_SALT 占位符,填写券商字段与 REDIRECT_URL。API_KEY_PEPPER 与 FERNET_SALT 在账户创建后不可更改,否则用户会被锁在外面;APP_KEY 可轮换但会登出所有人。启动使用 nohup setsid script -qfec "uv run app.py" app.log,因为 flask_socketio 在没有 TTY 时拒绝运行 Werkzeug。应用监听 127.0.0.1:5000(Web)与 127.0.0.1:8765(WebSocket)。随后在浏览器打开 /setup 创建账户,在 /broker 连接券商,在 /apikey 读取 API key 并存入研究项目 .env。
券商连接与例行任务 印度券商会话每天约 3:00 AM IST 过期,因此需每日连接,8:00 AM IST 自动登录仅适用于它们;Delta Exchange 等加密券商 24/7 运行,设置 DISABLE_SESSION_EXPIRY = 'true' 与 CRYPTO_MASTER_CONTRACT_CUTOFF_TIME = '00:00',连接一次即可,不创建每日例行任务。手动模式:打开浏览器登录 OpenAlgo,进入 /broker 点击 Connect,停在券商自身登录页,让用户输入凭据与 TOTP,或通过安全表单获取一次性验证码后立即填写(30 秒有效,必要时手动点击提交)。自动模式:将 TOTP 密钥存于 box,用 pyotp 生成验证码,创建每日 8:00 AM IST 例行任务,确保应用运行、登录、连接券商、填写 TOTP、验证仪表盘并报告一行结果。使用短信或邮件 OTP 的券商(Nubra、Definedge)无法自动化,须提前说明。仅用 key 与 secret 连接的券商(XTS 系列、Groww、Samco、Dhan Sandbox、Delta Exchange)无需 TOTP。
升级与验证 每周日 6:00 AM IST 例行任务:重读 CLAUDE.md 与 upgrade/README.md,停止应用,备份 .env 与 db/ 中六个存储,git pull --ff-only,uv sync --locked,运行 migrate_all.py,合并新 .sample.env 键而不改现有值,重启并重新登录券商,验证并报告;失败则回滚到上一提交与备份并报告具体错误。不要在 box 上使用 install/update.sh(需要 sudo 与服务器布局)。完成后运行验证清单:仓库状态干净、.env 与 secrets 权限正确、占位符已替换、REDIRECT_URL 券商代码匹配、/auth/app-info 返回成功与版本、5000 与 8765 在 127.0.0.1 监听、/dashboard 显示券商已连接且主合约已加载、/api/v1/ping 返回 pong 与券商名、只读 SDK 调用(如 RELIANCE NSE 报价)成功、印度券商每日例行任务已创建并测试、加密券商无每日任务且已设置 DISABLE_SESSION_EXPIRY、每周升级例行任务已创建,并已告知用户静态 IP 限制。
适用场景与限制 适用于在 box 内进行登录、行情、历史、WebSocket 数据、/trading 图表、指标、扫描、回测、Flow 与 Python 策略的沙盒模式操作(沙盒资金 1 Crore)。限制:box 无静态 IP,出口经共享轮换的 Cloudflare 池,无法加入券商白名单;按 SEBI 静态 IP 规定(2026 年 4 月 1 日生效),从 box 发出的 Live 订单会被拒绝,实盘需在注册了静态 IP 的 VPS 上运行 OpenAlgo 并由 Grok Bot 通过 API 驱动。对白名单所有 API 调用(而非仅订单)的券商(文档提到 IIFL Capital、Tradejini、TradeSmart)可能连登录或取数都失败。常见故障包括无 TTY 导致应用退出、TOTP 页面未自动提交、创建账户后更改 pepper 或 salt 导致凭据无效、周末资金卡片显示 0.00、无静态 IP 导致 Live 订单被拒等,处理方式见原文。