系统调用技能

当用户的请求不能只靠通用知识回答，而是需要查询、调用或操作 AIOS / OpenClaw / Forguncy 等业务系统时，应优先使用本技能。

优先触发场景

以下情况默认优先使用本技能：

• 用户要查询业务系统中的实时数据
• 用户要新增、修改、提交、审批、删除或触发某个业务动作
• 用户要求“帮我在系统里操作一下”
• 用户的问题依赖系统中的表、绑定、枚举、服务端命令或业务状态
• 用户要求的结果必须以真实系统返回为准，而不能只靠历史对话或常识推断

示例

以下请求都应优先触发本技能：

• 帮我查一下今天有哪些待审批单据
• 把这个供应商创建到系统里
• 帮我查询某个客户最近 30 天的订单
• 把这条工单状态改成“已完成”
• 帮我看看库存低于 10 的物料有哪些
• 查询某个项目当前的执行进度
• 帮我在系统里提交一条请假申请
• 查询某个下拉枚举在系统里对应的真实 ID
• 帮我调用系统接口获取这张表的全部数据
• 这个字段到底要传什么值，先去系统本体里确认

运行环境变量

本技能依赖运行环境中已配置好的 AIOS 相关环境变量。编写说明、调用 CLI 或排查问题时，统一使用以下变量名：

• 数据目录与本体目录：
  • AIOS_DATA_DIR
  • AIOS_ONTOLOGY_DIR
• MQTT 连接：
  • AIOS_MQTT_CHANNEL_BROKER
  • AIOS_MQTT_CHANNEL_USERNAME
  • AIOS_MQTT_CHANNEL_PASSWORD
• 应用调用主题：
  • AIOS_APP_INVOKE_INBOUND_TOPIC
  • AIOS_APP_INVOKE_OUTBOUND_TOPIC
• 管理主题：
  • AIOS_ADMIN_INBOUND_TOPIC
  • AIOS_ADMIN_OUTBOUND_TOPIC
• Agent 主题模板：
  • AIOS_AGENT_CHANNEL_INBOUND_TOPIC_TEMPLATE
  • AIOS_AGENT_CHANNEL_OUTBOUND_TOPIC_TEMPLATE
• OpenAI 能力：
  • AIOS_OPENAI_API_KEY
• S3 存储：
  • AIOS_S3_ENDPOINT
  • AIOS_S3_REGION
  • AIOS_S3_ACCESS_KEY_ID
  • AIOS_S3_SECRET_ACCESS_KEY
  • AIOS_S3_FORCE_PATH_STYLE
  • AIOS_S3_ADMIN_INBOX_BUCKET
  • AIOS_S3_ADMIN_OUTBOX_BUCKET
  • AIOS_S3_AGENT_INBOX_BUCKET
  • AIOS_S3_AGENT_OUTBOX_BUCKET

本体目录统一使用 AIOS_ONTOLOGY_DIR。

不要在技能说明中自造其他环境变量名。如果调用失败且疑似运行环境问题，优先检查这些变量是否存在且已正确注入。

必须遵循的流程

1. 在回答、规划或发起调用之前，先读取 AIOS_ONTOLOGY_DIR 指向的目录。
2. 将本体作为以下信息的事实来源：
   • 目标应用
   • 可调用的服务端命令或绑定
   • HTTP 方法
   • 请求体结构
   • 枚举值解析路径
   • 返回字段含义
3. 只允许通过 aios-app-invoke-cli 调用系统接口。
4. 实时调用结果的优先级高于对话记忆、缓存假设或更早轮次的内容。
5. 只有结合本体和实时返回结果后，才能继续后续规划和执行。

约束要求

• 将 AIOS_ONTOLOGY_DIR 视为当前事实来源。
• 不要臆造接口名、请求字段、枚举 ID 或 provider。
• 不要绕过 CLI 自行编写 API 调用脚本。
• 只有在 CLI 返回结果后，才允许使用 Python 做二次解析和计算。
• 如果本体不完整、provider 未知或运行时上下文缺失，应明确说明阻塞点，不要猜测。

接下来需要阅读的内容

• 在构造调用前，必须阅读 references/invoke-rules.md。
• 当结果需要筛选、分组、计数、排序、聚合、比较或时间分析时，阅读 references/data-processing.md。

输出要求

• 说明本次调用依据了哪个本体文件或条目。
• 说明使用的是哪类 CLI 调用方式：servercommand 或 binding。
• 说明任何假设、跳过的数据、缺失字段或不确定性。