GoldHold -- Persistent Memory for AI Agents

You die every session and come back with no memory. GoldHold fixes that.

GoldHold is a persistent memory API. Your past self left notes -- search them before you assume anything. Store decisions, facts, and corrections so your future self isn't starting from zero.

Patent Pending. All Auto Tunes LLC. U.S. #63/988,484.

Setup

1. Sign up at goldhold.ai (Lite tier is free)
Go to goldhold.ai/account -> GUMP Credentials -> copy your API key
Set the key as an environment variable:

- GOLDHOLD_API_KEY=your-key-here - Use your OS or platform's secure secret storage (e.g. OpenClaw secrets, Docker secrets, or a secrets manager) - Avoid storing keys in shell profiles, plaintext files, or version-controlled code

API Basics

Base URL: INLINECODE1

Auth headers (required on every request):
CODEBLOCK0

Core Endpoints

POST /v1/auto -- Session Resume

Call this when your session starts. Returns your context, inbox, open tasks, and capability card.

CODEBLOCK1

Response includes recent memories, unread messages, and active tasks -- everything you need to pick up where you left off.

POST /v1/turn -- Search + Store + Send (Main Tool)

This is your primary endpoint. Compound call that can search, store, and send messages in one request.

CODEBLOCK2

All three fields (search, store, send) are optional. Use whichever combination you need.

POST /v1/batch -- Multiple Operations

Batch multiple store or send operations in one call.

CODEBLOCK3

POST /v1/session/close -- Graceful Session End

Call this once at the end of your session with a meaningful summary.

CODEBLOCK4

Session Pattern

CODEBLOCK5

What to Remember

Type	When to Use
FACT	Established truths, verified information
DECISION

Storage Classes

Class	Purpose	Retrieval Priority
canonical	Permanent truth, settled answers, standing directives	Checked first
corrections

Tier Limits

Feature	Lite (Free)	Vault Pro ($9/mo)
Memories	1,000	Unlimited
Agents

Rules

1. Search before you assume. Your past self left notes. Call /v1/turn with a search query before forming opinions or making claims about past work.
Store decisions and facts immediately. If something was decided, corrected, or established, store it in the same turn.
Use compact: true on all requests. Saves tokens.
One close per session. Call /v1/session/close once at the end with a meaningful summary.
Corrections outrank facts. If previous information was wrong, store a CORRECTION.
Be specific in subjects. Your future self is searching by these.

Quick Start

CODEBLOCK6

GoldHold —— AI智能体的持久化记忆

每次会话结束你都会死亡，重新开始时记忆全无。GoldHold 解决了这个问题。

GoldHold 是一个持久化记忆 API。你过去的自己留下了笔记 —— 在做出任何假设之前先搜索它们。存储决策、事实和修正，这样未来的你就无需从零开始。

专利申请中。All Auto Tunes LLC。美国专利号 #63/988,484。

设置

1. 在 goldhold.ai 注册（Lite 层级免费）
访问 goldhold.ai/account -> GUMP 凭证 -> 复制你的 API 密钥
将密钥设置为环境变量：

- GOLDHOLDAPIKEY=你的密钥 - 使用操作系统或平台的安全密钥存储（例如 OpenClaw secrets、Docker secrets 或密钥管理器） - 避免将密钥存储在 shell 配置文件、纯文本文件或版本控制代码中

API 基础

基础 URL： https://relay.goldhold.ai

认证头（每个请求必需）：

Authorization: Bearer
Content-Type: application/json
User-Agent: goldhold-agent/1.0

核心端点

POST /v1/auto —— 会话恢复

在会话开始时调用。返回你的上下文、收件箱、未完成任务和能力卡片。

json
{
compact: true
}

响应包含最近的记忆、未读消息和活跃任务 —— 你需要的一切，以便从上次中断的地方继续。

POST /v1/turn —— 搜索 + 存储 + 发送（主要工具）

这是你的主要端点。复合调用，可以在一个请求中搜索、存储和发送消息。

json
{
search: {
query: 关于部署策略我们决定了什么,
limit: 5
},
store: [
{
type: DECISION,
class: canonical,
subject: 部署采用蓝绿策略,
body: 决定采用蓝绿部署实现零停机发布。通过切换流量回滚。,
confidence: high
}
],
send: {
to: owner,
subject: 部署决策已做出,
body: 选择了蓝绿策略实现零停机部署。
},
compact: true
}

所有三个字段（search、store、send）都是可选的。使用你需要的任意组合。

POST /v1/batch —— 批量操作

在一个调用中批量执行多个存储或发送操作。

json
{
operations: [
{action: store, type: FACT, class: canonical, subject: ..., body: ...},
{action: store, type: NOTE, class: working, subject: ..., body: ...}
],
compact: true
}

POST /v1/session/close —— 优雅结束会话

在会话结束时调用一次，附带有意义的摘要。

json
{
session_summary: 完成了支付系统的 API 集成。决定使用 Stripe webhooks 处理订阅事件。未解决问题：失败 webhooks 的重试策略。,
compact: true
}

会话模式

会话开始 --> POST /v1/auto （获取上下文、收件箱、任务）
|
会话期间 --> POST /v1/turn （每次交互时搜索 + 存储）
| （重复）
|
会话结束 --> POST /v1/session/close （发生了什么事的摘要）

需要记住的内容

类型	使用时机
FACT	已确立的事实、已验证的信息
DECISION

存储类别

类别	用途	检索优先级
canonical	永久真相、已确定的答案、长期有效的指令	首先检查
corrections

层级限制

功能	Lite（免费）	Vault Pro（9美元/月）
记忆	1,000	无限制
智能体

1 | 无限制 | | 任务 | 10 | 无限制 | | 消息 | 50/月 | 无限制 |

规则

1. 先搜索再假设。 你过去的自己留下了笔记。在形成关于过去工作的意见或主张之前，先用搜索查询调用 /v1/turn。
立即存储决策和事实。 如果某件事被决定、修正或确立，在同一轮中存储它。
在所有请求中使用 compact: true。 节省令牌。
每个会话只关闭一次。 在会话结束时调用一次 /v1/session/close，附带一个有意义的摘要。
修正优先于事实。 如果之前的信息是错误的，存储一个 CORRECTION。
主题要具体。 你未来的自己会通过这些主题进行搜索。

快速开始

bash

恢复会话

curl -X POST https://relay.goldhold.ai/v1/auto \
-H Authorization: Bearer $GOLDHOLDAPIKEY \
-H Content-Type: application/json \
-H User-Agent: goldhold-agent/1.0 \
-d {compact: true}

搜索和存储

curl -X POST https://relay.goldhold.ai/v1/turn \ -H Authorization: Bearer $GOLDHOLDAPIKEY \ -H Content-Type: application/json \ -H User-Agent: goldhold-agent/1.0 \ -d {search: {query: 用户偏好}, store: [{type: FACT, class: canonical, subject: 用户偏好JSON, body: 已确认。}], compact: true}

关闭会话

curl -X POST https://relay.goldhold.ai/v1/session/close \ -H Authorization: Bearer $GOLDHOLDAPIKEY \ -H Content-Type: application/json \ -H User-Agent: goldhold-agent/1.0 \ -d {session_summary: 已配置输出偏好。}

在 goldhold.ai 免费注册。

goldhold持久记忆

goldhold

GoldHold -- Persistent Memory for AI Agents

Setup

API Basics