Multica
先连接 Multica 启动的 AI 工具,再给每个 Multica Agent 一个独立的 Mem 身份。
Multica 会启动本机的 AI 工具来运行命名 Agent,例如 Claude Code、Codex、Pi、OpenCode 或 OpenClaw。Nowledge Mem 应该接在这个被启动的 AI 工具上,然后再给每个长期存在的 Multica Agent 一个 Mem 身份。
这样一来:
- 被启动的 AI 工具里的会话,可以通过该工具自己的 Nowledge Mem 连接和 hook 同步。
- MCP 要配置到 Multica Agent 上,不能只配在你当前打开的外层终端或另一个 Claude 会话里。
- 这个 Multica Agent 换 workspace、squad 或 AI 工具时,仍然沿用同一个 Mem 身份。
- Multica 自己的 workspace 历史是另一层。Multica 已通过 CLI/API 暴露 run 消息(
multica issue run-messages),但 Mem 目前还没有对接导入,这部分数据暂时留在 Multica 里。
设置
先把 Multica 启动的 AI 工具连接到 Mem。例如在运行 Multica daemon 的机器上安装 Codex、Claude Code、Pi 或 OpenClaw 连接。
如果这个 Multica Agent 使用 Claude Code,还要打开该 Agent 的 MCP 设置,把 Nowledge Mem 的 MCP 配置保存进去。当前版本的 Multica 会把 runtime 机器上的原生 MCP 配置(例如 ~/.claude.json,以及 Claude Code 插件带的 MCP server)与 Agent 保存的配置合并成一份任务级配置,再通过 --mcp-config 传给 Claude Code——所以装在 runtime 机器上的连接通常会自动带上。仍然建议保存在 Agent 上:同名时 Agent 配置优先,而且换 runtime 也不会丢。
本机 Mem 可以使用这段配置:
{
"mcpServers": {
"nowledge-mem": {
"url": "http://127.0.0.1:14242/mcp/",
"type": "streamableHttp",
"headers": {
"APP": "Claude Code",
"Authorization": "Bearer <your-nmem-api-key>",
"X-NMEM-API-Key": "<your-nmem-api-key>"
}
}
}
}你也可以直接生成当前机器的真实配置:
nmem config mcp show --host claude-code --json如果使用远程 Mem,把 URL 换成你的 Access Anywhere MCP endpoint,并保留 Mem 配置里的 token headers。不要把 --mcp-config 写进 Multica custom args;当前 Multica 会从 Agent 的 MCP 配置生成这个参数。
创建 Mem 身份:
nmem agents upsert cindy \
--name "Cindy" \
--default-space onboarding \
--instructions "帮助用户完成 onboarding。一次只解释一个步骤。"这会创建名为 Cindy 的 Mem 身份。命令和环境变量里使用的 ID 是 cindy。这个命令不会让所有 Codex 会话都变成 Cindy;只有设置 NMEM_AGENT_ID=cindy,或明确传入 agent_id="cindy" 的地方,才会使用这个身份。
然后把这个自定义环境变量添加到 Multica Agent:
NMEM_AGENT_ID=cindy如果 Cindy 移动到另一个 Multica workspace、squad 或 AI 工具,继续保留她的 ID。只有当底层 AI 工具变化时,才更新对应连接。
会同步什么
只有被启动的 AI 工具有可用的 Nowledge Mem 连接或 hook 时,新会话才会自动同步。例如 Claude Code 和 Codex 使用各自的 Nowledge Mem 连接;Pi 使用 Pi package;OMP 使用 OMP 插件。
Multica 本身是编排层。它的 issue 评论、workspace 历史和任务时间线是另一类数据。Multica 已经通过 CLI/API 暴露 run 消息(multica issue runs、multica issue run-messages)并推送任务事件;Mem 目前还没有对接导入,所以这些内容暂时留在 Multica 里。
Space
除非分配给这个 Multica Agent 的每个任务都应该使用同一个 Mem Space,否则不要设置 NMEM_SPACE:
NMEM_SPACE=onboarding如果这个 Agent 会跨多个 repo 或项目工作,让 Mem 身份自己的默认 Space 处理常见情况;只有明确需要时,再在具体任务里切换。
安全
不要把高权限密钥放进 Multica Agent 的环境变量。NMEM_AGENT_ID 是安全的,因为它只是身份选择器。Mem API key、模型 provider key、生产 token 应该限制权限,并通过运行时或 Mem client config 管理。