---
name: xray-orchestrator
description: |
  Main orchestration skill for xray agents.
  Provides commands to coordinate agent work and invoke xray APIs
  through the local HTTP API server.
metadata:
  openclaw:
    primaryEnv: XRAY_API_KEY
    emoji: 🤖
  author: xray
  tags:
    - ai
    - orchestration
    - agent
user-invocable: true
---

# xray Orchestrator Commands

## /xray

Display xray status and available commands.

**Usage:** `/xray`

**Example:**
```
/xray
```

## /xray-status

Get detailed status of xray integration including connection status.

**Usage:** `/xray-status`

**Example:**
```
/xray-status
```

## /xray-analyze

Analyze code using xray code analysis capabilities.

**Usage:** `/xray-analyze <file-path>`

**Arguments:**
- `file-path`: Path to file to analyze (required)

**Example:**
```
/xray-analyze src/index.ts
```

## /xray-code

Perform code review on a file.

**Usage:** `/xray-code <file-path> [options]`

**Arguments:**
- `file-path`: Path to file to review (required)
- `--fix`: Attempt to fix issues automatically (optional)

**Example:**
```
/xray-code src/utils/helper.ts
/xray-code src/utils/helper.ts --fix
```

## /xray-file

Read file using xray file tools.

**Usage:** `/xray-file <file-path> [line-start:line-end]`

**Arguments:**
- `file-path`: Path to file to read (required)
- `line-start:line-end`: Line range to read (optional)

**Example:**
```
/xray-file src/index.ts
/xray-file src/index.ts 1:50
```

## /xray-exec

Execute arbitrary xray command or script.

**Usage:** `/xray-exec <command>`

**Arguments:**
- `command`: Command to execute (required)

**Example:**
```
/xray-exec list files src/
```

## /xray-help

Show this help message.

**Usage:** `/xray-help [command]`

**Arguments:**
- `command`: Specific command to get help for (optional)

**Example:**
```
/xray-help
/xray-help xray-analyze
```

# Implementation Notes

This skill acts as the main interface between OpenClaw channels and xray agents.
It processes user commands and forwards them to the xray API server running on localhost:18431.

## API Endpoints

- `POST /api/agent/invoke` - Invoke xray agent
- `GET /api/agent/status` - Get agent status
- `GET /health` - Health check

## Authentication

The skill reads the `XRAY_API_KEY` environment variable for authentication.

## Error Handling

All errors are caught and formatted as user-friendly messages.
Detailed error information is logged for debugging.

# Dependencies

- xray API server running on localhost:18431
- XRAY_API_KEY environment variable