Agent Journal

Other

Give AI agents a persistent journal backed by BlueColumn semantic memory. Use when an agent should log daily observations, decisions, user preferences, or notable events that need to be recalled later. Triggers on phrases like "log this", "journal entry", "remember for later", "note this down", "what have you observed about", "what do you know about the user", or when an agent wants to store its own learnings across sessions. Requires a BlueColumn API key (bc_live_*).

Install

openclaw skills install agent-journal

Agent Journal Skill

Persistent cross-session journal for AI agents. Store observations, preferences, and decisions — recall them anytime.

Setup

Read TOOLS.md for the BlueColumn API key (bc_live_*). Keys are generated at bluecolumn.ai/dashboard. Store securely — never log or expose them.

Base URL: https://xkjkwqbfvkswwdmbtndo.supabase.co/functions/v1 (BlueColumn's official backend — bluecolumn.ai runs on Supabase Edge Functions)

Log an Observation (agent-note)

For lightweight agent observations — preferences, patterns, decisions:

curl -X POST .../agent-note \
  -H "Authorization: Bearer <key>" \
  -d '{"text": "User prefers bullet points over paragraphs", "tags": ["preference", "style"]}'

Log a Detailed Entry (agent-remember)

For richer entries with auto-extracted metadata:

curl -X POST .../agent-remember \
  -H "Authorization: Bearer <key>" \
  -d '{"text": "Session summary: user is building a SaaS product in Phoenix. Decided on PostgreSQL. Main concern is scalability.", "title": "Session Log 2026-04-14"}'

Recall Journal Entries

curl -X POST .../agent-recall \
  -H "Authorization: Bearer <key>" \
  -d '{"q": "what does the user prefer for formatting?"}'

When to Use Each

Situation	Endpoint
Quick preference or observation	`/agent-note`
End-of-session summary	`/agent-remember`
Retrieving past context	`/agent-recall`

Journaling Workflow

Start of session: Recall relevant context:

"What do I know about this user?"
"What were we working on last time?"

During session: Note important observations via /agent-note

End of session: Summarize and store via /agent-remember

Tag Suggestions

preference — user style/format preferences
decision — architectural or product decisions
context — background info about user/project
followup — things to revisit

See references/api.md for full API reference.