Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cogos.natureselect.ai/llms.txt

Use this file to discover all available pages before exploring further.

CogOS includes a first-party OpenClaw plugin (cogos-openclaw-plugin/) that integrates CogOS as a Context Engine, providing structured long-term memory for OpenClaw.

​
Quick Start

# 1. Start the CogOS backend
cd CogOS
pip install -e .
export API_KEY="your-api-key"
export MODEL="google/gemini-2.5-flash"
export BASE_URL="https://openrouter.ai/api/v1"
cogos serve

# 2. Install and enable the plugin
openclaw plugins install --link /path/to/CogOS/cogos-openclaw-plugin

# 3. Start OpenClaw
openclaw gateway
The plugin automatically extracts and recalls structured memories each turn.

​
Features

  • Auto-extract and auto-recall — extracts information into structured schemas and injects it into the system prompt each turn
  • Schema-based memory — organizes knowledge into typed domains and fields
  • Multi-schema management — create, switch, backup, and restore independent schema files
  • Template system — bootstrap schemas from built-in, shared, or custom templates; full template CRUD via slash commands
  • Agent tools — 5 registered tools for LLM-driven memory management
  • Slash commands — full /cogos command suite for manual memory management

​
Configuration

Configure via environment variables or openclaw.json:
OptionEnv VariableDefaultDescription
cogosBaseUrlCOGOS_BASE_URLhttp://localhost:8000CogOS backend URL
sessionIdCOGOS_SESSION_IDdefaultCogOS session ID
schemaIdCOGOS_SCHEMA_IDdefaultShared schema file ID
schemaTemplateCOGOS_SCHEMA_TEMPLATE—Initial template
buildEveryNTurnsCOGOS_BUILD_EVERY_N_TURNS1Extraction frequency
Example openclaw.json: 
{
  "plugins": {
    "entries": {
      "cogos-claw": {
        "enabled": true,
        "config": {
          "cogosBaseUrl": "http://localhost:8000",
          "sessionId": "default",
          "schemaId": "default",
          "schemaTemplate": "general",
          "buildEveryNTurns": 1
        }
      }
    }
  }
}

​
Slash Commands

View & Recall
CommandDescription
/cogos or /cogos statusShow connection status and schema overview
/cogos inspectView schema structure with field values
/cogos recallRecall all stored memory data
Memory Management
CommandDescription
/cogos forget <domain>Delete a specific schema domain
/cogos forget --allClear all memory
/cogos resetBackup current schema and start fresh
Schema Files
CommandDescription
/cogos schemasList all schema files and backups
/cogos new [name]Create a new blank schema and switch to it
/cogos switch <schema_id>Switch to an existing schema
/cogos restore <backup_id>Restore a schema from backup
Template Management
CommandDescription
/cogos templatesList all available templates (grouped by source)
/cogos templates show <name>Preview template domains and fields
/cogos templates use <name>Create a schema from template and switch to it
/cogos templates createShow format help for creating custom templates
/cogos templates create <definition>Create a custom template (compact text or --json)
/cogos templates delete <name>Delete a custom template
/cogos templates helpShow template command help
Configuration
CommandDescription
/cogos configView current runtime configuration
/cogos config buildEveryNTurns <N>Update extraction frequency
/cogos helpShow help

​
Creating Custom Templates via Slash Command

Create templates directly from the chat using the compact text format: 
/cogos templates create game_character 游戏角色记忆模板
  character: name | 角色名称, class | 职业, level | 等级, skills | 技能列表
  story: main_quest | 当前主线任务, side_quests | 支线任务
  social: friends | 好友列表, guild | 公会, reputation | 声望
Format:
  • First line: template_name description (name allows letters, numbers, _, -)
  • Following lines: domain_name: field1 | description, field2 | description
Or use JSON format: /cogos templates create --json {"_meta":{"name":"..."},...}

​
Agent Tools

Five tools are registered for the OpenClaw agent:
ToolDescription
cogos_inspectInspect schema structure and field values
cogos_recallRecall all schema memory data
cogos_buildManually trigger information extraction
cogos_forgetDelete a domain or clear all memory
cogos_updateTrigger schema update from chat history

​
Context Engine Lifecycle

OpenClaw HookPlugin BehaviorCogOS API
bootstrapVerify backend, create session, load templatePOST /api/sessions, GET /api/schemas/recall-all
assembleFetch schema data, inject into system promptGET /api/schemas/recall-all
afterTurnFormat messages, extract infoPOST /api/build
compactDelegate to runtime—

​
Data Flow

User message → OpenClaw agent
                 ↓
           [assemble] → GET /api/schemas/recall-all
                 ↓        → schema data injected into system prompt
           Model generates response
                 ↓
           [afterTurn] → POST /api/build
                           → CM Agent extracts information
                           → Updates schema
                           → Available on next assemble

​
Data Storage

CogOS stores data under the OpenClaw Agent Workspace: 
~/.openclaw/workspace/cogos/
├── schemas/              # Schema files (shared across sessions)
│   ├── default.json
│   └── backups/
│       └── default_20260314_180736.json
└── sessions/
    └── default.json
Configure paths in configs/cogos.yaml: 
persistence:
  session_dir: "~/.openclaw/workspace/cogos/sessions"
  schemas_dir: "~/.openclaw/workspace/cogos/schemas"