ドキュメント · ガイド
OpenMausBot を任意のモデルで
OpenMausBot はオープンソースの Electron チャットアプリで、そのボットはコンピューターにインストールされた CLI を動かします。設定はデータフォルダーの config.json にあり、$OMB_DATA_DIR があればそこ、なければどのシステムでも ~/.openmausbot です。ボットが使える各エンジンはこのファイルの instances の 1 項目です。magpie はここに自分のエンジン magpie を加えるので、ボットが DeepSeek・GLM・Kimi・Qwen・Claude・ChatGPT サブスクリプションなど magpie のモデルで動きます。
OpenMausBot の設定
- magpie でプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
- OpenMausBot を終了OpenMausBot が開いている間、magpie は変更を断ります(Windows では開いているか分からないので、先に終了してください)。
- エージェント ページで OpenMausBot のプロバイダーを magpie にするmagpie はすべての magpie のモデルを magpie エンジンのピッカーに入れます。
- OpenMausBot を開き、ボットのエンジンに magpie を選ぶそれからエンジンのピッカーでモデルを選びます。
magpie エンジン
専用のエンジンが要る理由:OpenMausBot の Claude ボットは Claude Code を隔離して動かし、~/.claude/settings.json のサインイン関連のキーだけを引き継ぐので、magpie につないだ Claude Code はゲートウェイに届いても、ピッカーには Claude 自身のモデルしか出ません。Codex ボットは ~/.codex をそのまま使い、これは magpie の Codex の接続ですでにカバーされます。
magpie は OpenMausBot 自身が Claude エンドポイントを書く形でこのエンジンを書きます。access が custom の claudeAgent で、専用の Claude ホームを持ち、API キーを必須にし、ゲートウェイのアドレスと magpie のキーを ANTHROPIC_BASE_URL・ANTHROPIC_AUTH_TOKEN・ANTHROPIC_API_KEY に、すべての magpie のモデルを endpointModels に入れます。これらのキーを持つエンジンは自分でルーティングを決め、あなたの設定も OpenMausBot でのプロバイダー切り替えも届きません。OpenMausBot に自分の Claude Code を指定していれば、magpie エンジンもそれを使います。
// ~/.openmausbot/config.json
"instances": {
"magpie": {
"driver": "claudeAgent",
"displayName": "magpie",
"access": "custom",
"config": {
"configDir": "~/.openmausbot/providers/magpie",
"requireApiKey": true,
"endpointModels": […]
},
"environment": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:3425",
"ANTHROPIC_AUTH_TOKEN": "",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_MODEL": "…"
}
},
…
} 1M のモデルには [1m] が付きます。OpenMausBot が受け付けないモデル ID は除きます。そうした ID が 1 つでもあると、エンジン全体が拒否されるからです。
既定のエンジンはそのまま
config.json にエンジンが保存されていないとき、OpenMausBot は既定のエンジン群で動きます。保存された instances がエンジンのすべてなので、magpie のものだけを書くとほかのエンジンが消えてしまいます。そのためファイルにエンジンがないとき、magpie は既定のエンジン群を自分のものと一緒に書きます。
先に終了する理由
OpenMausBot は起動時にこのファイルを読み、設定でエンジンを 1 つ変えると、メモリにあるエンジン表をまるごと書き戻します。そのため開いている間は magpie が変更を断ります。同期はそれでも書き込み、OpenMausBot が上書きした分は次の同期か 30 秒以内に書き直されます。OpenMausBot がファイルより古いリストで動いているときは、magpie のエージェントページから再起動できます。
自分の設定はそのまま
magpie エンジンの名前・色・アイコン・オンかどうかと非表示かどうか、magpie が書かないキー、ルーティング以外の環境変数はあなたのものです。最初に選んだモデルも、magpie がまだ載せている限りそのままです。ルーティング、Claude ホーム、モデルのリストは magpie のものです。
元に戻す
magpie で OpenMausBot をオフにすると、magpie は自分のエンジンを取り除き、一緒に書いた既定のエンジン群もそのままなら取り除きます。OpenMausBot はその時点の既定のエンジンで動きます。
よくある質問
OpenMausBot のボットで DeepSeek や GLM を使えますか?
使えます。magpie が config.json に magpie エンジンを加えるので、ボットのエンジンにそれを選び、モデルを選んでください。
なぜ先に OpenMausBot を終了するのですか?
エンジンを変えるとエンジン表をまるごと書き戻し、magpie の変更を上書きするので、開いている間は magpie が変更を断ります。
ほかのエンジンは消えますか?
消えません。ファイルにエンジンが保存されていないとき、magpie は OpenMausBot の既定のエンジン群を一緒に書きます。
Codex ボットで magpie を使うには?
OpenMausBot の Codex ボットは ~/.codex をそのまま使い、magpie の Codex の接続ですでにカバーされます。
同じモデルを他のエージェントでも:Mistral Vibe を任意のモデルで、Pencil を任意のモデルで、Claude Desktop を任意のモデルで、JetBrains Copilot を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。