Acontext

🌐 网站 | 📚 文档

什么是 Acontext？

Acontext 是一个用于 AI Agent 的开源技能记忆层。它能够自动捕获 Agent 运行过程中的学习成果，并将其存储为智能体技能文件 (agent skill files)——这些文件你可以直接阅读、编辑，并在不同的 Agent、LLM 和框架之间共享。

如果你希望你构建的 Agent 能够从错误中学习并复用有效的经验，同时又不想让不透明的记忆污染你的上下文，那么请尝试一下 Acontext。

技能就是你所需要的一切

Agent 的记忆正变得越来越复杂🤢——难以理解、难以调试，用户也难以检查或纠正。Acontext 采取了不同的方案：如果 Agent 技能可以用简单的文件来表示 Agent 所需的每一项知识，那么记忆也同样可以。

• Acontext 以 Agent 技能格式构建记忆，因此任何人都可以查看并理解记忆中实际包含的内容。
• 技能即记忆，记忆即技能。无论技能是你从 Clawhub 下载的，还是你自己创建的，Acontext 都能跟踪它并使其随时间演进。

Acontext 的设计理念

• 纯文本文件，兼容任何框架 — 技能记忆就是 Markdown 文件。你可以将其与 LangGraph、Claude、AI SDK 或任何能读取文件的工具一起使用。没有向量嵌入 (embeddings)，没有 API 绑定。你可以通过 Git、grep 以及挂载到沙箱中使用。
• 由你设计结构 — 通过附加更多技能来定义记忆的架构、命名和文件布局。例如：每个联系人一个文件，或通过上传工作上下文技能来为每个项目创建一个文件。
• 渐进式披露，而非搜索 — Agent 可以使用 get_skill 和 get_skill_file 来获取其所需的内容。检索方式是通过工具调用和推理，而不是语义上的 Top-K 搜索。
• 导出为 ZIP，随处复用 — 将技能文件导出为 ZIP。可以在本地、其他 Agent 或其他 LLM 中运行。无厂商绑定；无需重新嵌入 (re-embedding) 或迁移步骤。

工作原理

存储 — 技能是如何被记忆的？

flowchart LR
  A[Session messages] --> C[Task complete/failed]
  C --> D[Distillation]
  D --> E[Skill Agent]
  E --> F[Update Skills]

• 会话消息 (Session messages) — 对话（以及可选的工具调用、产出物）是原始输入。任务会自动从消息流中提取（或从明确的结果报告中推断）。
• 任务完成或失败 — 当任务被标记为完成或失败时（例如通过 Agent 报告或自动检测），该结果就是学习的触发点。
• 提炼 (Distillation) — 通过 LLM 对话和执行轨迹进行分析，推断出哪些是有效的、哪些是失败的以及用户的偏好。
• 技能 Agent (Skill Agent) — 决定存储位置（现有技能或新技能），并按照你的 SKILL.md 架构进行写入。
• 更新技能 (Update Skills) — 更新技能库。你在 SKILL.md 中定义结构，系统负责执行提取、路由和写入。

回调 — Agent 如何在下一次运行中使用技能

flowchart LR
  E[Any Agent] --> F[list_skills/get_skill]
  F --> G[Appear in context]

为你的 Agent 提供 技能内容工具 (Skill Content Tools)（即 get_skill 和 get_skill_file）。Agent 会自行决定它需要什么，调用这些工具，并获取技能内容。无需嵌入搜索 —— 渐进式披露，Agent 参与其中。

🪜 使用它来优化你的 Agent

Claude Code:

Read https://acontext.io/SKILL.md and follow the instructions to install and configure Acontext for Claude Code

OpenClaw:

Read https://acontext.io/SKILL.md and follow the instructions to install and configure Acontext for OpenClaw

🚀 快速入门

连接到 Acontext

1. 前往 Acontext.io，领取你的免费额度。
2. 完成一键入门流程以获取你的 API Key（以 sk-ac 开头）。

💻 自托管 Acontext

我们提供了 acontext-cli 来帮助你快速进行概念验证 (PoC)。首先在你的终端中下载它：

curl -fsSL https://install.acontext.io | sh

你需要安装 docker 并准备一个 OpenAI API Key，以便在计算机上启动 Acontext 后端：

mkdir acontext_server && cd acontext_server
acontext server up

请确保你的 LLM 具备 调用工具 的能力。默认情况下，Acontext 将使用 gpt-4.1。

acontext server up 将为 Acontext 创建或使用 .env 和 config.yaml 文件，并创建一个 db 文件夹来持久化数据。

完成后，你可以访问以下端点：

• Acontext API 基础 URL: http://localhost:8029/api/v1
• Acontext 控制面板: http://localhost:3000/

安装 SDK

我们维护了 Python 和 Typescript SDK。以下代码片段使用 Python 示例：