clawock

harness · HK + US portfolio

Command reference / 命令参考

This file has two halves. The inventory below is generated by ops/ci/generate_tool_reference.py from the clawock distribution’s two command registries (clawock.cli.PACKAGED_UTILITIES and the root [project.scripts]) and the classification in config/information-layers.json, so a command that is added, renamed or removed changes it without anyone editing this page. Everything after it is hand-written, and covers what a registry cannot hold: flag tables, SEC’s rate limit, which key each provider needs, and how the cron harness fits together.

上半部分是生成的完整清单（新增/删除命令自动反映，禁止手改）；下半部分是手写细节， 从根目录 TOOLS.md 外移（TOOLS.md 受 openclaw 16K bootstrap 注入上限约束）， TOOLS.md 只留精简索引 + 路由。

Installed commands / 已安装命令

86 commands are installed by the single clawock distribution: 11 lifecycle subcommands built in src/clawock/cli.py, 63 packaged clawock <utility> subcommands and 12 standalone scripts. clawock --help offers the first two groups (74 subcommands). 47 of the registry commands collect or compute information and appear under the layer they feed; the remaining 28 publish, gate, record or schedule, and are listed with the reason they are not collection.

本节由生成器从 clawock.cli.build_parser()、两份 registry 与 config/information-layers.json 推导，不手写；新增或删除一条命令，这张表自己会变。

Lifecycle subcommands / 生命周期子命令

Workspace, run and harness lifecycle commands; details are in the hand-written sections below.

Command What it does
clawock init create a standalone clawock workspace
clawock run certify and publish one external decision-workflow run
clawock doctor audit portfolio and registry prerequisites
clawock calendar check whether an HK or US market session is open
clawock profile validate and describe a declarative runtime profile
clawock report assemble and validate a market report from a context file
clawock brief run brief harness in-process
clawock intraday run intraday harness in-process
clawock tool call a context tool through the registry
clawock context audit, assemble, compare or verify the agent context contract
clawock workflow discover or install portable decision-workflow skills

Layer 1 · Market / 行情

Sources: Tencent · Yahoo · Eastmoney · Polygon · Nasdaq

Command Module What it collects or computes
clawock analyze-hk clawock.market_data.hk_analysis HK holdings: Tencent + Eastmoney dual-source reconciliation, stooq/yfinance fallback (the yfinance hop needs clawock[market])
clawock analyze-us clawock.market_data.us_analysis US holdings: price refresh plus RSI/MA and news-derived signals
clawock us-quotes clawock.market_data.us_quotes multi-provider US quote fetcher, seven-route fallback (the yfinance hop needs clawock[market])
clawock fetch-peers clawock.market_data.peer_quotes current price and 5-day P&L for peer tickers
clawock daily-bars clawock.market_data.bars canonical unadjusted daily OHLC store the ledger settles against
clawock benchmark clawock.market_data.benchmarks SPY / HSI / HSTECH daily-close history for the equity-curve overlay
clawock-gold-fetch clawock.market_data.gold.fetch daily NAV for the 000217 gold DCA position from the Eastmoney fund API
clawock discover-stocks clawock.market_data.stock_discovery free Nasdaq US-listed snapshot, sector-diverse research candidates outside held exposures; time unverified, no trade authority

Layer 2 · Fundamentals & filings / 基本面/申报

Sources: SEC EDGAR · Eastmoney datacenter · HKEX

Command Module What it collects or computes
clawock filings clawock.market_data.filings 10-K/10-Q/8-K, XBRL concepts, Form 4, 13F-HR
clawock fundamentals clawock.market_data.fundamentals Eastmoney datacenter fundamentals for US and HK names
clawock earnings clawock.decision.earnings primary-source earnings review and earnings-quality math

Layer 3 · Capital flow / 资金面

Sources: Eastmoney push2his

Command Module What it collects or computes
clawock fundflow clawock.market_data.fund_flows daily fund-flow series for US and HK names

Layer 4 · News & catalysts (bilingual) / 消息面与催化剂(双语)

Sources: Eastmoney · Finnhub · Google News · Yahoo · 10jqka · exchange filings

