Troubleshooting

The plugin is missing

Check the install path, the plugins.entries.antigravity.enabled flag, and that the Gateway restarted after the change. Doctor can diagnose registered provider state, but doctor cannot repair discovery when the plugin never loaded.

hook registration missing name

0.2.0 aborted registration by calling registerHook without a name. This plugin registers provider guidance as the provider system-prompt contribution and does not register that hook. Restart the Gateway after installing the plugin.

agy is missing

Run agy models in the Gateway environment. If the shell finds a different binary or no binary, set plugins.entries.antigravity.config.command to the absolute path of the intended executable.

Reconnect reports that hard tool-free mode is unavailable

Install agy 1.2.1 or newer. Reconnect uses a bundled custom agent with built-in components excluded so OpenClaw can run its connection probe without tools.

Authentication fails

Follow the authentication recovery procedure: sign in through agy, verify with agy models, and keep credentials out of OpenClaw configuration.

A model is missing after connect

Use antigravity-cli/<model>. Reconnect the provider so the current agy models list is saved on the provider. Reconnect does not change agents.defaults.models or a model allow policy.

A tool call waits for approval

Non-interactive print mode cannot answer prompts. Keep the default mode: accept-edits, or choose none only when the intended agy permission handling works for the deployment. Enable skipPermissions only after accepting the security tradeoff.

/compact is unsupported

Antigravity owns automatic compaction of its native conversation. The plugin does not expose a manual compaction command because headless agy does not provide a machine-readable acknowledgement that /compact compacted the conversation. Its current event format also omits dedicated compaction status events.

A stream ends without a terminal result

The plugin requires a terminal AGY result and a successful process exit. A truncated stream can contain partial text or completed tool actions. Check those actions before retrying; the error does not roll them back.