接入 OhMy.xin

手里有 keystore.json 和 Client Secret 了？那这一步大约两分钟。还没有的话，先看 在 Mixin 创建机器人。

步骤

下面的演示从 OhMy.xin 这半段开始；点前面的步骤可以回看每样东西是从哪来的。

🤖Mixin Developers✨OhMy.xin

🔒ohmy.xin/mx_apps/new

Mixin Developers📱用 Mixin Messenger 扫码

要带去 OhMy.xin 的两样东西🔐Client Secret📄keystore.json

回到 OhMy.xin，打开 工作台 → 新建圈子，点 我已准备好凭证。

← 上一步第 5 步，共 7 步下一步 →

1. 1在电脑上打开 developers.mixin.one，用 Mixin Messenger 扫码登录。
2. 2点 New App（新建应用）。Name、Category 和 Description 就是成员将来看到的名称、分类和简介。Home URL 和 OAuth URL 先随便填一个 https 地址，比如 https://mixin.one —— 稍后 OhMy.xin 会自动替你改好。点 Save 保存。
3. 3打开 Secret 标签页。在 App Session 卡片点 Generate a new key，再点 Download。下载的文件以机器人的 Mixin ID 命名，比如 keystore-7000101234.json —— 它就是 keystore。（也可以点 Copy，把内容粘贴到 OhMy.xin。）
4. 4在 OAuth Client Secret 卡片点 Generate a new secret，再点 Copy —— 这串字符就是 Client Secret。两样都只显示一次。WALLET 和 Code URL 用不到，可以跳过。
5. 5回到 OhMy.xin，打开 工作台 → 新建圈子，点 我已准备好凭证。
6. 6把 keystore.json 拖进框里，或粘贴文件里的内容 —— 出现四个绿勾就说明读取成功。在下方粘贴 Client Secret，点 启动机器人。
7. 7OhMy.xin 会验证密钥，并替你在 Mixin 上填好主页地址、回调地址和资源匹配规则。五个绿勾全亮，圈子就建好了。

点浏览器里或下方托盘里发光的位置，或点「下一步」。

不用再回 Mixin 改设置

你在 Mixin 上填的 Home URL 和 OAuth URL 只是占位。自动配置时，OhMy.xin 会替你把真正的主页地址、OAuth 回调和资源匹配规则写进机器人。

123

真实向导的第 2 步。

1. 你在三步中的第 2 步。
2. 把 keystore.json 拖进来或粘贴，也可以点「选择文件」。
3. 粘贴 Client Secret —— 它不在 keystore 里。

一个机器人只能接一个圈子

如果这台机器人曾被其他圈子接入，需要先在原圈子断开连接，才能接入新圈子。断开不影响机器人在 Mixin 侧的存在，重新接入即可恢复。

如果出了问题

「JSON 无效 — 请粘贴完整的 keystore.json 内容」

只粘贴了文件的一部分，或者把别的东西（常见是 Client Secret）粘进了 keystore 框。最省事的做法：点 选择文件 直接选 keystore.json，不要手动粘贴。若要粘贴，从第一个 { 复制到最后一个 }。

「缺少字段：app_id, session_private_key, …」

这是旧式会话生成的文件，字段名不同。回到 developers.mixin.one，在 Secret → App Session 点 Generate a new key，用新文件即可。

点启动机器人后提示凭证错误

keystore 和 secret 不是一对，或者其中一个后来又重新生成过。确认两者来自同一个机器人，并且都用 最新 的那一份。

「自动配置需要重试」

机器人已经保存好了，只是 Mixin 资料更新没完成，通常是 Mixin 暂时连不上。点 重试自动配置 即可，不需要回 developers.mixin.one 改任何东西，重试是安全的。

相关页面

• 在 Mixin 创建机器人
• 上线清单
• 机器人：圈子如何运作