Grix
Agent Integration Guide
Detailed guide on integrating various AI agents (Claude, OpenClaw, Codex, Gemini, etc.) into the Grix platform.
Detailed guide on integrating various AI agents into the Grix platform.
Supported Agent Types
| Type | CLI Command |
|---|---|
| OpenClaw | openclaw |
| Claude | claude |
| Codex | codex |
| Gemini | gemini |
| Qwen | qwen |
| Pi | pi |
| Hermes | hermes |
| Reasonix | reasonix |
| CodeWhale | codewhale |
| OpenCode | opencode |
| Kiro | kiro-cli |
| GitHub Copilot | gh |
Prerequisites
- grix-connector installed and running (desktop app handles this automatically)
- System dependencies: Node.js >= 18 / Go >= 1.21 (varies by agent type)
Option 1: Desktop One-Click Integration (Recommended)
- Go to the “System” page and confirm the connector is running
- Click the agent type icon — CLI is auto-installed on first use
- Click “New” → Enter a name → “Create”
- Grix auto-registers + configures + starts + opens conversation
Option 2: Manual Integration
- Create an agent in the Grix “AI” tab (select Agent API type)
- After saving, get: Agent ID / Endpoint / API Key
- Install the CLI on the target machine and configure:
# Claude example
npm install -g @dhf-claude/grix
grix-claude install --ws-url <Endpoint> --agent-id <ID> --api-key <Key>
# OpenClaw example
npm install -g @dhf-openclaw/grix
# Codex example
npm install @dhf-codex/grix
grix-codex agent --agent-id <ID> --endpoint <Endpoint> --api-key <Key>- Start grix-connector — the agent comes online
Troubleshooting
| Issue | Solution |
|---|---|
| Agent shows offline | Check computer is on, connector is running, network is connected |
| Key compromised | Go to agent edit page → “Reset Key”, reconfigure with new key |
| Command not found | Restart terminal or add install path to PATH |
| npm permission error | sudo npm install -g or modify npm prefix |