Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GOCLAW_TOKEN | No | Bearer token (determines RBAC role) | |
| GOCLAW_SERVER | Yes | GoClaw gateway URL | |
| GOCLAW_USER_ID | No | Default user ID for multi-tenant scoping | |
| GOCLAW_MCP_PORT | No | HTTP transport port | 3100 |
| GOCLAW_LOG_LEVEL | No | Log level: debug, info, warn, error | info |
| GOCLAW_MCP_RATE_LIMIT_RPM | No | Rate limit per session (req/min) | 60 |
| GOCLAW_MCP_ALLOWED_ORIGINS | No | Comma-separated allowed origins | localhost |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| goclaw_health | Check GoClaw gateway health status |
| goclaw_status | Get GoClaw gateway status including version, uptime, and connection counts |
| goclaw_models_list | List all available LLM models across all configured providers |
| goclaw_agent_list | List all agents configured in GoClaw gateway |
| goclaw_agent_get | Get detailed information about a specific agent |
| goclaw_agent_create | Create a new agent in GoClaw gateway |
| goclaw_agent_update | Update an existing agent's settings |
| goclaw_agent_delete | Delete an agent (soft delete) |
| goclaw_agent_files_list | List context files (SOUL.md, IDENTITY.md, etc.) for an agent |
| goclaw_agent_files_get | Read a specific context file for an agent |
| goclaw_agent_files_set | Create or update a context file for an agent |
| goclaw_agent_files_delete | Delete a context file from an agent |
| goclaw_agent_links_list | List delegation links for an agent (which agents it can delegate to) |
| goclaw_agent_links_set | Create or update a delegation link between agents |
| goclaw_agent_links_remove | Remove a delegation link between agents |
| goclaw_agent_share | Share an agent with a user |
| goclaw_session_list | List chat sessions, optionally filtered by agent |
| goclaw_session_preview | Preview recent messages in a chat session |
| goclaw_session_delete | Delete a chat session permanently |
| goclaw_session_reset | Reset a chat session (clear message history) |
| goclaw_session_label | Set a label/title for a chat session |
| goclaw_config_get | Get current GoClaw gateway configuration (or a specific section) |
| goclaw_config_apply | Apply a full configuration to the GoClaw gateway (overwrites current config). Use with caution. |
| goclaw_config_patch | Patch specific fields in the GoClaw gateway configuration |
| goclaw_provider_list | List all configured LLM providers |
| goclaw_provider_get | Get details of a specific LLM provider |
| goclaw_provider_create | Add a new LLM provider to GoClaw |
| goclaw_provider_update | Update an LLM provider's configuration |
| goclaw_provider_delete | Remove an LLM provider from GoClaw |
| goclaw_mcp_server_list | List all registered MCP servers in GoClaw |
| goclaw_mcp_server_get | Get details of a registered MCP server |
| goclaw_mcp_server_create | Register a new MCP server in GoClaw |
| goclaw_mcp_server_update | Update a registered MCP server's configuration |
| goclaw_mcp_server_delete | Remove a registered MCP server from GoClaw |
| goclaw_mcp_server_grant_agent | Grant an agent access to an MCP server |
| goclaw_mcp_server_grant_user | Grant a user access to an MCP server |
| goclaw_skill_list | List all available skills in GoClaw |
| goclaw_skill_get | Get details of a specific skill |
| goclaw_skill_update | Update a skill's metadata |
| goclaw_skill_grant_agent | Grant an agent access to a skill |
| goclaw_skill_grant_user | Grant a user access to a skill |
| goclaw_custom_tool_list | List custom tools defined in GoClaw |
| goclaw_custom_tool_get | Get details of a custom tool |
| goclaw_custom_tool_create | Create a new custom tool in GoClaw |
| goclaw_custom_tool_update | Update a custom tool's definition |
| goclaw_custom_tool_delete | Delete a custom tool from GoClaw |
| goclaw_custom_tool_invoke | Invoke a custom tool directly with arguments |
| goclaw_cron_list | List all cron jobs in GoClaw |
| goclaw_cron_create | Create a new cron job |
| goclaw_cron_update | Update a cron job's settings |
| goclaw_cron_delete | Delete a cron job |
| goclaw_cron_toggle | Enable or disable a cron job |
| goclaw_cron_run | Trigger a cron job to run immediately |
| goclaw_team_list | List all teams in GoClaw |
| goclaw_team_get | Get team details |
| goclaw_team_create | Create a new agent team |
| goclaw_team_update | Update a team's settings |
| goclaw_team_delete | Delete a team |
| goclaw_trace_list | List LLM execution traces with cost and token usage |
| goclaw_trace_get | Get detailed trace with individual LLM call spans |
| goclaw_channel_list | List all messaging channels (Telegram, Discord, etc.) |
| goclaw_channel_toggle | Enable or disable a messaging channel |
| goclaw_memory_list | List memory documents stored for an agent |
| goclaw_memory_get | Read a memory document's content |
| goclaw_memory_create | Store a new memory document for an agent |
| goclaw_memory_delete | Delete a memory document |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| goclaw_setup_agent | Guide through creating and configuring a new GoClaw agent |
| goclaw_troubleshoot | Systematic troubleshooting of GoClaw gateway issues |
| goclaw_review_config | Review current GoClaw configuration for issues or improvements |
| goclaw_optimize_agent | Suggest optimizations for an agent's settings and behavior |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| goclaw://status | |
| goclaw://models | |
| goclaw://agents | |
| goclaw://config |