Command Module What it collects or computes
clawock em-news clawock.market_data.eastmoney_news Chinese-language Eastmoney news for active HK holdings
clawock catalysts clawock.market_data.calendar next 14 days of earnings, FOMC and macro events
clawock mover-evidence clawock.market_data.mover_evidence filing-first catalyst probe, fired only for names that already moved
clawock live-sources clawock.evidence.live_sources live free news and disclosures (HKEXnews, EDGAR full-text, Google News, Yahoo RSS, 同花顺 7x24, 东财 7x24) for any harness, budgeted and timed
clawock news-evidence clawock.evidence.news_evidence_graph deduplicates news and filings into an expiring evidence graph with confirmation gates
clawock-news-digest clawock.automation.news_digest US 21:00 digest; Finnhub with a Google News RSS fallback per ticker

Layer 5 · Macro & sentiment / 宏观/情绪

Sources: Yahoo · Reddit · CNN · social feeds

Command Module What it collects or computes
clawock macro clawock.market_data.macro VIX, 10Y, DXY, Fear & Greed, Federal Reserve releases
clawock sentiment clawock.market_data.sentiment Reddit search RSS and Google News scan per active holding
clawock-influencer-scan clawock.automation.influencer market-moving statements from high-impact figures, read from primary feeds

Layer 6 · Quant & risk / 量化与风险

Sources: deterministic math over price history

Command Module What it collects or computes
clawock quant clawock.decision.signals standard factor layer over held names, zero LLM opinion
clawock quant-review clawock.decision.signal_review measures each factor’s own hit rate before it may be quoted
clawock cross-factor clawock.market_data.factors point-in-time, sector-neutral cross-sectional ranking over a curated universe
clawock peer-residual clawock.market_data.peer_residuals curated-peer residual alpha, leadership and diffusion
clawock t0 clawock.decision.setups T+0 setup grading — card quality, not a buy signal
clawock t0-review clawock.decision.setup_review edge self-check that decides whether the grading may be used
clawock portfolio-risk clawock.portfolio.risk beta, volatility, drawdown and concentration per book
clawock regime clawock.decision.regime the leverage dial: 200-day trend × volatility
clawock watch-list clawock.decision.watch_list non-held AI watch names price scan — opportunities only, never an add

Layer 7 · Book & FX integrity / 账本/汇率校验

Sources: Frankfurter · the reconciliation ledger · local invariants

Command Module What it collects or computes
clawock fx clawock.portfolio.fx USDHKD with three-route fallback; HK and US totals may not be summed without it
clawock integrity clawock.portfolio.integrity the data-health gate that turns past numeric bugs into an automatic door
clawock reconcile clawock.portfolio.reconcile recompute every derived money field, then run the integrity gate
clawock aggregates clawock.portfolio.aggregates rebuild each derived portfolio field from ledger leaves
clawock cash clawock.portfolio.cash derive each book’s cash from its reconciliation ledger
clawock realized clawock.portfolio.realized single source of truth for realized P&L, summed from trades

Layer 8 · Backtest & calibration / 回测/自省

Sources: local snapshots + canonical bars

Command Module What it collects or computes
clawock evaluate-hstech-regime clawock.evaluation.hstech_regime the regime de-risking thesis, tested on real HSTECH data
clawock evaluate-us-leverage clawock.evaluation.us_leverage the regime indicators on the US 2x sleeve; the 生产三档 row replays production’s ok/watch/cut dial; needs clawock[evaluation]
clawock evaluate-combined-regime clawock.evaluation.combined_regime the whole book at current USD weights; needs clawock[evaluation]
clawock validate-regime-dial clawock.evaluation.regime_validation out-of-sample and circular-shift null for the dial’s timing
clawock validate-regime-hmm clawock.evaluation.regime_hmm posterior regimes with a duration, scored on the dial’s own circular-shift null
clawock shadow clawock.decision.shadow replays triggered calls against buy-and-hold to measure simulated timing alpha, gross and net of the pre-registered cost model
clawock decision-audit clawock.decision.audit absolute and broad-market-relative direction scores with exact-window coverage
clawock audit-resettle clawock.decision.settlement dry-run bar-based re-settle that reports every verdict it would change
clawock evaluate-add-alpha clawock.evaluation.add_alpha_walkforward point-in-time diagnostic replay of price-relative and information interaction adds
clawock evaluate-methods clawock.decision.method_evaluation method payoff and probability reports; frozen prospective three-arm shadow trials
clawock evaluate-add-shapes clawock.evaluation.add_shapes descriptive pass over the bar store: what each add-side entry shape has been worth against the unconditional baseline; not walk-forward

