Aionis 记忆策略循环技能

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

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

需配置以下环境变量：

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

安全规范

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

连通性预检

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

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

自动引导命令

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

bash ./bootstrap-local-standalone.sh

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

source ./.runtime/clawbot.env

默认工作流

1. 写入关键事实或结果：
   • POST /v1/memory/write
2. 规划前构建分层上下文：
   • POST /v1/memory/context/assemble
   • 若 assemble 接口不可用，则降级使用 POST /v1/memory/recall_text
3. 依据策略进行工具路由：
   • POST /v1/memory/tools/select
4. 执行完成后闭环反馈：
   • 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"
}

输出预期

使用本技能时，若响应中存在以下字段，请务必包含：

1. request_id
2. commit_id 或 commit_uri
3. decision_id 或 decision_uri
4. run_id

此外还需包含：

5. 本次运行所使用的 base_url
6. 本次运行所使用的 scope