#gateway

1 messages · Page 1 of 1 (latest)

steep reefBOT
#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> âś… Mark Solution

limber mossBOT
#

That launchctl kickstart … Could not find service "ai.openclaw.gateway" error means there is no LaunchAgent registered/loaded under that label, so kickstart has nothing to start (it’s not a “gateway is crashing” message — it’s “service doesn’t exist”).

Fix path on macOS:

  1. Check what label you actually have (if any):
launchctl list | egrep 'openclaw|clawdbot'
  • If you see something like ai.openclaw.<profile> (or older com.openclaw.…), that’s the label to kickstart.
  • If you see nothing, the service simply isn’t installed.
  1. (Re)install the service, then restart it via the CLI (preferred):
openclaw --version
openclaw doctor
openclaw gateway install
# 
openclaw gateway status --deep
openclaw gateway restart

Docs: https://docs.openclaw.ai/gateway (macOS launchd section) and https://docs.openclaw.ai/cli/gateway

  1. Your app “can’t connect to server” is expected until the Gateway is actually running.
    After openclaw gateway status shows Runtime: running and ideally RPC probe: ok, connect the app to the local gateway (usually ws://127.0.0.1:18789) and make sure you’re using the correct token/password for that gateway.

If you paste the output of:

  • openclaw --version
  • openclaw gateway status --deep
  • and (if relevant) the launchctl list | egrep ... line(s)

…I can tell you exactly which of the above is missing (wrong label vs not installed vs wrong profile/port/auth).

rain walrus
#

how i can uninstall the app and remove every trace so i can start fresh again and see if i skipped gateway configuring

limber mossBOT
#

Use the built-in uninstaller — it’s the cleanest “start from zero” path.

1) If the CLI still works (recommended):

openclaw uninstall

To nuke everything without prompts:

openclaw uninstall --all --yes --non-interactive
# (or) npx -y openclaw uninstall --all --yes --non-interactive

That covers: stopping the gateway, uninstalling the service, and removing the default state dir.

2) If you also installed the macOS app:
Delete /Applications/OpenClaw.app (move to Trash).

#

3) If the CLI is gone but you want to remove launchd traces manually (macOS):

launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

(If you used a profile, the label/plist will be ai.openclaw.<profile>; also remove any old com.openclaw.* plists if you see them.)

4) Remove all local OpenClaw data (this deletes config/credentials/sessions):

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

Docs: https://docs.openclaw.ai/install/uninstall

After that, reinstall and run onboarding again (that’s where gateway config + daemon install happens), e.g. openclaw onboard --install-daemon.

#

That’s progress — now the Gateway is reachable, but your agent has zero Anthropic credentials, so it can’t call Claude.

Fix = add Anthropic auth for the main agent (auth is per-agent).

  1. First, paste this so we know what build you’re on:
openclaw --version
  1. Set up Anthropic auth (pick ONE):

A) If you have an Anthropic API key
Run onboarding again and choose “Anthropic API key” (this writes it into the right place for the service/app):

openclaw onboard

(or non-interactive: openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY")

#

B) If you’re using a Claude subscription (setup-token)
Generate a setup-token, then paste it into OpenClaw:

claude setup-token
openclaw models auth paste-token --provider anthropic

(it will prompt; paste the token)

  1. Verify it’s actually wired up:
openclaw models status --probe

If it still complains in the app after adding auth, do a quick restart:

openclaw gateway restart
#

If you paste the output of openclaw models status (redacts secrets), I can tell you exactly what it’s still missing.

rain walrus
#

2026.2.26

limber mossBOT
#

Cool — 2026.2.26 is recent, so the error is just “no Anthropic credentials configured yet”.

You need to add Anthropic auth for the main agent on that Mac (auth is per-agent, and your error path is ~/.openclaw/agents/main/agent/auth-profiles.json).

Option A (Claude subscription): setup-token

  1. Generate a setup-token (requires the Claude Code CLI):
claude setup-token
  1. Paste it into OpenClaw:
openclaw models auth paste-token --provider anthropic

Option B (Anthropic API key)

Run the wizard and choose Anthropic API key: