Grok Bot

读取 https://nowledgemem.study/SKILL.md，以及 Grok Bot 指南 https://nowledgemem.study/zh/docs/integrations/grok-bot。使用已经配置好的 Nowledge Mem MCP 连接器搜索我的记忆，并把一条有明确范围的测试决策保存到指定 Space。不要使用 localhost。除非 Grok Bot 提供了有文档说明的导出或 hook，否则不要声称会自动捕获完整会话。

这是什么

这是 Grok 的云端自定义 connector 路径。xAI 已向所有 Grok 用户开放 connectors；同一个 connector 可以在普通 Grok 对话中使用，也可以为 Bot 启用。它不同于可以加载本地 plugin 的编程智能体 Grok Build。想把 Grok 网页对话捕获进 Mem，请使用浏览器扩展；想让 Grok 搜索或更新 Mem，请使用这条 connector 路径。创建自定义 MCP connector 与给 Bot 启用它是两个独立步骤。

连接 Mem

Grok Bot 无法访问你电脑上运行的服务。请使用 Nowledge Cloud，或使用通过 Access Anywhere 暴露、并经过认证的公开 HTTPS 地址。

连接 Bot 不要求 Plus 或 Max。Access Anywhere 的 Quick link 不需要订阅、Cloudflare 账号或自有域名即可使用。Plus 和 Max 包含稳定托管的 Nowledge Link；如果你有由自己管理的 Cloudflare 域名，也可以用它提供稳定地址。

客户端入口可参阅 Grok 官方连接器说明。MCP 是可靠的连接路径。请在 grok.com/connectors 创建自定义 connector，不要在 Bot 的 Plugins 页面里创建。如果 Bot 或团队还开放了共享的 Nowledge Mem 包，可以再单独启用，以使用宿主支持的 skills 和生命周期 hooks。这个包不会绕过 Grok 的团队策略，也不会让 Mem 获得 Bot 的私有数据。

1. 使用本机工作区时，保持 Mem 运行，在 Settings → Access Anywhere 选择连接方式。然后打开 连接 → AI 工具，点击 Grok Bot 卡片上的 安装。本机桌面应用会按需启动 Access Anywhere、复制公网 MCP 地址，并打开浏览器配对页。若隧道还需要配置，先完成配置。远程访问本机工作区时，先在运行 Mem 的电脑上启动隧道。
2. 使用 Hosted Cloud 工作区时，从 连接 → AI 工具 复制完整 MCP 地址，保留 ?space_protocol=exact-v1，并使用 Cloud 登录。跳过本机配对和 Access Anywhere。
3. 打开 grok.com/connectors，选择 New Connector → Custom，粘贴 MCP 地址，认证选择 OAuth。Business 或 Enterprise 团队须先由管理员配置，成员才能使用。不要粘贴 Mem API key 或 Tunnel token。
4. 本机工作区的配对页和 OAuth 授权页应使用同一个浏览器 Profile。Cloud 若要求登录，打开登录链接，在新标签页完成登录，再回到授权页点击 Continue after sign-in。核对工作区和请求的权限后允许访问。
5. 在 Bot 的 Settings → Plugins 中启用连接器，让它搜索一条已保存的记忆。保存测试决策还需要客户端请求并获批 mem:write。保存一条名称明确的测试记忆，再让 Bot 按返回的 ID 读回，确认内容与目标 Space。

使用复制出的公网 HTTPS 地址，路径为 /mcp；Cloud 还需保留查询参数。不要填域名根、/remote-api/mcp、局域网地址、localhost 或 127.0.0.1。Bot 使用本机连接期间，Mem 和隧道都需保持运行；MCP 请求会直达你公开的端点。

可以做什么

• 通过 MCP 搜索记忆、读取上下文、提炼内容并按范围写入
• 使用与其他远程客户端相同的 Cloud/App Space 和身份规则
• 通过 sync_thread 保存客户端提交的对话快照，前提是服务器提供该工具，且客户端获批 threads:sync
• 当多个 Bot 共用一个账号时，为每个长期角色显式配置身份

保存对话快照

Mem 版本需包含 sync_thread。Grok 连接器必须显式请求 threads:sync，并由你批准；threads:read 用于读取对话，mem:write 用于写入记忆。旧的只读连接需要带所需权限重新授权。刷新工具列表不会增加权限，threads:write 也不能授权 sync_thread。如果 Grok 无法请求权限或提交原文，这条路径就不能保存对话。

确认 Bot 的工具列表里出现 sync_thread 后，先用两条测试消息验证：

请通过 Nowledge Mem 的 sync_thread 保存下面两条测试消息。
为本次测试使用新的会话 ID、外部来源和稳定消息 ID，只保存这些原文并展示回执。
user：这是 Grok Bot 连接测试。
assistant：这是一条合成测试回复。

成功回执应包含 snapshot_saved: true，首次新增两条消息。再让 Bot 使用相同会话 ID、来源、消息 ID 和回执返回的 space_id 重发同一快照，messages_added 应为 0。在 Mem 的 Threads 中打开对话，核对原文、角色和顺序。这只验证提交的测试消息，不代表 Bot 已取得完整历史。

后续补齐历史时，提交全部已保存消息和缺失消息，保持会话顺序，以及原有来源、会话 ID、消息 ID、角色与原文。不要只发新增部分，也不要用摘要代替原文。响应丢失时，用相同 ID 重发同一快照。保存对话不会自动提炼成记忆。

单次快照最多包含 5,000 条消息，每条原文最多 256 KiB，原文总量最多 8 MiB，均按 UTF-8 字节计算；Cloud 可能采用更低的单条上限。每次新增消息都要提交完整的已保存历史并满足上限，不能拆成互不相干的小批次绕过限制。

MCP 连接不会自动导入每一段 Grok Bot 对话。目前没有经过验证、可用于自动捕获完整对话的 Bot 专属导出或 hook，也没有 nmem t sync --from grok-bot 命令。Mem 只能保存客户端提交的原文。如果你有受支持的导出文件，请使用导入已有对话。

身份和 Space

如果一个 Bot 代表长期角色，请在 Mem 中显式配置这个角色。不要把 Bot 的显示名称或 source_app 当作身份选择器。Space 和访问范围始终由服务器负责。

排查问题

• 连接器无法连接： 确认 MCP 地址是公开 HTTPS，而不是 loopback 或私有局域网地址。
• 点击 Continue 没反应： 先在 Mem 打开的新标签页完成登录，再回到授权标签页点击 Continue after sign-in。
• 配对或授权过期： 本机工作区可再次点击 Grok Bot 卡片的 安装，取消当前配对并打开新的配对页；授权仍使用同一个浏览器 Profile。Cloud 则从 Grok 重新发起授权。
• 缺少 sync_thread 或调用被拒绝： 检查 Mem 版本、客户端工具列表及 threads:sync 授权，带所需权限重新连接。
• 快照被拒绝： 按原顺序提交全部已保存消息，保留原 ID、角色和原文，并沿用回执的 space_id。
• 本机公网地址变了： 更新连接器 URL 并重新授权。需要固定地址时，配置 Nowledge Link 或自有域名。
• 看不到记忆工具： 先确认自定义 connector 已出现在 grok.com/connectors，再重新加载 Bot，并在 设置 → Plugins 中启用它。
• 团队成员无法连接： 请团队管理员检查 MCP 允许列表，以及是否允许成员添加自己的服务器。
• Bot 搜索到了错误的 Space： 检查远程 Mem 连接和显式的 Space/身份配置。不要为了让连接成功而新建 Space。

本地编程智能体的独立路径请参阅 Grok Build。