Not information collection / 不属于信息收集

These are installed commands too. They are listed here so the catalog is the whole installation rather than the interesting part of it.

Command Module Why it is not collection
clawock cron-trigger clawock.automation.cron_trigger fires a host-triggered OpenClaw cron job; it collects nothing and decides nothing
clawock dashboard-build clawock.publish.dashboard publishes the dashboard projection from data the layers already produced
clawock decision-map clawock.publish.decision_map joins decisions to signal histories the layers already collected and publishes the projection; it acquires nothing and decides nothing
clawock dashboard-outputs clawock.publish.outputs publication ownership and semantic diffs for generated write sets
clawock validate-sidecar clawock.publish.artifacts behavioral validation of a publication artifact; gif and screenshots decode images and need the imaging extra (pip install ‘clawock[imaging]’)
clawock evidence clawock.evidence.build_evidence renders the public evidence page from artifacts; it collects nothing
clawock run-card clawock.evidence.run_card records that a backtest ran and against what — provenance, not a measurement
clawock claim-provenance clawock.evidence.claim_provenance gate: a quoted backtest number must still be in the card it cites
clawock signal-panel clawock.evaluation.signal_panel measures registered signal histories that other layers already collected, and never feeds a decision — evaluation, not collection
clawock strategy-lab clawock.strategy_lab.lab mounts the strategy plugins in config/strategy-plugins.json and walks a declared parameter grid forward over adjusted daily bars; it prints a proposal that never carries live permission and records each verdict in its own ledger — evaluation, not collection
clawock scorecard-provenance clawock.evidence.scorecard_verify names the ledger slice and code a published scorecard number came from — provenance, not a measurement
clawock provenance clawock.provenance gate: a published research figure needs two independent sources
clawock mark-followed clawock.decision.execution writes execution ground truth into the decision ledger
clawock record clawock.decision.record appends a conversation verdict to the decision-mind ledger — it records a decision that was already made, and collects nothing
clawock risk clawock.decision.risk durable governance ledger for breaches — a record of decisions, not an input to one
clawock thesis clawock.decision.theses registry the model writes and reads back; its content is authored, not fetched
clawock entry-gate clawock.decision.entry pre-investment gate applied to a candidate, after the information exists
clawock plan-context clawock.decision.plans relays what the 08:03 brief already decided to the crons that run after it
clawock research clawock.evidence.research_surface the brief does read it, but as a work queue — reviews due, overdue promises, ungated positions — not as a measurement of the market or the book
clawock-gold-update clawock.market_data.gold.update operator command that amends the gold DCA baseline; it carries human input into the book rather than measuring it
clawock-weekly-review clawock.automation.weekly_review assembles a weekly review artifact out of records the layers already produced
clawock-workflow-outcomes clawock.automation.workflow_outcomes durable per-slot outcome state for the harness; operational, not market or book
clawock-cron-heartbeat clawock.automation.cron_heartbeat publishes the intraday heartbeat ledger — liveness, not evidence
clawock-brief-fallback clawock.automation.brief_fallback off-host delivery path for the brief when the runtime cannot produce it
clawock-intraday-delta clawock.harness.intraday_delta pre-model trigger state: it decides whether a run happens, and the scheduler is its only reader
clawock-brief-watchdog clawock.harness.brief_watchdog delivery watchdog for the 08:03 brief: it checks that a run produced and sent something
clawock-report-watchdog clawock.harness.report_watchdog delivery watchdog for the session reports, on the same footing
clawock-intraday-watchdog clawock.harness.intraday_watchdog delivery watchdog for the intraday slots, on the same footing

手写细节 / Hand-written detail

核心（当前在用）

数据 用法
最近 filings (10-K/10-Q/8-K) clawock filings RKLB （--filings 10-K,10-Q 指定表型）
XBRL 关键财务概念（营收/净利/现金/EPS 等关键概念） --financials
Insider Form 4 / 13F-HR --form4 / --13f
机器可读 任一模式加 --json

注意：速率限制 10 req/sec（脚本默认 8/sec）超量 403；SEC_USER_AGENT 可放 .api_keys；ticker→CIK 本地缓存 7 天；非美股票返回 “CIK not found”

