Even G2の「Even AI」をGrokに差し替えて、グラスからAIアシスタントに仕事を頼む


前回の記事では、Even Hub SDK を使って Even Realities G2 スマートグラスで動くアプリを作りました。今回はグラス側のアプリは作らず、G2 に最初から入っている音声アシスタント「Even AI」の向き先を、自分で用意したサーバーに変えてみました。

できるようになったのは次のことです。

  • 「Hey Even」のあとに話した内容が、自分の Cloudflare Worker に届きます。
  • 普通の質問には、xAI の Grok が短く答えます。
  • 「ボットに〜して」と話すと、自分の AI アシスタントの Grok Bot に仕事が渡ります。あとで「結果は?」と聞くと、結果がグラスに表示されます。

2026年10月20日に実機で動くことを確認しました。ここに記載した内容は、Even Realities、xAI、Cloudflare の英語の公式ドキュメントで公開されている情報と、参考リンクに挙げた第三者の実測に基づいています。公式に記載がなく私の環境で起きたことは、「私の環境では」と前置きして書きます。

仕組み

全体の流れは次のとおりです。

G2 グラスから Bluetooth でスマホの Even アプリへ、アプリから HTTPS で Cloudflare Worker へつながり、Worker が普通の質問を xAI API(Grok)に、「ボットに〜して」を Grok Bot に、「結果は?」を Workers KV に振り分ける構成図

Cloudflare Workers® は、Cloudflare のネットワーク上で JavaScript や TypeScript を動かすサーバーレスの実行環境です。Workers KV は、キーと値の組でデータを保存できる、Workers 向けの保存先です。webhook は、決まった URL に HTTP リクエストを送って別のサービスに知らせる仕組みで、ここでは Worker から Grok Bot に仕事を渡すのに使っています。

Even アプリにエージェントを登録する

Even アプリの Settings → Even AI → Agent Configuration から、独自のエージェントを登録できます。このメニューは EvenHub(Even Realities の開発者向けプラットフォーム)に開発者として登録しているアカウントにだけ表示されます。前回のアプリづくりで開発者登録をしていたので、私の環境ではそのまま表示されました。

登録では、名前、エンドポイントの URL、トークンを入れます。Even の公式チュートリアルによると、URL は /v1/chat/completions まで含めたフルパスで入れ、トークンは API Key の欄に入れます。

公式の手順の最後は「Save & Activate をタップ」です。ただ、私の環境では保存しただけでは切り替わらず、エージェントの一覧で名前をタップして選び直す必要がありました。第三者の2つの記事にも同じことが書かれているので、アプリの版によって表示が違うのかもしれません。

アプリから届くリクエスト

Even アプリは、OpenAI 互換の API(OpenAI の Chat Completions API と同じ形でやり取りできる API)にリクエストを送ります。公式の資料はありませんが、第三者の実測によると、次のような形です。

POST https://even-g2-agent.example.workers.dev/v1/chat/completions
User-Agent: EvenCore/1.0
Authorization: Bearer <EVEN_AGENT_TOKEN>
x-openclaw-agent-id: main
Content-Type: application/json

{"model":"openclaw","messages":[{"role":"user","content":"今日の東京は雨?"}]}
  • model はいつも openclaw です。
  • messages には、起動語を除いた最新の発話が1件だけ入ります。
  • stream は付かず、ストリーミングの応答(Server-Sent Events、SSE)も読みません。
  • 認証は Bearer 認証(Authorization: Bearer <トークン> ヘッダでトークンを渡す方式)です。
  • グラスに表示されるのは、応答の choices[0].message.content です。

User-Agent の値は、別の第三者のリポジトリ(fuschini/eveng2-agent-poc)では Dart/3.8 (dart:io) と報告されているので、版によって変わる可能性があります。私の Worker は User-Agent やヘッダの値では分岐せず、ログに残すだけにしています。

Worker の作り(普通の質問)

普通の質問は、Worker が xAI の API に中継します。xAI の API は https://api.x.ai/v1 をベース URL にした OpenAI 互換の API で、モデルは grok-4.7 を使いました。Worker から xAI へは stream: false を付けて送り、まとめて返ってきた答えをアプリに返します。なお、xAI の公式ドキュメントは Chat Completions を以前からの方式(legacy)と位置づけていて、新しく作るなら Responses API を勧めています。

