Menu
DBay 知识库 + 记忆 MCP，让 AI Agent 拥有跨会话长期记忆和知识检索能力。触发场景：用户要求记住某事、回忆之前的对话、搜索项目知识库、或需要跨会话保持上下文。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | dbay |
| description | DBay 知识库 + 记忆 MCP，让 AI Agent 拥有跨会话长期记忆和知识检索能力。触发场景：用户要求记住某事、回忆之前的对话、搜索项目知识库、或需要跨会话保持上下文。 |
| metadata | {"version":"1.0.0","author":"DBay","homepage":"https://dbay.cloud","repository":"https://github.com/MatrixDriver/dbay-cc"} |
DBay 为 AI Agent 提供两大能力：
检查 Python 3.10+ 和 pip 是否可用：
python3 --version && pip --version
pip install dbay-cli
dbay login
dbay login 会打开浏览器完成认证，API Key 存在 ~/.dbay/config.json，不会进入 Agent 配置文件。
没有桌面浏览器（远程服务器、容器、SSH 会话）？ 在本地浏览器登录 console.dbay.cloud → "API Keys" 复制一个 key，然后在远端手写：
mkdir -p ~/.dbay
cat > ~/.dbay/config.json <<EOF
{ "endpoint": "https://api.dbay.cloud:8443", "api_key": "lk_xxx" }
EOF
chmod 600 ~/.dbay/config.json
dbay mem create my-mem
dbay mem use my-mem
如需端到端加密记忆库：
dbay mem create --encrypted my-private-mem
根据不同平台执行对应命令。
每个平台的 MCP 配置都应该带上 DBAY_SOURCE 环境变量，DBay 用它给每条记忆打上"是哪个 Agent 写的"标签，溯源不会混。
claude mcp add --scope user dbay --env DBAY_SOURCE=claude-code -- uvx dbay-mcp
OpenClaw 自带 mcp set 子命令，直接跑这一条即可（自动写入 ~/.openclaw/openclaw.json 的 mcp.servers 块，已有条目会保留）：
openclaw mcp set dbay '{"command":"uvx","args":["dbay-mcp"],"env":{"DBAY_SOURCE":"openclaw"}}'
OpenClaw runtime 用 chokidar 监听配置文件，保存后会自动热重载，无需手动重启 gateway。验证：
openclaw mcp show dbay
如果你只想看真实 JSON 落盘形态，路径是 ~/.openclaw/openclaw.json，dbay 条目会出现在 mcp.servers.dbay 下。
在 ~/.hermes/config.yaml 的 mcp_servers 块下添加：
mcp_servers:
dbay:
command: "uvx"
args: ["dbay-mcp"]
env:
DBAY_SOURCE: "hermes-agent"
timeout: 60
connect_timeout: 30
重启 hermes gateway 使配置生效。
安装完成后，可用工具包括：
| 工具 | 用途 |
|---|---|
memory_recall | 语义检索记忆 |
memory_ingest | 存储记忆 |
memory_list | 列出记忆 |
memory_delete | 删除记忆 |
knowledge_search | 搜索知识库 |
knowledge_list_bases | 列出知识库 |
knowledge_list_documents | 列出文档 |
knowledge_get_chunk | 获取文档片段 |
每条记忆都通过 source 字段标识来源 Agent：
| Agent | source 值 |
|---|---|
| Claude Code | claude-code |
| OpenClaw | openclaw |
| Hermes Agent | hermes-agent |
推荐做法：按上一节在每个 Agent 的 MCP 配置里设 DBAY_SOURCE 环境变量，dbay-mcp 会把它作为 source 字段的默认值。这样调用 memory_ingest 时不用每次都显式传 source，也不会忘记。
如需在某次调用里临时覆盖（例如代理别的 Agent 写记忆），仍可显式传：
memory_ingest(content="用户的偏好是...", memory_type="fact", source="openclaw")
如果需要日志诊断、租户定位等 SRE 运维能力，可额外安装 dbay-sre-mcp：
pip install dbay-sre-mcp
配置环境变量后注册 MCP：
# 必需环境变量
export LOG_DB_DSN="postgresql://..."
export LAKEON_ADMIN_TOKEN="..."
export LAKEON_API_BASE_URL="https://api.dbay.cloud:8443/api/v1"
Claude Code:
claude mcp add --scope user dbay-sre-mcp -- dbay-sre-mcp
OpenClaw 在 ~/.openclaw/openclaw.json 的 mcpServers 块里添加 dbay-sre-mcp 条目；Hermes 在 ~/.hermes/config.yaml 的 mcp_servers 块里添加对应条目，env 字段需显式声明上述环境变量。
memory 工具 ≠ DBay 记忆Hermes Agent 内置的 memory 工具 只写入本地 ~/.hermes/ 目录，不会写入 DBay。要让信息进入 DBay 长期记忆，必须明确调用 DBay MCP 的 memory_ingest 工具或使用 dbay mem ingest CLI 命令。
在 Hermes 中保存到 DBay 的正确方式：
方式一（推荐 — MCP 工具，通过 uvx dbay-mcp）：
memory_ingest(content="...", memory_type="fact|decision|rejection|convention|procedural|episode", source="hermes-agent")
方式二（API 直调，当 MCP 未就绪时）：
from dbay_cli.client import DbayClient
client = DbayClient(base_url, api_key)
client.mem_ingest(
mem_id="mem_xxx",
content="...",
role="assistant",
memory_type="decision",
source="hermes-agent"
)
dbay mem ingest CLI 选项dbay mem ingest "..." [--type TYPE] [--source TAG] [--raw]
--type：fact|decision|rejection|convention|procedural|episode，默认 fact--source：来源标签（如 cli、claude-code、hermes-agent），默认 cli--raw：把内容当作原始对话，让服务端 LLM 自动抽取（signal="conversation"）。不加此选项时默认按结构化记忆直接落库（signal="memory"），跟 MCP memory_ingest 行为一致。历史注：旧版本曾有
--no-extract选项，因为客户端从未实现对应字段且会污染signal字段，已在 dbay-cli 修复后删除——升级到最新版即可，不要再用--no-extract。
memory_type 是必填项当 signal='memory' 时，API 要求 memory_type 字段。可选值：fact, decision, rejection, convention, procedural, episode。不传会返回 400 错误。
DBay 支持多个 Agent（Hermes / Claude Code / OpenClaw）连接同一个记忆库。每条记忆通过 source 字段（hermes-agent / claude-code / openclaw）标识来源。三个平台都配好 MCP 后，在一个平台上存储的记忆，其他平台均可 memory_recall 搜索到。
dbay-mcp 读取 ~/.dbay/config.json 获取 API Key，确保 dbay login 已完成~/.dbay/encrypted_bases.json，密码在 ~/.dbay/secret~/.dbay/ 目录即可迁移