Cron harness 脚本（preflight + postflight 三明治）

所有 stock cron 都用同一套”preflight (确定性) → LLM (创造性) → postflight (校验)”模式。 确定性活强制脚本化执行；LLM 只做合成；postflight 自验证 + commit。 生产入口是安装后的 clawock CLI；生命周期实现由根 wheel 直接持有， CLAWOCK_PROFILE 只选择声明式配置和资源，不加载第二个 Python distribution。 旧的 scripts/harness/ 回滚别名已在 installed-command 切换验证后删除。

Daily deep brief（08:03 HKT cron）

Mode 6 briefing（HK 开/午/午后/收盘 + US 开/收盘 — 6 个 cron 共享）

Mode 7 intraday（HK + US 盘中盯盘 — 3 个 cron job 共享同一套脚本；季节化 slot 数和精确时间只看生成调度表，隔夜最后一档始终是 02:33 HKT）

共通设计点：

辅助

参数速查 / Utility arguments

下列参数以各命令的 --help 为准；[...] 表示可选，未加方括号的参数必填。 子命令也可用 clawock COMMAND SUBCOMMAND --help 查看。这里只记录调用与参数，不运行采集或账本写入。

live-sources

clawock live-sources

clawock live-sources [--market {hk,us,both}] [--sources SOURCES] [--fresh-since {session_open,last_close}] [--window-minutes WINDOW_MINUTES] [--budget-s BUDGET_S] [--timeout-s TIMEOUT_S] [--per-ticker PER_TICKER] [--json]
参数 用途
--market {hk,us,both} 采集市场，默认 both。
--sources SOURCES comma-separated subset of hkexnews,sec_fulltext,google_news,yahoo_rss,ths_724,em_724 (default: all)
--fresh-since {session_open,last_close} 资讯新鲜度口径，默认 session_open；last_close 以上次收盘为起点。
--window-minutes WINDOW_MINUTES 采集时间窗口（分钟），默认 1440。
--budget-s BUDGET_S 整批采集预算（秒）。
--timeout-s TIMEOUT_S 单次请求超时（秒）。
--per-ticker PER_TICKER 每票摘要最多保留条数，默认 4。
--json accepted for symmetry; output is JSON

mover-evidence

clawock mover-evidence

clawock mover-evidence --market {us,hk} --tickers TICKERS [--window-minutes WINDOW_MINUTES]
参数 用途
--market {us,hk} 必填市场。
--tickers TICKERS comma-separated movers
--window-minutes WINDOW_MINUTES 资讯窗口（分钟）。

news-evidence

clawock news-evidence

clawock news-evidence [--no-sec] [--policy POLICY]
参数 用途
--no-sec skip live SEC metadata refresh
--policy POLICY 资讯证据政策 JSON 路径。

cross-factor

clawock cross-factor

