📋 列表查询 list_*38
list_ships查询船舶列表，支持按船名/IMO/船型/状态过滤。返回船舶基本信息（id, name, imo, type, flag,
list_voyages查询航次列表，支持按船舶 ID、状态过滤。返回航次基本信息（id, shipId, voyageNo, status,
list_near_misses查询近 Miss 事件列表（未构成事故但具有潜在安全风险的事件）。支持按船舶、状态过滤。
list_safety_events查询安全事件列表（含演习、检查、培训等安全相关事件记录）。支持按类型、船舶过滤。
list_certificates查询船舶证书列表，支持按船舶、状态过滤。返回证书基本信息（id, shipId, name, issuedAt, exp
list_compliance_items查询合规事项列表（含 ISM/ISPS/MLC/TMSA 等合规框架要求项）。支持按状态、类型过滤。
list_work_permits查询工作许可证列表（热工/封闭空间/电气等高风险作业许可）。支持按船舶、状态过滤。
list_equipment查询设备列表（船舶主机/辅机/泵阀等关键设备）。支持按船舶、类型过滤。返回设备基本信息及当前健康状态。
list_crew查询船员列表，支持按船舶、职务过滤。返回船员基本信息（id, name, rank, shipId, contractS
list_knowledge_documents列出本地知识库已 ingest 的文档及其元信息（id/标题/分类/来源/分块数）。READ 操作。
list_approval_history查询审批历史记录，聚合工作许可证和变更管理的审批记录。支持按船舶、类型过滤。
list_pending_approvals查询当前所有待审批项列表（含工作流审批和自主决策审批）。返回每项的 id/source/type/status/crea
list_enclosed_space_permits查询封闭舱室进入许可证列表，支持按船舶和状态过滤。
list_change_requests查询变更管理请求列表，支持按船舶和状态过滤。
list_emergency_drills查询应急演习列表，支持按船舶、类型、状态过滤。
list_training查询培训列表，支持按船舶和状态过滤。
list_agents查询智能体列表，支持按类型过滤。返回智能体 ID、名称、类型、状态。
list_deep_research_tasks查询深度研究任务列表，支持按状态过滤。
list_inspections查询 AI 巡检记录列表（inspect-ai）。返回巡检任务、状态与结果摘要。
list_psc_inspections查询 PSC（港口国监督）巡检记录列表。
list_mlc_violations查询 MLC（海事劳工公约）违规项列表。
list_equipment_health查询设备健康明细列表（equipment[]: equipmentId, overallHealth, trend, r
list_equipment_maintenance查询设备维护记录（records）。用于巡检后跟踪维护历史与未闭环项。
list_workorder_overdue查询逾期工单分析（summary / byPriority / trend / regulatoryReference）
list_procurement_records查询采购记录（id, prNumber, itemType, description, quantity, estima
list_supplier_records查询供应商【评估台账】（物理表 supplier_records：supplierName/category/ratin
list_inspect_ai_certificates查询 AI 巡检证书列表（inspect-ai 域）。注意：与业务证书(/api/certificates)不同，此为
list_cargo_opportunities查询货盘列表（cargo opportunities），支持按状态过滤。返回货盘基本信息（id, cargoType,
list_charters查询租船合同列表（期租/程租/光租），支持按类型过滤。
list_voyage_estimates查询航次估算列表（装港/卸港/装卸量/预算成本/预估收益等）。
list_cargo查询货物列表（cargo），支持按船舶过滤。
list_ports查询港口列表（上海/新加坡/宁波-舟山等），含经纬度、时区、最大吃水、引航/锚地/加油设施等。
list_port_calls查询船舶靠泊计划列表（含船名、泊位、ETA/ETD、目的、状态）。
list_port_restrictions查询港口限制条件（水深/吃水/货物类型/检疫等限制）。
list_procurement_requests查询采购申请列表（PR），支持按船舶/状态过滤。含 items、urgency、supplierId 等字段。
list_spare_parts_inventory查询备件库存列表（含库存量/安全库存/预警）。
list_inventory_records查询库存记录（物料/备件出入库流水）。
list_bunkering_records查询加油记录（燃油补给，含油种/数量/价格）。
🔍 详情查询 get_*32
get_ship_detail查询船舶详情，含基本信息、稳性数据、甲板维护、导航数据。通过 view 参数切换返回内容。
get_voyage_workflow查询航次工作流时间线，返回航次各阶段节点（计划/装货/航行/卸货/结算）及当前状态。用于跟踪航次执行进度。
get_tmsa_scores查询 TMSA（油轮船东自评估程序）评分。返回各阶段（Stage 1-4）的 KPI 评分与等级。用于评估船队安全管理体
get_dashboard_stats查询全局仪表盘统计数据（船队规模、在航船舶数、未结事故数、证书预警数、待审批工单数等核心 KPI）。
get_safety_hub_status查询安全中枢状态（L4/L5 安全监控总览），含实时告警、风险等级、未处理事件数、自治循环状态。
get_deep_research_report获取深度研究报告。任务完成时返回完整报告，任务进行中返回进度状态。
get_agent_session_messages查询智能体会话消息历史。
get_inspection按 ID 查询单条 AI 巡检记录详情（含检查项与结果）。
get_transformation_risk_board获取转型/风险板：汇总当前 activeSpecialPermits、unsafeEvents、equipmentAtR
get_equipment_health_summary查询全船队设备健康汇总（total / byRiskLevel / byShip / recentWorkOrders）
get_equipment_health_realtime查询设备实时健康状态列表。注意：当前实时遥测来自模拟源，可能返回空列表（realtime 接入待上线）。
get_equipment_alerts查询设备告警列表（alerts / count）。用于巡检后跟踪设备级告警。当前告警源自模拟风险板。
get_equipment_health_trends查询设备健康趋势（trends）。用于观察设备状态随时间变化，辅助巡检结论。
get_equipment_report查询单台设备健康报告（equipmentId, generatedAt, overallHealth, trend, r
get_equipment_downtime查询设备停机分析（summary / equipment / trend / regulatoryReference）。
get_cargo_opportunity查询单个货盘详情，含货物类型、数量、装卸港、Laycan、运费率、匹配船舶等完整字段。
get_cargo_opportunity_matches查询指定货盘的候选匹配船舶列表（智能匹配引擎打分排序）。
get_cargo_opportunities_stats查询货盘统计（总数/各状态分布/货量汇总）。
get_cargo_loading_plan查询指定船舶的装货计划（loading plan）。
get_port_detail查询单个港口详情（含泊位、水深、设施、限制条件等）。
get_port_terminals查询指定港口的码头/泊位列表（含化学品/原油码头设施、装卸臂、ESD 联动等）。
get_port_stats查询港口统计（总港口数/原油港/化学品港/活跃限制/计划靠泊等）。
get_terminal_berths查询码头泊位合并视图（本地泊位 ∪ CSPC 实时泊位，含 cspcLive 实时透传）。
get_terminal_queue查询码头船舶作业队列（CSPC 实时透传，含靠泊/锚地等待状态）。
get_terminal_health查询船岸桥接健康状态（CSPC 版本/数据库/鉴权/auth 用户数）。
get_terminal_exchange_log查询船岸信息交换审计日志（MTPQ 校验等 outbound/inbound 记录）。
get_port_workflow_stats查询靠泊工作流统计（active/completed 状态分布）。
get_procurement_analytics查询采购分析（各维度采购金额/频次/供应商分布）。
get_procurement_orders查询采购订单列表（PO）。
get_procurement_suppliers查询采购供应商【名录】（records EAV type=suppliers 权威源：name/category/con
get_spare_parts_stock_alerts查询备件库存预警（低于安全库存的备件）。
get_my_role查询当前微信对话者绑定的平台角色。返回 bound(是否已绑定)、role(角色标识)、roleLabel(角色中文名)
🔍 查询 query_*1
query_incidents事故查询聚合工具。默认返回事故列表；传 view=stats 返回统计；传 view=trends 返回趋势；传 inc
✅ 检查 check_*2
check_certificate_alerts检查证书到期预警，返回即将过期（30/60/90 天）的证书列表。用于定期合规检查与 PoC 链路中识别证书过期场景。
check_backend_health探测 OpenClaw 后端健康状态：对 GET /api/ships 发起探测并记录 HTTP 状态与耗时，用于监控后
🔎 搜索 search_*4
search_knowledge_base语义检索知识库（16259 段落法规库）。输入自然语言查询，返回相关条款与证据。用于法规查询、合规判断、知识盲区补全。注
search_knowledge_graph图谱节点搜索，查询船舶/设备/人员/事件等实体及其关联关系。返回节点与邻居边信息。用于实体关系探索与影响范围分析。
search_local_knowledge检索本地知识库（由 ingest_knowledge_document 写入的文档）。零依赖分块关键词检索，适用于封闭舱
search_knowledge统一知识检索：本地优先 + 远端补充。先检索本地已 curated 的海事安全库（封闭舱室/消防等，结果可靠），再补充
📥 知识接入 ingest_*1
ingest_knowledge_document向本地知识库写入（ingest/upload）一篇文档并建立分块索引，供 search_local_knowledge
🗑️ 删除 delete_*2
delete_document删除知识库文档及其所有关联数据（段落、向量、图谱节点）。用于清理测试产生的脏文档或过期语料。需 confirm=true
delete_work_permit删除工作许可证记录。用于清理测试产生的许可证数据。
➕ 创建 create_*13
create_work_order创建维修工单。需在 TRAE Work Plan 模式下二次确认。用于设备维修、证书到期整改、事故纠正措施等场景的工单发
create_enclosed_space_permit创建封闭舱室进入许可证。需指定船舶、进入位置、工作描述、进入人数（≥2）、监护人、气体检测人员。后端自动校验 IMO M
create_hot_work_permit创建热工作业许可证（动火作业）。适用于焊接、切割、打磨等产生明火或高温的作业。审批链为3级：负责高级船员→大副/轮机长(
create_electrical_permit创建电气作业许可证。适用于高压电气设备维护、电气隔离等作业。审批链含轮机长（电气属机舱系统）。
create_height_work_permit创建高空作业许可证。适用于甲板上方2米以上的作业。审批链含大副（甲板作业）。
create_lifting_permit创建吊装作业许可证。适用于重物吊装、克令吊作业等。审批链含大副（甲板作业）。
create_change_request创建变更管理请求（MOC）。涵盖船舶改装、设备更换、程序变更等需评估风险并审批的变更。
create_tank_cleaning_plan生成合规驱动的洗舱计划（Cargo Tank Cleaning Plan）。依据 IBC Code 2019 第 17
create_emergency_drill创建应急演习。支持 10 类演习：消防/弃船/救生艇/应急舵/SOPEP/保安/封闭空间/医疗急救/SAR/防海盗。
create_training创建培训记录。涵盖安全培训、设备操作培训、法规培训等。
create_cargo_opportunity发布一个货盘（cargo opportunity），供智能匹配引擎匹配合适船舶。货代找船的第一环。
create_port_call创建一条船舶靠泊计划（port call），含船名、泊位、ETA/ETD、目的。
create_procurement_request提交采购申请（PR），生成待审批采购请求。物料供应的第一环。
✍️ 审批 approve_*4
approve_unified统一审批工具，支持工作许可证(WP-前缀)/变更管理(CHG-前缀)/通用审批流等多类型审批。根据 ID 前缀自动路由到
approve_work_permit审批工作许可证（分级审批链）。推进审批到下一步或最终批准/拒绝。适用于封闭舱室、动火、电气等所有许可证类型。
approve_work_permit_as_role以登录身份审批工作许可证。审批角色由登录身份(JWT)自动推导，无需手动指定。用于多角色分级审批场景（船长/轮机长/DP
approve_change_request审批通过变更管理请求。
⛔ 驳回 reject_*1
reject_unified统一拒绝工具，支持工作许可证(WP-前缀)/变更管理(CHG-前缀)/通用审批流等多类型拒绝。根据 ID 前缀自动路由到
📤 发送 send_*1
send_notification发送通知（邮件/站内信/移动推送）给指定收件人。需在 TRAE Work Plan 模式下二次确认。PoC 链路关键工具
📝 提交 submit_*1
submit_gas_test提交封闭舱室气体检测记录。后端校验大气阈值（O₂ 19.5-23.5%，LEL <1%，H₂S <10ppm
🏁 完成 complete_*1
complete_enclosed_space_permit完成封闭舱室作业并关闭许可证。记录关闭程序执行情况。
🔧 执行 implement_*1
implement_change_request实施已批准的变更管理请求。
🧩 生成 generate_*4
generate_annual_drill_planAI 生成年度演习计划，自动覆盖 SOLAS/ISM/ISPS 要求的 10 类演习（消防/弃船/救生艇/应急舵/SOP
generate_drill_scenarioAI 生成演习场景脚本，包含场景描述、触发条件、参与角色、预期行动和评估标准。
generate_training_contentAI 生成培训内容，包含培训大纲、重点知识点、案例分析和考核要点。
generate_examAI 生成培训考试题目，包含选择题、判断题和简答题。
⚡ 调用 invoke_*2
invoke_agent执行智能体任务。调用指定智能体处理输入内容并返回结果。
invoke_domain_specialist调用 L5 域专家智能体。支持的安全域：safety（安全）/cargo（货物）/navigation（航行）/comp
▶️ 启动 start_*1
start_deep_research启动深度研究任务。系统自动多步搜索、分析、综合，生成专业研究报告。
🔔 触发 trigger_*3
trigger_agent_collaboration触发一轮智能体协作。注意：后端该端点不接受任何参数，无法指定场景、参与者或目标——它只是让协作调度器立即跑一轮。若需定向
trigger_fleet_daily_inspection触发船队自主日巡检：调用后端 autonomous-inspection，读取风险板(risk-board)的 fuse
trigger_equipment_fault_prediction触发设备故障预测分析并持久化预测结果到生产库：写入 equipmentId 的故障预测（bearing_wear / m
✉️ 邮件 email_*33
email_search搜索已收到的邮件，封装后端 EmailAgent 的 action=search。空查询返回最近邮件，按关键词搜索返回匹
email_read按 message_id 读取单封邮件详情，含正文、附件列表、线程 ID。
email_threads查询邮件线程。不传 threadId 返回所有线程列表（id/messageCount/subject/lastActi
email_health查询邮件系统健康状态，返回 IMAP 连接状态、最后拉取时间、失败队列深度、最近错误等信息。
email_send发送新邮件。需二步确认：首次调用返回 confirmId，邮件暂不发送；用户调用 email_confirm 传入 co
email_draft保存邮件草稿，返回 draftId。后续可用 email_send_draft 发送。
email_send_draft发送已保存的草稿。需二步确认。
email_reply调用后端 EmailAgent 的 LLM 6 级降级链（MiMo → glm-4.7-flash → glm-4-fl
email_process手动触发 EmailAgent 处理流程，用于调试或重放失败队列中的邮件。返回处理结果含 reply/classific
email_confirm确认 email_send/email_send_draft/email_reply 等工具生成的待确认操作。传入 co
email_account_list列出所有已配置的邮件账户（邮箱地址、协议、连接状态等），用于查看当前接入了哪些邮箱。
email_account_get获取单个邮件账户详情（含服务器配置与连接状态）。
email_account_create新增一个邮件账户（IMAP/POP3/SMTP 等）。创建后状态为 disconnected，需再调用 email_ac
email_account_update更新邮件账户配置（密码、服务器、开关等）。其余账户字段按需传入。
email_account_delete删除一个邮件账户。
email_account_test测试邮件账户连接，成功后将该账户状态置为 connected 并记录最后同步时间。
email_smtp_config_list列出所有 SMTP / 邮件服务器配置（发信服务器、端口、账户、加密方式）。
email_smtp_config_create新增 SMTP 邮件服务器配置（发信通道）。其余字段按需传入。
email_smtp_config_update更新 SMTP 邮件服务器配置。其余字段按需传入。
email_smtp_config_delete删除 SMTP 邮件服务器配置。
email_smtp_config_test测试指定 SMTP 配置能否成功连接 / 发信。
email_config_get获取全局邮件处理配置（自动分类 / 自动回复 / 自动归档开关、分类标签）。
email_config_update更新全局邮件处理配置（开启 / 关闭自动分类、自动回复、自动归档，配置分类标签）。字段按需传入，后端原样存储。
email_rule_list列出所有自动回复规则（触发条件、回复模板、启用状态）。
email_rule_get获取单条自动回复规则详情。
email_rule_create新增自动回复规则（如关键词触发、特定发件人自动回复模板）。其余字段按需传入。
email_rule_update更新自动回复规则。其余字段按需传入。
email_rule_delete删除自动回复规则。
email_attachment_analyze分析邮件附件（传入附件 base64 内容），提取文本 / 结构化信息，结果写入缓存。
email_attachment_result获取附件分析结果（从缓存读取，需先调用 email_attachment_analyze）。
email_attachment_status获取附件分析服务状态（可用分析器、队列等）。
email_record_list列出邮件记录（支持按状态 / 分类 / 发件人 / 时间过滤）。直接读取本地邮件库，区别于 AI 智能体的语义搜索(em
email_record_get获取单封邮件记录详情（正文、附件元数据等）。
🎯 决策引擎 decision_*7
decision_execute触发指定决策的闭环执行。需二步确认。
decision_status查询决策执行进度、阶段、错误信息。
decision_history查询闭环执行历史列表。
decision_quality_report查询决策质量报告，含决策成功率、平均执行时间等指标。
decision_engine_stats查询闭环执行引擎统计，含运行中/已完成/失败任务数等。
decision_register_rule注册新的决策验证规则，用于闭环执行前的合规检查。
decision_test_closed_loop运行闭环执行测试，仅诊断用途，不影响生产数据。
🛡️ 安全枢纽 safety_*7
safety_hub_status查询安全中枢状态，含当前模式、活跃告警数、合规状态等。
safety_hub_mode切换安全中枢运行模式（normal/heightened/emergency）。
safety_hub_decision提交安全决策到安全中枢审批。
safety_hub_decisions查询安全中枢决策列表。
safety_hub_alerts查询安全中枢告警列表。
safety_hub_alert_ack确认指定告警。
safety_hub_compliance查询安全中枢合规状态。
🎼 编排器 orchestrator_*7
orchestrator_invoke通过统一编排器调用指定智能体。
orchestrator_route根据查询自动路由到最合适的智能体执行。
orchestrator_broadcast将查询广播到多个智能体并行处理。
orchestrator_workflow按工作流定义串联多智能体执行。整个 workflow 对象作为 body 透传。
orchestrator_agents列出编排器可调用的智能体列表。
orchestrator_stats查询编排器统计，含调用次数、成功率、平均耗时等。
orchestrator_cargo_request执行端到端货运编排（订舱→配载→航次→单证）。
🤖 智能体会话 agent_*6
agent_sessions_list查询指定智能体的会话列表。
agent_session_create为指定智能体创建新会话。
agent_session_detail查询会话详情。
agent_session_delete删除指定会话。
agent_session_reset重置指定会话的状态。
agent_session_messages查询会话消息历史。
🐙 深度分析 openclaw_*1
openclaw_deep_analysis触发 L5 多智能体协作完成复杂推理（如事故根因分析、TMSA 自评估、航次风险综合评估）。同步等待结果，超时阈值 12
🏛️ 监管视角 regulator_*3
regulator_list_operators【监管只读】列出辖区内所有运营方（船东/船舶管理公司）主数据，含各家在册船舶数。海事局统一管控入口。
regulator_dashboard【监管只读】辖区安全态势看板：按运营方分组汇总在册船舶、未结事故/险情、设备缺陷、在办作业许可，以及辖区级证书临期/过期
regulator_situation【监管只读】一句话辖区安全态势摘要（自然语言），供 WorkBuddy 对话式"问辖区安全态势"使用。
🔗 匹配 match_*1
match_cargo_ship为指定货盘执行智能匹配，返回候选船舶（按匹配分排序），最优匹配分≥60 时自动创建航次记录。