Managing Connections

How do I check connection health?

Every connection in WorkClaw has a real-time health status visible from Settings > Connections. The status indicator uses three states:

• Connected (green) — Credentials are valid, the service is reachable, and the Claw can use this connection normally.
• Warning (yellow) — The connection is still functional but needs attention. Common causes include tokens nearing expiration, transient API errors from the service, or scope changes detected on the provider side.
• Disconnected (red) — The connection is broken. The token has expired, been revoked, or the service is unreachable. Skills that depend on this connection are paused until it's restored.

WorkClaw runs automated health checks on a regular interval and notifies you via email and in-app alert when a connection degrades.

How do I reconnect an expired or broken connection?

1. Go to Settings > Connections and find the connection with a Disconnected or Warning status.
2. Click the connection to open its detail panel.
3. Click Reconnect. For OAuth connections (Google, Slack, etc.), this opens the provider's authorization page so you can re-authorize. For custom app connections, you're prompted to update the credential.
4. After successful re-authorization, the status returns to Connected and dependent skills resume automatically.

If reconnection fails repeatedly, check whether the credential was revoked on the provider's side (e.g., in your Google or Slack account settings).

How do I disconnect a service?

Disconnecting removes the Claw's access to a service. Go to Settings > Connections, click the overflow menu on the connection, and select Disconnect. WorkClaw revokes the stored token (for OAuth connections) or deletes the credential reference (for custom connections). The underlying vault item is retained for 30 days in case you reconnect.

Skills that depend on the disconnected service will stop functioning on that Claw. They are not uninstalled — they simply become inactive until a matching connection is restored.

How do I change the scopes on an existing connection?

Some skills require additional scopes beyond what you initially granted. When you install such a skill, WorkClaw prompts you to expand the connection's scopes automatically. You can also adjust scopes manually:

1. Open the connection's detail panel from Settings > Connections.
2. Click Edit Scopes.
3. Add or remove scopes from the checklist. WorkClaw shows which skills depend on each scope so you can avoid breaking active integrations.
4. Click Save. For OAuth connections, you're redirected to the provider's consent screen to approve the new scope set.

Removing a scope that an active skill requires triggers a warning. The skill continues to function until it attempts an action that needs the removed scope, at which point it fails gracefully and notifies you.