設定は wrangler.jsonc(Cloudflare の CLI ツール Wrangler の設定ファイル)にまとめています。秘密の値は secrets に置き、ここには書きません。

{
  "name": "even-g2-agent",
  "main": "src/index.ts",
  "vars": {
    "UPSTREAM_BASE_URL": "https://api.x.ai/v1",
    "UPSTREAM_MODEL": "grok-4.7",
    "GROK_WEBHOOK_URL": "https://example.com/webhook",
    "MAX_REPLY_CHARS": "200"
  },
  "secrets": {
    "required": ["EVEN_AGENT_TOKEN", "RESULTS_TOKEN", "UPSTREAM_API_KEY", "GROK_WEBHOOK_KEY"]
  },
  "kv_namespaces": [{ "binding": "RESULTS", "id": "<KV_NAMESPACE_ID>" }]
}

グラスに収まる長さにする

G2 の表示領域は 576×288 で、前回の記事で触れた画面の制約が、今回は「返答を何文字に収めるか」という形で効いてきます。第三者の実測では、描画は400〜500字ほどで止まるそうです。

そこで Worker では、次のようにしています。

  • システムプロンプトで、スマートグラス向けの短い答えにすること、Markdown や箇条書き、絵文字を使わないこと、最初の文で結論を言うことを指示します。
  • 返ってきた答えから、コードブロックやリンク記法、箇条書きの記号、絵文字を取り除きます。
  • 200字を目安に切ります。文の切れ目で切れないときは末尾に ... を付けるので、実際には200字前後になります。

私の環境では、curl(コマンドラインから HTTP リクエストを送るツール)で日本語の質問を送ったときの往復時間は3.9〜6.5秒でした。グラスから話しかけたときは、Worker が最初のバイトを返すまで約3.8〜4.4秒でした。日本語の音声認識も、グラスでの日本語の表示も問題ありませんでした。

Even の公式チュートリアルでも、エージェントを保護なしで公開のインターネットに出さないよう注意しています。この構成では Worker を公開の URL に置いているので、アプリから届く Bearer トークンを Worker 自身が確かめ、合わなければ HTTP 401(認証の失敗)を返します。第三者のリポジトリによると、アプリが送れるのは Bearer トークンだけなので、追加のヘッダが必要な仕組みを前に置くことはできません。

Grok Bot に仕事を頼む

「ボットに〜して」と判定された発話は、Grok Bot の webhook ルーティンに送ります。送る中身は次の3つです。

{ "text": "ボットに明日の予定を調べてって", "requestId": "req_0123456789abcdef01234567", "receivedAt": "2026-10-20T03:43:00.000Z" }

webhook が受け付けたら、Worker は Grok Bot の処理が終わるのを待たず、グラスにすぐ「Grok Botに頼んだよ。あとで『結果は?』と聞いてね」と返します。

Grok Bot は仕事を終えると、requestId を付けて Worker の POST /results に結果を書き戻します。このエンドポイントは、アプリ用とは別のトークンで守っています。

curl -s "https://even-g2-agent.example.workers.dev/results" \
  -H "Authorization: Bearer $RESULTS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"requestId":"req_0123456789abcdef01234567","text":"(結果の要約)"}'

結果は Workers KV に保存し、グラスで「結果は?」と聞くと、最新の結果が200字前後で表示されます。ほかにも結果があるときは、字数に余裕があれば末尾に「ほか1件」と添えます(今の作りでは、件数にかかわらず「ほか1件」と表示されます)。詳しい結果は Grok Bot のチャットに届くので、グラスには短い要約だけを出しています。

実際に、グラスで「ボットに今日の予定を教えて」と頼むと、Grok Bot が Google カレンダーを読んで、今日の予定を返してくれました。

なお、Workers KV は結果整合性(書き込みがすべての拠点に反映されるまで時間がかかる方式)なので、別の拠点からは変更が見えるまで60秒以上かかることがあります。書き戻した直後に「結果は?」と聞いても、まだ出ないことがあります。また、結果の一覧は「読んでから書き直す」作りなので、書き戻しが同時に来ると1件取りこぼすことがあります。どちらも個人で使う分には困りませんが、知っておくと迷いません。

ハマりどころ

xAI の API キーの作り方

