Skills bluecolumn-memory

Name: bluecolumn-memory
Author: openclaw

Give AI agents persistent semantic memory using the BlueColumn API (bluecolumn.ai). Use when asked to remember, store, recall, or search memory using BlueColumn; when ingesting notes, conversations, documents, or audio into BlueColumn; when querying what an agent has previously stored; or when wiring up BlueColumn memory endpoints (/agent-remember, /agent-recall, /agent-note) in any workflow. Also use when the user mentions their BlueColumn API key (bc_live_*) and wants to store or retrieve information.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bluecolumnconsulting-lgtm/bluecolumn-memory" ~/.claude/skills/openclaw-skills-bluecolumn-memory && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bluecolumnconsulting-lgtm/bluecolumn-memory" ~/.openclaw/skills/openclaw-skills-bluecolumn-memory && rm -rf "$T"

manifest: skills/bluecolumnconsulting-lgtm/bluecolumn-memory/SKILL.md

BlueColumn Memory Skill

BlueColumn is a Memory Infrastructure API — three REST endpoints that give AI agents persistent semantic memory backed by Pinecone vector storage and OpenAI embeddings.

API Key

Store the user's BlueColumn API key in

TOOLS.md

under a

### BlueColumn

section:

### BlueColumn
API Key: bc_live_XXXXXXXXXXXXXXXXXXXX

Read

TOOLS.md

to retrieve the key before making any API calls.

Core Workflow

Store something (text, doc, audio)

Use

/agent-remember

— see references/api.md for full field spec.

curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-remember \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <key>" \
  -d '{"text": "...", "title": "optional title"}'

Returns

session_id

summary

action_items

key_topics

Query memory

Use

/agent-recall

— field is

(not

query

curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-recall \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <key>" \
  -d '{"q": "natural language question"}'

Returns

answer

sources

with relevance scores.

Save agent observation

Use

/agent-note

— field is

text

(not

note

), min 5 chars.

curl -X POST https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1/agent-note \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <key>" \
  -d '{"text": "...", "tags": ["optional", "tags"]}'

When to Use Each Endpoint

Situation	Endpoint
User shares a document, transcript, or block of text to remember	`/agent-remember`
User asks "what do you know about X?" or "recall..."	`/agent-recall`
Agent wants to save its own observation, preference, or decision	`/agent-note`
End of session — summarize and store what happened	`/agent-remember` or `/agent-note`

End-of-Session Memory

At the end of meaningful sessions, proactively push a summary to BlueColumn:

Summarize key decisions, facts, and context from the conversation
POST to
```
/agent-remember
```
with
```
title
```
= session topic
Confirm storage with the
```
session_id
```
returned

Field Name Gotchas

Common mistakes — read references/api.md for full details:

```
/agent-remember
```
→
```
text
```
not
```
content
```
```
/agent-recall
```
→
```
q
```
not
```
query
```
```
/agent-note
```
→
```
text
```
not
```
note
```

Full API Reference

See references/api.md for complete field specs, response shapes, and error reference.