Aionis_AI Agent skill-PHP中文网

Aionis

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过写入/上下文/策略/反馈记忆循环 API 将 OpenClaw 与 Aionis 对接

Aionis 内存政策循环技能

功能概述

Aionis 内存政策循环技能是一项面向实际任务的技能，主要用于当用户请求长期内存、引用检索、工具从内存规则中路由或反馈驱动的政策调整时, 请使用此技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Aionis 记忆策略循环技能

当用户请求长期记忆、带引用的检索、基于记忆规则的工具路由，或依赖反馈的策略自适应时，请使用此技能。

运行要求（本地独立部署）

需配置以下环境变量：

AIONIS_BASE_URL：
- 主机直连运行：http://127.0.0.1:3001
- 容器内访问宿主机：http://host.docker.internal:3001
任选一种认证方式：
- AIONIS_API_KEY
- 或 AIONIS_AUTH_BEARER
可选配置：
- AIONIS_TENANT_ID（默认值：default）
- AIONIS_SCOPE_PREFIX（默认值：clawbot）

安全规范

禁止在响应中明文输出任何完整密钥或敏感凭证。
每个项目须固定 scope，格式为：clawbot:。
禁止将原始工具输出直接写入记忆；应仅存储简洁摘要。
所有请求必须设置明确边界：包括召回数量限制与上下文组装长度限制。
若 /v1/memory/context/assemble 接口不可用，则自动降级至 /v1/memory/recall_text 并继续执行。

连通性预检

启动记忆循环前，请确保 Aionis 独立服务可达：

GET /health 返回状态码 200。
POST /v1/memory/write 携带 x-api-key 请求头后返回 200。
若任一检查失败，立即中止流程，并返回清晰的连通性或认证错误信息。

自动引导命令

若本地独立服务未运行，请执行：

bash ./bootstrap-local-standalone.sh

随后加载运行时环境变量：

source ./.runtime/clawbot.env

默认工作流

写入关键事实或结果：
- POST /v1/memory/write
规划前构建分层上下文：
- POST /v1/memory/context/assemble
- 若 assemble 接口不可用，则降级使用 POST /v1/memory/recall_text
依据策略进行工具路由：
- POST /v1/memory/tools/select
执行完成后闭环反馈：
- POST /v1/memory/tools/feedback

请求模板

请使用以下模板（替换占位符）：

write

{
  "tenant_id": "default",
  "scope": "clawbot:demo-project",
  "input_text": "Customer prefers email follow-up",
  "auto_embed": true,
  "nodes": [
    {
      "client_id": "evt_001",
      "type": "event",
      "text_summary": "Customer prefers email follow-up",
      "memory_lane": "shared",
      "slots": {
        "integration": "openclaw",
        "kind": "event",
        "project": "demo-project"
      }
    }
  ],
  "edges": []
}

context assemble

{
  "tenant_id": "default",
  "scope": "clawbot:demo-project",
  "query_text": "How should I follow up with this customer?",
  "include_rules": true,
  "include_shadow": false,
  "rules_limit": 50,
  "tool_strict": false,
  "return_layered_context": true,
  "context_layers": {
    "enabled": ["facts", "episodes", "rules", "decisions", "tools", "citations"],
    "char_budget_total": 3200,
    "include_merge_trace": true
  },
  "limit": 30,
  "neighborhood_hops": 2,
  "max_nodes": 50,
  "max_edges": 100
}

tools select

{
  "tenant_id": "default",
  "scope": "clawbot:demo-project",
  "run_id": "run_001",
  "context": {
    "intent": "follow_up",
    "customer": {
      "prefers": "email"
    }
  },
  "candidates": ["send_email", "call_crm", "search_docs"],
  "include_shadow": false,
  "rules_limit": 50,
  "strict": false
}

tools feedback

{
  "tenant_id": "default",
  "scope": "clawbot:demo-project",
  "run_id": "run_001",
  "outcome": "positive",
  "context": {
    "intent": "follow_up",
    "customer": {
      "prefers": "email"
    }
  },
  "candidates": ["send_email", "call_crm", "search_docs"],
  "selected_tool": "send_email",
  "include_shadow": false,
  "rules_limit": 50,
  "target": "tool",
  "input_text": "openclaw feedback accepted tool send_email"
}