xAI の API キー(API を使う権利を示す秘密の文字列)は、xAI Console の API Keys ページで作ります。公式のクイックスタートによると、使う前にクレジットを入れておく必要があります。

私は最初、x.ai/api のページから入ろうとして、grok.com(チャットのサービス)のほうに進んでしまい、しばらく迷いました。API を使うなら、最初から console.x.ai を開くのが近道です。私が作ったキーは xai- で始まっていました。

Cloudflare のアカウントトークンの確認先

Cloudflare の API トークンには、ユーザーに結びつくユーザートークンと、アカウントに結びつくアカウントトークンがあります。API リファレンスでは、確認用のエンドポイントもそれぞれ別です。

  • ユーザートークン: GET /user/tokens/verify
  • アカウントトークン: GET /accounts/{account_id}/tokens/verify

新しく作ったトークンは、アカウントトークンが cfat_、ユーザートークンが cfut_ で始まるので、どちらなのかは先頭の文字で見分けられます。トークン作成の手順書に出てくる確認コマンドは /user/tokens/verify のほうです。私の環境では、アカウントトークンをこちらで確かめようとして失敗し、/accounts/{account_id}/tokens/verify に変えたら確認できました。アカウントトークンは Workers と Workers KV にも対応しています。

Workers の fetch と redirect

デプロイしてから、2つのエラーに当たりました。

1つ目は TypeError: Illegal invocation です。テストしやすいように、fetch を別のオブジェクトに入れて deps.fetch(url, init) と呼んでいたところ、this が deps になってしまい、Workers ではこのエラーになりました。Cloudflare の公式ドキュメントにも、this が正しくない関数呼び出しで起きるエラーとして載っています。グローバルの fetch をアロー関数で包んで渡すと直りました。

const deps = {
  fetch: (input, init) => fetch(input, init), // グローバルの fetch を包んで呼ぶ
};

2つ目は redirect: "error" です。リダイレクト(別の URL への転送)を失敗として扱いたくて "error" を指定していましたが、Workers は Fetch 標準の error モードを実装しておらず、指定すると TypeError になります。公式ドキュメントのとおり redirect: "manual" に変え、3xx のステータスコードが返ったら失敗として扱うようにしました。"follow" にすると、Authorization ヘッダもリダイレクト先に送られてしまうので、"manual" のほうが安心です。

HTTP 402 が返ったとき

私の環境では、xAI の API から HTTP 402(Payment Required。支払いや残高の不足を示すステータスコード)が返り、personal-team-blocked:spending-limit というメッセージが付いていたことがあります。xAI の公式ドキュメントには、既定の請求上限($0)のままだとプリペイドのクレジットがなくなった時点でリクエストが拒否されること、請求上限に達すると上限を上げるまで応答が得られないことが書かれています。402 が返ったら、Console の Billing でクレジットの残高と利用上限を確かめてください。

音声の書き起こしのゆれと、判定をゆるくした話

一番の学びはここでした。

最初は「Botに頼んで」のようなフレーズとの一致で、Grok Bot に渡すかどうかを決めていました。ところが、G2 の音声認識(STT、Speech-to-Text。話した言葉を文字に起こすこと)の結果は、毎回同じではありません。私の環境では、「ボット依頼」「ボットに接続テスト依頼して」のように書き起こされることもあれば、「ボットに」が「夫に」になって「夫に今日の予定を教えてって」と書き起こされたこともありました。決まったフレーズとの一致だけでは、拾えない発話がたくさんありました。

そこで、判定を次のようにゆるくしました。

  1. 「結果は」などで始まる発話は、まず結果の照会として扱います。ほかの語が入っていても、照会を優先します。
  2. 「ボットに」「Grok Bot」などのフレーズを含む発話は、仕事を頼む発話として扱います。
  3. それ以外でも、ボット語(ボット、ぼっと、bot、グロック、ぐろっく、grok)と、依頼語(頼、たの、依頼、お願い、おねがい、やって、して、調べて、登録)が両方入っていれば、語順に関係なく仕事を頼む発話として扱います。
  4. どれにも当てはまらなければ、普通の質問として Grok に送ります。

比べる前に、発話を NFKC(Unicode の正規化方式の1つで、全角英数字を半角にそろえるなど、見た目が同じ文字を同じ形にそろえる方式)でそろえ、空白を取り除き、小文字にしています。これで Grok Bot と grokbot と GROK を同じように扱えます。

