• 桌面应用
• AI Agent
• 人工智能
• 多智能体
• 代码智能体
• 浏览器控制
• 本地部署
• MCP 服务

OpenBot 是一款本地优先（local-first）的 AI 队友桌面工作台，而它的导入功能让你可以不用重新配置，就把 Grok Bot 中的 AI Agent 一键迁移到自己的电脑上——助手的名称、指令、头像、技能、定时任务、记忆，甚至群组频道，都会随一个.zip文件完整搬进 OpenBot。

🧐 OpenBot 导入功能能迁移哪些内容？

OpenBot 把 Grok Bot 的"Bot"整体打包为本地 Agent。一个导出文件可以包含：

整个过程完全在本地完成：OpenBot 直接读取你电脑上的.zip文件，不上传任何数据。

✅ 迁移前准备

1. 安装 OpenBot（支持 macOS、Windows、Linux）；
2. 有一个 Grok Bot 账号，且其中已有你想迁移的 Bot。

🚀 三步完成 Grok Bot 到 OpenBot 的迁移

第一步：把导出助手添加到 Grok Bot

在 OpenBot 中打开服务器设置 → 导入（ServerImportPanel.tsx），选择来源Grok Bot，会看到三步引导（界面文案见 zh/import.ts）。

第一步有两种方式：

• 安装该助手（推荐）：点击"打开导出助手"，在浏览器中一键安装 OpenBot 预置的 "OpenBot export" 助手，它自带导出技能；
• 自行配置：复制 OpenBot 内置的 openbot-export 技能 文件，粘贴到 Grok Bot 中一个仅用于导出的新助手里。

第二步：发送一条消息生成 .zip

把 OpenBot 引导页中的消息发给导出助手：

Export my agents for OpenBot

它会自动盘点你所有的 Bot 和群聊，询问是否包含工作区文件，然后把一切打包为openbot-export-<日期>.zip并保存到"下载"文件夹。导出格式由 SKILL.md 定义：一个openbot-import.json清单，加上每个助手的agents/<key>/文件夹。

第三步：在 OpenBot 中选择 .zip 并确认导入

回到 OpenBot 的导入页面，点击选择导出文件，选中刚才的.zip。OpenBot 会先做一遍"预览"（AgentImportView.tsx）：

• 列出每个助手的名称、头像、技能数、定时任务数、记忆数和文件大小；
• 可以按助手勾选，只导入你想要的一部分；
• 如果某个助手与本机已有同名助手，会弹出确认，导入将生成一个独立副本；
• 点击"导入"后，界面会逐个创建助手，并显示最终结果（成功数、跳过项和警告）。

🔒 安全机制：为什么可以放心导入

导入服务（agent-import-service.ts）内置了多重防线：

1. 拒绝敏感内容：.env文件、私钥、嵌套压缩包、.git和node_modules目录一律被拒，整个包直接无法导入；
2. 体积限制：整个压缩包不超过 500 MB、5,000 个文件；单个技能不超过 10 MB、200 个文件；
3. 先校验后落盘：文件在校验时只读清单和头像，秒出预览；应用导入时会重新比对 SHA-256，文件中途被改动会直接拒绝（agent-import-manifest.ts）；
4. 失败可回滚：某个助手导入中途出错时，它会被整体删除，其他助手继续导入，互不影响。

⚙️ 导入之后：频道、定时任务与模型切换

• Grok Bot 的群聊会变成 OpenBot 的共享频道：成员自动映射为刚导入的助手，原"lead"仍担任主导；
• 定时任务按原时区恢复，不支持的计划会给出警告并跳过，但助手本身照常导入；
• 导入后的助手使用本机默认配置，你可以再为每个助手选择 Codex、Claude Code、Grok CLI、Gemini 等任一服务商，或接入本地模型——这正是 OpenBot 本地优先的价值所在。

❓ 常见问题

迁移需要 Grok Bot 付费吗？只需要你原有的 Grok Bot 账号，导出助手在云端完成打包；OpenBot 侧对非商业用途免费。

能只迁移部分 Bot 吗？可以。预览界面中每个助手都有勾选框，取消勾选的不会被导入。

对话历史会迁移吗？不会。历史会话留在 Grok Bot，但记忆（memories）会保留助手学到的关键事实。

文件放错了目录怎么办？压缩包外多套了一层文件夹也能识别，OpenBot 会自动剥掉这一层；但清单文件缺失或格式不符会被整体拒绝。

📚 相关文档与源码

• 导入技能规范（Grok Bot 侧）：resources/agent-import/grok-bot/SKILL.md
• 导入清单解析：src/main/agent-import-manifest.ts
• 导入服务（预览 / 应用 / 回滚）：src/main/agent-import-service.ts
• 导入界面（引导 / 预览 / 结果）：packages/ui/src/features/import/AgentImportView.tsx
• 架构说明"Agent import"章节：docs/architecture/agents.md

• 桌面应用
• AI Agent
• 人工智能
• 多智能体
• 代码智能体
• 浏览器控制
• 本地部署
• MCP 服务