Channel Commands

GoClaw provides slash commands available across all text channels (Telegram, WhatsApp, TUI, HTTP).

Command Reference

Command Details

/status

Shows current session information and compaction health.

Output:

Session Status
  Messages: 45
  Tokens: 12,500 / 200,000 (6.3%)
  Compactions: 0

Compaction Health
  LLM: available

Skills: 54 total, 12 eligible

When compaction has issues:

Compaction Health
  LLM: unavailable
  Pending retries: 1

/clear

Clears all conversation history for the current session. Alias: /reset

Use this when:

• Starting fresh on a new topic
• Session is corrupted
• Context has drifted too far from the task

/cleartool

Deletes all tool-related messages (tool_use and tool_result) from the session.

Use this when:

• Tool message corruption is causing errors
• Orphaned tool results are confusing the agent
• Need to clean up without losing conversation context

/stop

Stops all running agent tasks for your user across all sessions.

Output:

Stopped all agent tasks for user Alice

Use this when:

• Agent is stuck in a long-running operation
• Need to interrupt an unwanted task
• Agent is in an infinite loop or runaway state

Note: This is a “panic stop” that immediately cancels all in-progress agent runs. The agent will not complete any pending tool calls.

/compact

Forces immediate context compaction, even if the token threshold hasn’t been reached.

Output:

Compaction completed!
  Tokens before: 175,000
  Tokens after: 45,000
  Summary source: LLM

Use this when:

• Proactively reducing context before a long task
• Testing compaction behavior
• Freeing up context window space

/help

Lists all available commands with descriptions.

/skills

Lists available skills with their status.

Output:

Skills (12 eligible of 54)

Eligible:
  🌤️ weather - Get current weather and forecasts
  📧 himalaya - CLI to manage emails
  ...

Flagged (1):
  ⚠️ suspicious-skill - Security flag: env_file

/heartbeat

Triggers a heartbeat check manually. Useful for testing heartbeat behavior or forcing the agent to check external sources.

/hass

Home Assistant integration status and debugging.

Usage:

/hass           # Show connection status
/hass debug     # Show debug info
/hass info      # Show entity info
/hass subs      # Show active subscriptions

/llm

LLM provider status and cooldown management.

Usage:

/llm            # Show provider status
/llm status     # Same as above
/llm reset      # Clear all cooldowns

Output:

LLM Provider Status

claude: healthy
ollama-qwen: cooldown (rate_limit), retry in 2m30s
ollama-embed: healthy

/embeddings

Embeddings status and rebuild.

Usage:

/embeddings           # Show status
/embeddings status    # Same as above
/embeddings rebuild   # Rebuild all embeddings

Output:

Embeddings Status

Session transcripts: 1,234 chunks
Memory files: 56 chunks

Model: nomic-embed-text
Provider: ollama

/acp

Attach, inspect, and control ACP sessions from any text channel.

Usage:

/acp attach [driver] [--cwd /path] [--mode mode] [--session SESSION_ID]
/acp detach
/acp status
/acp close
/acp cancel
/acp mode <agent|plan|ask>
/acp model list
/acp model <friendly-id>
/acp steer [--stay-attached] <message>

Subcommands:

Examples:

/acp attach
/acp attach cursor --cwd /path/to/project --mode agent
/acp attach cursor --session SESSION_ID
/acp status
/acp mode plan
/acp model list
/acp model claude-4.6-opus-high-thinking
/acp steer Review the current branch and summarize the next safe step.
/acp steer --stay-attached Ask Cursor to keep the session open for one more turn.
/acp detach
/acp close

Behavior notes:

• The default ACP driver is cursor
• /acp attach tries to apply the configured acp.drivers.cursor.model alias immediately after attaching
• /acp model list shows the live friendly aliases exposed by the attached Cursor ACP session
• /acp model <friendly-id> switches the current ACP session to that alias
• /acp steer now detaches by default after the prompt completes
• Use --stay-attached when you want to keep routing future turns through ACP
• detach keeps the external ACP session available for later re-attachment, while close shuts it down

See ACP Sessions for the full workflow and ACP Tools for the agent-facing tool equivalents.

Channel-Specific Behavior

Commands work the same across all channels, but output formatting may vary:

Adding Custom Commands

Commands are registered at startup. Custom commands can be added by extending the command handler in the codebase.

See Also

• Channels — Channel overview
• ACP Sessions — ACP attach, steer, and interactive workflows
• Telegram — Telegram bot
• TUI — Terminal interface
• Web UI — HTTP interface