clawock cross-factor [--no-fundamentals] [--config CONFIG] [--backfill-history-ranks]
参数 用途
--no-fundamentals use a valid cache only; do not refresh SEC facts
--config CONFIG 因子配置 JSON 路径。
--backfill-history-ranks reconstruct sector-neutral constituent ranks for registered snapshots that predate their persistence (#1133), print the fidelity check, and exit without touching the live snapshot

peer-residual

clawock peer-residual

clawock peer-residual [--rules RULES]
参数 用途
--rules RULES 同业残差规则 JSON 路径。

t0

clawock t0

--intraday：等同 T0_INTRADAY=1，开盘时补 VWAP/ORB；默认不抓分钟数据。

validate-regime-dial

clawock validate-regime-dial

clawock validate-regime-dial [--folds FOLDS] [--permutations PERMUTATIONS] [--groups GROUPS] [--no-card]
参数 用途
--folds FOLDS walk-forward 折数，默认 4。
--permutations PERMUTATIONS 置换检验次数，默认 2000。
--groups GROUPS CSCV groups; every symmetric half-split is scored
--no-card skip writing a run card (for ad-hoc exploration)

validate-regime-hmm

clawock validate-regime-hmm

clawock validate-regime-hmm [--states STATES] [--warmup WARMUP] [--step STEP] [--permutations PERMUTATIONS] [--restarts RESTARTS] [--floor FLOOR] [--json] [--no-card]
参数 用途
--states STATES fix the state count; default selects it by BIC
--warmup WARMUP sessions before the first walk-forward label
--step STEP sessions between refits
--permutations PERMUTATIONS 置换检验次数。
--restarts RESTARTS EM restarts per fit; fewer is faster and more likely to report a local optimum as the model
--floor FLOOR exposure at full risk-off probability; the production dial reaches 0.0, so –floor 0 equalises the range
--json emit the full result instead of the report
--no-card skip writing a run card (for ad-hoc exploration)

evaluate-add-shapes

clawock evaluate-add-shapes

clawock evaluate-add-shapes [--json] [--no-card] [--campaigns] [--source {store,tencent}] [--split SPLIT]
参数 用途
--json emit the summary as JSON
--no-card skip the run card
--campaigns run the campaign simulation (right / left / combined, IS vs OOS)
--source {store,tencent} bars: memory/bars (default) or a longer Tencent fetch (MA200 needs ~200 sessions before the left side can fire)
--split SPLIT first out-of-sample signal date

dashboard-build

clawock dashboard-build

clawock dashboard-build [--previous PATH | --no-previous] [--out-dir DIR] [--skip-if-unchanged]
参数 用途
--previous PATH dashboard payload to restore card values from when their source context is absent from this checkout. Opt-in: a build that is going to be published from a checkout without the memory/.tmp sidecars passes the published dashboard.json here
--no-previous build from the workspace alone; no output may come from a previously published file. This is the default — pass it to state the guarantee explicitly
--out-dir DIR write the five outputs of this generation into DIR instead of the published location. Beats the BUILD_DASHBOARD_OUT / DECISION_AUDIT_OUT / SHADOW_PORTFOLIO_OUT redirects
--skip-if-unchanged hash the projection inputs first and skip the whole build when they match the last build’s fingerprint (stored under .cache/dashboard-input.json). The 20-minute publisher uses this so an unchanged desk does not reparse ~12MB of JSON every tick (#846).

decision-map

clawock decision-map

clawock decision-map [--out OUT] [--stdout]
参数 用途
--out OUT 输出 JSON 路径，默认 assets/data/decision_map.json。
--stdout 只打印 JSON，不写输出文件。

dashboard-outputs

clawock dashboard-outputs

clawock dashboard-outputs [--root ROOT] [--keep-clock-only] [--baseline-dir BASELINE_DIR]
参数 用途
--root ROOT 待比较的工作区根目录。
--keep-clock-only do not restore outputs changed only by build clocks
--baseline-dir BASELINE_DIR compare against a directory holding the last published generation instead of this repository’s HEAD (the outputs are no longer tracked, #314)

run-card

clawock run-card

clawock run-card [--list] [--run-id RUN_ID] [--diff RUN_ID RUN_ID] [--verify RUN_ID]
参数 用途
--list list stored run cards
--run-id RUN_ID print one card
--diff RUN_ID RUN_ID say which recorded input differs between two cards
--verify RUN_ID compare a card against the environment running now

claim-provenance

clawock claim-provenance

clawock claim-provenance [--check]
参数 用途
--check exit non-zero on problems

signal-panel

clawock signal-panel

clawock signal-panel [--horizon {t1,t5,t20}] [--json] [--panel] [--no-card]
参数 用途
--horizon {t1,t5,t20} horizon for the printed table (default t5)
--json print the full result
--panel print the panel rows instead of the scorecard
--no-card 跳过 run card 写入。

scorecard-provenance

clawock scorecard-provenance

clawock scorecard-provenance [--check] [--recompute] [--metrics METRICS] [--ledger LEDGER] [--ref REF] [--json]
参数 用途
--check recompute the digests and compare with the published block
--recompute also re-derive the headline counts at the recorded cutoff
--metrics METRICS published payload to read (default assets/data/dashboard.json)
--ledger LEDGER ledger to verify against (default memory/decisions.jsonl)
--ref REF read the ledger from this git ref instead of the working copy
--json print JSON, not text

provenance

clawock provenance

clawock provenance {calc,market-cap,verify-manifest} ...
参数 用途
{calc,market-cap,verify-manifest} 选择精确计算、市值核验或 manifest 核验；调用形式见下方各子命令。

record

clawock record

clawock record [--ledger LEDGER] [--source {claude,cli,codex,conversation,openclaw}] --subject SUBJECT [--market MARKET] [--currency CURRENCY] --action {abstain,add,buy,hold,reject,sell,trim,watch} --confidence CONFIDENCE [--driven-by {fundamental,mixed,sentiment,technical}] --bull BULL --bear BEAR [--bull-evidence BULL_EVIDENCE] [--bear-evidence BEAR_EVIDENCE] [--thesis THESIS] --invalidation INVALIDATION [--emotion {averaging_down,calm,euphoria,fear,fomo,mixed,revenge}] [--note NOTE]
参数 用途
--ledger LEDGER decisions.jsonl path (default: the workspace ledger)
--source {claude,cli,codex,conversation,openclaw} which harness produced this verdict (conversation=DSH)
--subject SUBJECT ticker, e.g. 00100
--market MARKET market, e.g. HK or US
--currency CURRENCY quote currency
--action {abstain,add,buy,hold,reject,sell,trim,watch} 必填裁决动作。
--confidence CONFIDENCE 必填置信度，0–1。
--driven-by {fundamental,mixed,sentiment,technical} 判断驱动因素，默认 mixed。
--bull BULL supporting case summary
--bear BEAR opposing case summary (mandatory)
--bull-evidence BULL_EVIDENCE 支持证据引用，可重复。
--bear-evidence BEAR_EVIDENCE 反对证据引用，可重复。
--thesis THESIS 关联 thesis。
--invalidation INVALIDATION observable falsification condition; repeatable
--emotion {averaging_down,calm,euphoria,fear,fomo,mixed,revenge} 裁决时的情绪，默认 calm。
--note NOTE 附注。

必填：--subject、--action、--confidence（0–1）、--bull、--bear、--invalidation。 --invalidation、--bull-evidence、--bear-evidence 可重复；默认 market/currency 为 HK/HKD，美股须显式指定 US/USD。 这是向裁决账本追加已做出的判断，不会下单或采集证据。示例：

clawock record --subject AAPL --market US --currency USD --action watch \
  --confidence 0.7 --bull "现金流稳定" --bear "估值偏高" \
  --invalidation "下一季营收同比转负"

risk

clawock risk

clawock risk [--ledger LEDGER] {list,ack,override,confirm} ...
参数 用途
{list,ack,override,confirm} 列出、确认已知晓、限时覆盖或证据确认；见下方子命令。
--ledger LEDGER 风险账本路径；放在子命令之前。

thesis

clawock thesis

clawock thesis {validate,drift} ...
参数 用途
{validate,drift} 校验 thesis JSON 或比较前后证据漂移。

entry-gate

clawock entry-gate

clawock entry-gate {validate,assess} ...
参数 用途
{validate,assess} 校验研究 gate JSON 或评估是否满足入场研究条件。

plan-context

clawock plan-context

clawock plan-context [--leg {HK,US}] [--date DATE]
参数 用途
--leg {HK,US} 只取指定市场的未结束裁决。
--date DATE 查询日期（YYYY-MM-DD），默认当天。

research

clawock research

clawock research [--check]
参数 用途
--check integrity only: exit 1 when an artifact is invalid

provenance calc

clawock provenance calc

clawock provenance calc --expr EXPR
参数 用途
--expr EXPR 必填算术表达式。

provenance market-cap

clawock provenance market-cap

clawock provenance market-cap --price PRICE --shares SHARES --reported REPORTED --currency CURRENCY [--tolerance-pct TOLERANCE_PCT]
参数 用途
--price PRICE 必填股价。
--shares SHARES 必填股数。
--reported REPORTED 必填待核验市值。
--currency CURRENCY 必填报价币种。
--tolerance-pct TOLERANCE_PCT 容许差异百分比，默认 1。

provenance verify-manifest

clawock provenance verify-manifest

clawock provenance verify-manifest path
参数 用途
path 必填 manifest JSON 文件路径。

risk list

clawock risk list

clawock risk list

risk ack

clawock risk ack

clawock risk ack --note NOTE breach_id
参数 用途
breach_id 必填风险事件 ID。
--note NOTE 必填知晓说明。

risk override

clawock risk override

clawock risk override --reason REASON --ttl-hours TTL_HOURS breach_id
参数 用途
breach_id 必填风险事件 ID。
--reason REASON 必填覆盖理由。
--ttl-hours TTL_HOURS 必填覆盖有效时长（小时）。

risk confirm

clawock risk confirm

clawock risk confirm --evidence EVIDENCE breach_id
参数 用途
breach_id 必填风险事件 ID。
--evidence EVIDENCE 必填确认依据。

thesis validate

clawock thesis validate

clawock thesis validate path
参数 用途
path 必填 thesis JSON 文件路径。

thesis drift

clawock thesis drift

clawock thesis drift old new
参数 用途
old 必填旧 thesis JSON 路径。
new 必填新 thesis JSON 路径。

entry-gate validate

clawock entry-gate validate

clawock entry-gate validate path
参数 用途
path 必填 entry gate JSON 路径。

entry-gate assess

clawock entry-gate assess

clawock entry-gate assess path
参数 用途
path 必填 entry gate JSON 路径。

Cron map

精确的 11-job schedule、EDT/EST 表达式、Mode/harness 和 11 条 watchdog 映射由 config/cron-schedules.json 单源维护，生成的人读表见 docs/operations/cron-schedules.md。 ops/host/sync_us_cron_dst.py --apply 每日自动对齐美股 live cron + system watchdog； clawock-cron-heartbeat 维护 Mode 7 slot ledger，由现有 single publisher 发布。

所有 harness preflight/postflight 的实现都在 src/clawock/harness/，统一从安装后的 clawock CLI 调用。Mode 6 / brief / Mode 7 的 postflight 都会重建 dashboard（输入未变时 --skip-if-unchanged 跳过）；Mode 7 每个 context 可用的 slot 都把 portfolio.json 连同当天快照与 build status 提交并推送，每个受监控 slot 的 heartbeat 都会发布并由 cron health 对账。

cron payload 是真实执行面，会为隔离 session 自包含关键步骤；SKILL.md 是详细规范。完整 prompt 模板在 config/cron-payloads/，job 变量、model/fallback/thinking/tools/schedule 则由 config/cron-schedules.json 单源声明；改格式时必须同时 diff payload 与对应 Mode，尤其 Step 2.5 sidecar。schedule、payload、watchdog 或生成文档漂移都会被 ops/system_check.py / CI 拦截。

改 cron 配置的安全步骤（默认只检查，显式 apply；不覆盖投递目标/account/failure alert）：

python3 ops/host/sync_cron_payloads.py --json
python3 ops/host/sync_cron_payloads.py --apply --json

同步器按精确 job 名/ID 规划最小 patch，发现重复/缺失/额外 job 或目标 job 正在运行时不写， 逐 job 失败即停，apply 后重新读取验证。升级大版本后仍应先 openclaw cron list --all 数 job 个数 （应为 11，其中 10 个启用；不带 --all 只列启用的 10 个），少了跑 openclaw doctor --fix。

Cron 运行历史（自动 + 手动跨 job 聚合）

openclaw cron runs 必须带 --id，且单 job 视角。跨 job + 自动调度 + 手动 trigger 一起看用：

bash ops/host/check_crons.sh                 # 最近 20 次（auto + manual 混排，HKT 倒序）
bash ops/host/check_crons.sh 50              # 最近 50 次
bash ops/host/check_crons.sh --status error  # 只看失败
bash ops/host/check_crons.sh --kind cron     # 只看自动调度
bash ops/host/check_crons.sh --job 港股       # 按 job 名子串过滤
bash ops/host/check_crons.sh --full          # 摘要不截断
bash ops/host/check_crons.sh --json          # JSON 输出（喂给后续 pipeline）

运行历史同样优先经 OpenClaw CLI 读取；旧 cron/runs/*.jsonl 只作为迁移前 fallback。 脚本本体 ops/host/cron_runs.py。

已废弃

旧脚本源码已删除，不作为参考依赖；provider、header、fallback 与解析逻辑只认 installed package 当前实现。

  • 完全删掉 (2026-05-16 大扫除)：monday_signal.py (含硬编码 key)、api_retry_wrapper.py、baidu_search_wrapper.py、deep_analysis.py、final_analysis.py、find_opportunities.py、hk_ai_monitor.py、multi_agent_stock_analysis.py、price_alert_monitor.py、TradingAgents/ 整目录
  • 完全删掉：scripts/legacy/ 与 scripts/data/；dated memory 中的旧文件名只属历史记录。