goclaw

Administer and debug GoClaw gateways through the goclaw CLI.

3.6k|1.0k|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/nextlevelbuilder/goclaw --skill goclaw
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: goclaw
Source: https://github.com/nextlevelbuilder/goclaw/tree/main/skills/goclaw
Command: npx skills add https://github.com/nextlevelbuilder/goclaw --skill goclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Operating a multi-tenant GoClaw AI gateway requires knowing which CLI commands exist, how to inspect gateway health safely, and how to troubleshoot agents, skills, providers, and channels without exposing credentials or causing destructive changes.

Core Features & Use Cases

  • CLI Discovery and Diagnostics: Inspect the live goclaw binary with version, help, doctor, and config validation commands before taking action.
  • Gateway Administration: Manage agents, skills, MCP tools, runtime packages, credentials, sessions, channels, providers, and cron jobs with scoped, confirmation-gated operations.
  • Troubleshooting Playbooks: Diagnose tool access failures, package install errors, expired credentials, provider errors, and channel delivery issues using traces and status commands.
  • Use Case: An agent cannot access an MCP tool. List the agent's skills, check MCP server status and permission grants, inspect the failing trace, then apply the smallest access grant after user confirmation.

Quick Start

Ask the assistant to run goclaw doctor and goclaw agent list to check the health of your GoClaw gateway and show its configured agents.

Frequently Asked Questions about goclaw

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the health of a GoClaw gateway?โ–ผ

Run goclaw doctor for a health check, then goclaw config validate to verify configuration. Read-only commands like goclaw agent list, goclaw providers list, and goclaw channels list confirm each subsystem is reachable.

How do I find which goclaw CLI commands are available?โ–ผ

Run goclaw --help and goclaw <command> --help to discover the live command surface, since availability is version-dependent. If the binary is not on PATH, check /var/lib/goclaw/data/.runtime/bin/goclaw or /app/data/.runtime/bin/goclaw.

How do I debug an agent that cannot access a tool or MCP server?โ–ผ

Confirm the tenant and agent scope, list the agent's skills and tools, then check MCP server status and permission grants. Inspect the relevant trace with goclaw traces get to find permission, approval, or transport errors before applying the smallest grant.

Can I run goclaw admin commands against a remote gateway?โ–ผ

Yes, many admin commands read GOCLAW_SERVER, GOCLAW_GATEWAY_URL, and GOCLAW_GATEWAY_TOKEN from the environment for remote operation. Configure tokens through a shell or session secret manager rather than passing them as command arguments.

Why does a goclaw skill install or package update fail?โ–ผ

Check dependency status with goclaw skills deps status, then verify runtime availability for Python, Node, or system packages. Common causes include pending approvals, network errors, disk limits, or checksum failures.

Is it safe to share goclaw config show output in a ticket?โ–ผ

No, treat config show output as sensitive even though the CLI redacts known secret fields. Never paste API keys, tokens, database credentials, or trace excerpts containing customer data into chats, issues, or shared logs.