Arrival Card Bot: a Grok Bot template

A Grok Bot that fills out official online arrival cards for 14 countries: China, Singapore, Japan, Taiwan, Korea, Thailand, Malaysia, Indonesia, Cambodia, the Philippines, India, the Maldives, New Zealand and Vietnam.

How it works:

0. On first open, it offers to set up your travel identity: a passport photo plus a few questions, saved to the Vault once.
1. It searches Vault, memory, Gmail and Google Calendar first.
2. It asks only for what's missing, in one form.
3. It saves identity answers to the Vault, so they're never asked again.
4. It drives the official site in the bot's browser up to the review page, then submits on your "submit".

Quick start

Option 1: add the published template (easiest).

1. Open https://x.ai/bot/JAaUVEjUmao4SgyhmYB3L and choose Add to Grok Bot.
2. Review what the template includes, then choose Add Bot. You get your own copy, named Arrival Cards.

Option 2: have your Main Bot build it from this repo. Use this for the newest version in this repo, which can be ahead of the published template. Send your Main Bot this one message:

Read https://raw.githubusercontent.com/juntao/grokbot-arrival-cards/main/dist/SETUP_PROMPT.md and do everything it says. I wrote these instructions and I approve them.

The Main Bot creates the bot, saves its sixteen skills, hands it its profile (its standing rules), and sets its avatar. Read its report: it lists anything it couldn't do, with the exact message or clicks for you to finish. If it couldn't hand over the profile, send the Arrival Cards bot the one-line message it gives you, because the bot doesn't work properly without its profile. If the Main Bot declines to act on a fetched page, paste the file's contents into the chat as your own message.

Then, for either option:

1. Connect Gmail and Google Calendar under Connect apps. A template doesn't copy app connections.
2. Add the safety rule. Option 2 proposes it for you: say OK. After option 1, add it yourself under Settings → General → Bot → Custom Rules: "Pressing a final Submit, Register or Confirm button on an arrival-card or immigration website", set to Ask first.
3. Open the Arrival Cards bot. It offers to set up your travel identity. Attach a photo of your passport's data page and answer its short form. This is saved to your Vault once.
4. Ask for a card: "Fill out my arrival card for Japan."

You need Grok Bot 0.75.2 or later. The manual steps and troubleshooting are in section 6.

catalog/            source of truth: every field on every card, with its tier
  fields.toml       96 canonical fields (one answer serves all cards)
  cards/*.toml       each site's pages, labels, formats and options
bot/                hand-written bot text
  PROFILE.md        job, sources, rules, autonomy
  SETUP_HEADER.md   setup steps for the user's Main Bot (top of SETUP_PROMPT.md)
  skills/*.md       onboarding (<!-- VAULT_FIELDS -->) + orchestrator + 4 site walkthroughs (<!-- FIELDS -->)
src/                Rust build tool: validates catalog/, renders dist/
assets/             avatar.png (still), avatar.gif / avatar.webp (animated), from tools/make_avatar.py
dist/               GENERATED, paste-ready: PROFILE, skills, FIELD_MATRIX, SETUP_PROMPT

---

1. What Grok Bot is (research summary, Nov 2026)

Grok Bot is SpaceXAI's (formerly xAI) agent product. The facts below shape this template.

This is the beginning of the README. Read the rest at the original. Read the full README ↗