Aionis

Connect OpenClaw to Aionis using write/context/policy/feedback memory loop APIs.

Aionis Memory Policy Loop Skill

Use this skill when the user asks for long-term memory, retrieval with citations, tool routing from memory rules, or feedback-driven policy adaptation.

Requirements (Local Standalone)

Environment variables:

1. AIONIS_BASE_URL:
   • host run: http://127.0.0.1:3001
   • container-to-host run: http://host.docker.internal:3001
2. One auth method:
   • AIONIS_API_KEY
   • or AIONIS_AUTH_BEARER
3. Optional:
   • AIONIS_TENANT_ID (default: default)
   • AIONIS_SCOPE_PREFIX (default: clawbot)

Safety Rules

1. Never print full secrets in responses.
2. Keep scope fixed per project: clawbot:<project>.
3. Do not write raw tool output dumps into memory; store concise summaries.
4. Keep requests bounded: set limits for recall and context assembly.
5. If /v1/memory/context/assemble is unavailable, fallback to /v1/memory/recall_text and continue.

Connectivity Precheck

Before running the memory loop, ensure Aionis standalone is reachable:

1. GET /health returns 200.
2. POST /v1/memory/write with x-api-key returns 200.
3. If check fails, stop and return a clear connectivity/auth error.

Auto Bootstrap Command

If local standalone is not running, execute:

bash ./bootstrap-local-standalone.sh

Then load runtime env:

source ./.runtime/clawbot.env

Default Workflow

1. Ingest key facts/results:
   • POST /v1/memory/write
2. Build layered context before planning:
   • POST /v1/memory/context/assemble
   • fallback to POST /v1/memory/recall_text if assemble endpoint is unavailable
3. Route tools with policy:
   • POST /v1/memory/tools/select
4. Close the loop after execution:
   • POST /v1/memory/tools/feedback

Request Templates

Use these templates (replace placeholders):

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"
}

Output Expectations

When using this skill, include these IDs in your response when present:

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

Also include:

5. base_url used for this run
6. scope used for this run