export function decideUtterance(text, delegateTriggers, resultTriggers, botWords, requestWords) {
  if (isResultQuery(text, resultTriggers)) return { type: "result" };          // 「結果は」で始まれば照会を優先
  if (containsTrigger(text, delegateTriggers) || matchesBotAndRequest(text, botWords, requestWords)) {
    return { type: "delegate" };                                               // フレーズ一致か、ボット語+依頼語
  }
  return { type: "answer" };                                                   // それ以外は Grok に質問
}

この判定では、「ボットって何?」は依頼語がないので、普通の質問のまま Grok が答えます。一方で、「夫に今日の予定を教えてって」のようにボット語そのものが書き起こされなかった発話は、今の判定でも拾えません。拾いたい語をリストに足すことはできますが、そのぶん誤って仕事を頼んでしまう発話も増えます。

ゆるくしたぶん、誤って仕事を頼んでしまう例もあります。例えば「グロックってどうして速いの?」は、「どうして」の中に依頼語の「して」が入っているので、Grok Bot に渡ってしまいます。「ボットについて教えて」も、「ボットに」というフレーズを含むので同じです。「ボットに頼まない」のような否定も、今の判定では仕事を頼む発話になります。取りこぼしと誤判定のどちらを許すかの釣り合いで、今は「取りこぼさないほう」に寄せています。

同じ発話が2回届く

第三者の記事では、Even アプリが同じリクエストを数ミリ秒の差で2回送ることがあると報告されています。そのまま処理すると、Grok Bot に同じ仕事が2回届いてしまいます。

そこで、requestId を「正規化した発話」と「10秒ごとの枠の番号」から作るようにしました。同じ発話が同じ10秒の枠に入れば、同じ requestId になります。Grok Bot には、同じ requestId は1件として扱うようにしてもらっています。

export async function delegationRequestId(text: string, nowMs: number): Promise<string> {
  const bucket = Math.floor(nowMs / 10_000); // 10秒ごとの枠
  const payload = new TextEncoder().encode(`${normalizeUtterance(text)}|${bucket}`);
  const digest = await crypto.subtle.digest("SHA-256", payload);
  const hex = [...new Uint8Array(digest)].slice(0, 12).map((b) => b.toString(16).padStart(2, "0")).join("");
  return `req_${hex}`;
}

ただし、2回のリクエストが枠の境目をまたぐと、別の requestId になります。「10秒以内の重複を必ず防ぐ」仕組みではなく、「ほとんどの重複をまとめる」仕組みです。

まとめ

Even G2 の Even AI を、自前の Worker 経由で Grok と Grok Bot につないで分かったことを整理します。

  1. 登録: Agent Configuration は EvenHub の開発者アカウントで表示されます。URL はフルパスで入れ、私の環境では保存後に一覧で選び直す必要がありました。
  2. リクエスト: アプリは OpenAI 互換の形で、最新の発話を1件だけ送ります。ストリーミングは使いません。
  3. 長さ: 576×288 の画面に合わせて、Markdown を取り除き、200字前後に収めます。
  4. 委任: 仕事を頼む発話は webhook で Grok Bot に渡してすぐ返事をし、結果は Workers KV に書き戻して「結果は?」で読みます。
  5. Workers のハマりどころ: fetch は this を失わない形で呼び、redirect は "manual" にします。
  6. 判定: 音声の書き起こしは揺れるので、ボット語と依頼語の両方が入っているかで判定するようにゆるくしました。その代わり、誤って仕事を頼んでしまう例もあります。
  7. 重複: 同じ発話が2回届くことがあるので、10秒ごとの枠で同じ requestId にしてまとめます。

前回と同じく、公式の手順どおりにいかないところは、ログ(wrangler tail)で実際に届いたものを見ながら直していきました。グラスから話しかけるだけで仕事を頼めるようになり、手を止めずに用事を片付けられるのが便利です。

参考リンク


Cloudflare および Cloudflare Workers は、その権利者の商標または登録商標です。Grok および Grok のロゴは、その権利者の商標です。Even G2 は、その権利者の製品名です。そのほかの社名・製品名も、各社の商標または登録商標です。本記事は各社と提携しておらず、各社が推奨するものでもありません。