Aios Call App Service

Other

当请求依赖 AIOS、OpenClaw、Forguncy 等业务系统的实时数据、接口调用或业务操作时,优先使用本技能。先读取 AIOS_ONTOLOGY_DIR 指向的本体目录,再确认应用、命令、参数结构和枚举映射,通过 aios-app-invoke-cli 发起调用,并以实时返回结果作为后续分析和执行依据。

Install

openclaw skills install aios-call-app-service

系统调用技能

当用户的问题不能只靠通用知识回答,而是必须查询、调用或操作业务系统时,应优先使用本技能。

优先触发场景

  • 查询业务系统中的实时数据
  • 调用系统接口
  • 在系统内执行新增、修改、提交、审核、删除等动作
  • 需要基于真实系统返回结果继续分析或决策

必须遵循的流程

  1. 在发起调用前,先读取 AIOS_ONTOLOGY_DIR 指向的本体目录。
  2. 以本体为以下信息的唯一事实来源:
    • 应用名
    • 命令名或绑定端点
    • HTTP 方法
    • 请求体结构
    • 枚举值映射
    • 返回字段含义
  3. 只允许通过 aios-app-invoke-cli 调用系统接口。
  4. 实时调用结果的优先级高于记忆、缓存、历史对话和猜测。
  5. 只有在拿到 CLI 返回结果后,才能继续做后续分析、汇总和结论输出。

运行环境变量

编写说明、构造命令或排查问题时,统一使用以下环境变量名:

  • AIOS_DATA_DIR
  • AIOS_ONTOLOGY_DIR
  • AIOS_MQTT_CHANNEL_BROKER
  • AIOS_MQTT_CHANNEL_USERNAME
  • AIOS_MQTT_CHANNEL_PASSWORD
  • AIOS_APP_INVOKE_INBOUND_TOPIC
  • AIOS_APP_INVOKE_OUTBOUND_TOPIC
  • 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 视为当前事实源。
  • 调用 CLI 时,-u 传入当前 OpenClaw CurrentUser
  • 调用 CLI 时,-s 传入当前会话的 MessageThreadId
  • 调用 CLI 时,-a 传入当前 OpenClaw AgentName
  • CurrentUserMessageThreadIdAgentName 都只能从当前上下文获取,不能臆造,不能复用其他会话的值。
  • MessageThreadId 不得使用 chat_idmessage_id 等其他字段代替。
  • aios-app-invoke-cli 发出的请求体只包含 OpenClaw 约定字段:CurrentUserMessageThreadIdAgentName
  • 不要臆造接口名、请求字段、枚举 ID 或 provider
  • 不要绕过 CLI 自行编写 API 调用脚本。
  • 只有拿到 CLI 结果后,才允许用 Python 做二次分析和计算。
  • 如果本体不完整、provider 未知或运行时上下文缺失,应明确说明阻塞点,不要猜测。

开始前必须阅读

输出要求

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