yahboom
HomeTutorialsProduct
Solution
Blog
Online Store
About Us
EN/中文
Store
Jetson Orin NANO Developer Kit📖
01.Get started
  • 01. Learning route
  • 02. Get started quickly
  • 03. System Update Notes
  • 04. Disabling automatic updates and troubleshooting issues
  • 05. Jetson Orin Nano official kit screwdriver instructions
02.Jetson basic course
  • 01.Jetson board introduction
  • 02.Write Jetson original system
  • 03.Installing Jetson environment
  • 04.Backup SSD system
  • 05.Restore initial image system
  • 06.Upgrade to SUPER version (Optional)
  • 07.Write SUPER boot (Must read)
  • 08.SSD expansion
  • 09.Jetpack old system upgraded to Yahboom SUPER factory system
  • 10.Write the system onto your own SSD
03.Basic setting course
  • 01.Basic knowledge
  • 02.Network configuration
  • 03.SSH remote login
  • 04.VNC remote control
  • 05.RDP remote control
  • 06.Remote file transfer
  • 07.Jtop tool
  • 08.Exchange space expansion
  • 09.Use VSCode
  • 10.Use VMware
  • 11.Modify screen resolution
04.GPIO control course
  • 01.GPIO description
  • 02.GPIO library installation
  • 03.GPIO reading
  • 04.GPIO output
  • 05.Serial communication
  • 06.I2C communication
05.Vision basic course
  • 01.CSI camera preview
  • 02.USB camera preview
  • 03.Use Jupyter Lab
  • 04.Use JetCam
06.OpenCV basic course
  • 01.Image reading
  • 02.Image saving
  • 03.Image modification
  • 04.Image scaling
  • 05.Image cropping
  • 06.Image translation
  • 07.Image mirroring
  • 08.Image grayscale conversion
  • 09.Image binarization
  • 10.Image edge detection
  • 11.Add line segments
  • 12.Add rectangles
  • 13.Add circular shape
  • 14.Add ellipses
  • 15.Add polygons
  • 16.Add Text
  • 17.Preview USB camera image
  • 18.Preview CSI camera image
07.Vision advanced course
01.Environment construction
  • 01.TensorFlow
  • 02.PyTorch
  • 03.Torchvision
02.DeepStream development
  • 01.DeepStream environment
  • 02.License plate detection and recognition
  • 03.Parallel multi-model inference
  • 04.Object embedding vector generation
  • 05.Pose recognition
  • 06.NV optical flow anomaly detection
  • 07.Single-view 3D tracking
  • 08.Multi-view 3D tracking
03.NVIDIA TAO toolkit application
  • 01.Traffic scene object detection
  • 02.Person object detection
  • 03.Vehicle brand classification
  • 04.Vehicle model classification
  • 05.License plate detection and recognition
  • 06.Person semantic segmentation
  • 07.Retail product detection and recognition
  • 08.Person feature extraction and matching (ReID)
  • 09.Person action and pose classification
  • 10.Transformer-based person detection
  • 11.3D human skeleton detection
  • 12.LiDAR 3D point cloud detection
04.YOLO11 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
05.Mediapipe development
  • 01.Mediapipe environment
  • 02.Hand detection
  • 03.Face detection
  • 04.Face effects
  • 05.3D object recognition
  • 06.Virtual brush
  • 07.Gesture recognition
  • 08.Finger control
  • 09.Posture estimation
  • 10.Face mask
  • 11.Overall detection
  • 12.Green scene removal(Human)
06.YOLO26 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
07.QR code recognition
  • QR code recognition
08.Docker basic course
  • 01.Docker introduction
  • 02.Docker installation
  • 03.Docker command
  • 04.Docker usage
  • 05.Docker interaction
09.ROS2-Jazzy
01.ROS2 basic course
  • 1.Introduction to ROS2
  • 2.ROS2 install Jazzy
  • 3.ROS2 development environment
  • 4.ROS2 workspace
  • 5.ROS2 function package
  • 6.ROS2 node
  • 7.ROS2 topic communication
  • 8.ROS2 service communication
  • 9.ROS2 action communication
  • 10.ROS2 custom interface message
  • 11.ROS2 parameter service case
  • 12.ROS2 meta-function package
  • 13.ROS2 distributed communication
  • 14.ROS2 DDS
  • 15.ROS2 time related API
  • 16.ROS2 common command tools
  • 17.ROS2 rviz2 use
  • 18.ROS2 rqt toolbox
  • 19.ROS2 Launch startup file configuration
  • 20.ROS2 recording and playback tool
  • 21.ROS2 URDF model
  • 22.ROS2 Gazebo simulation platform
  • 23.ROS2 TF2 coordinate transformation
02.ROS2 vision course
  • 01.Camera preview (USB)
  • 02.Camera preview (CSI)
  • 03.Camera calibration (USB)
  • 04.Camera calibration (CSI)
  • 05.AR vision (USB)
  • 06.AR vision (CSI)
10.Large model basic course
01.Offline large model
  • 01.AI large model environment deployment
  • 02.Install large model dialogue platform
  • 03.Meta AI - Llama model
  • 04.Alibaba Cloud - Qwen model
  • 05.Microsoft - Phi-4-mini model
  • 06.DeepSeek - DeepSeek model
  • 07.Alibaba Cloud - Qwen-VL visual multimodal large model
  • 08.Google - Gemma visual multimodal large model
  • 9.Llava visual multimodal large model
  • 10.MiniCPM-V visual multimodal large model
  • 11.High-quality vision-language grounding (LocateAnything)
02.Online large model
  • 01.Tongyi Qianwen large model
  • 02.OpenRouter large model API aggregation platform
11.Large model application practice
01.Voice interaction application
  • 1.Voice interaction hardware connection (Must read)
  • 2.Offline speech to text (ASR)
  • 3.Offline text to speech (TTS)
  • 4.AI large model voice interaction
  • 5.AI large model offline voice assistant
02.Multimodal large model application (Online_Offline large model + Text_Voice interaction)
  • 01.Multimodal visual understand application
  • 02.Multimodal text image application
  • 03.Multimodal video analysis application
  • 04.Multi module visual position application
  • 05.Multimodal table scanning application
  • 06.Multimodal autonomous agent application
12.NVIDIA Isaac ROS course
  • 01.Build Isaac ROS environment
  • 02.Deep segmentation
  • 03.DNN stereoscopic depth
  • 04.Free space segmentation
  • 05.Image distortion processing
  • 06.Image segmentation
  • 07.3D scene reconstruction and mapping
  • 08.Object detection
  • 09.3D attitude estimation
  • 10.Visual SLAM
13.OpenClaw deployment and basic usage
01.OpenClaw deployment and introduction
  • 01.Quick start with the pre-configured environment (Recommended)
  • 02.OpenClaw Deployment
  • 03.OpenClaw WhatsApp Plugin Application
  • 04.OpenClaw WebChat Interaction
  • 05.OpenClaw TUI Interaction
  • 06.OpenClaw Tools Introduction
  • 07.OpenClawGate Gateway User Manual
  • 08.OpenClaw Features Overview
  • 09.OpenClawHub Introduction (Skill Installation)
02.OpenClaw basic application
  • 01.OpenClaw Application - File Management
  • 02.OpenClaw Application - Camera
  • 03.OpenClaw Application - Browser Control
  • 04.OpenClaw Application - Script Execution
  • 05.OpenClaw Application - AI Programming (Peripheral & GPIO Control)
  • 06.OpenClaw Application - Dedicated AI Assistant
  • 07.OpenClaw Web Search Capability Configuration
03.NVIDIA official Agent Skills application
  • 01.AI-assisted development with VS Code or Cursor
  • 02.Jetson device skills
  • 03.Jetson BSP custom agent skills
14.OpenClaw advanced development
01.Preparation Before Use
  • 01.Peripheral Hardware Configuration
  • 02.OpenClaw API-KEY Configuration
  • 03.OpenClaw Model Switching
  • 04.OpenClaw Prompts
  • 05.AI Voice Interaction Configuration
  • 06.Three Dialogue Configuration Tests
02.OpenClaw AI Programming Peripheral Control
  • 1. Servo Control
  • 2. RGB Strip
  • 3. OLED Display
  • 4. Temperature and Humidity Sensor
  • 5. Camera Application
  • 6. AI Script Peripheral Control
03.OpenClaw Peripheral Integration Applications
  • 1. Plant Care Assistant
  • 2. AI Calorie Estimation
  • 3. AI Rock Paper Scissors Game
  • 4. AI Pet
  • 5. AI Weather Station
  • 6. Temperature Humidity Dashboard
  • 7. Scheduled Tasks
Download
  • System_File
  • VMFile_BootFile
  • 3D Model File
  • DataSheet
  • Software_Tools
  • Code
  • Manual
Download ZIP

Welcome to Jetson Orin NANO Developer Kit repository

07.OpenClawGate Gateway User Manual

7. OpenClaw Gateway Operation Manual

The Gateway is the resident process of OpenClaw: it maintains the connections of each messaging channel, hosts the control and event planes, and serves as the unified entry point for sessions, routing, and channel status. In simple terms: whether you can "connect to OpenClaw", whether the console can be opened, and whether messages can come in often depends on whether the Gateway is running normally.

7. OpenClaw Gateway Operation Manual1. When You Need to Care About the Gateway2. The Fastest Way to Start (Local)3. What "External Interfaces" the Gateway Provides4. Hot Reload and "Restart-Required" Changes5. Authentication and Remote Access (Most Error-Prone)5.1 Gateway Authentication (token/password)5.2 Recommended Way for Remote Access: Tunnel First, Then Access5.3 Console Cannot Be Opened over Plain HTTP (device identity required)6. Multiple Instances and "Rescue Robot" Mode7. Troubleshooting Order, Which Locates Most Problems7.1 Check the Status First7.2 Gateway Will Not Start: Configuration Validation Failure7.3 Common Symptom: Service Installed but Not Actually Running

1. When You Need to Care About the Gateway

In most cases, you only need to keep it running stably; you only need to specifically check/learn about the Gateway in the following scenarios:

  • Opening the console in a browser on the Jetson often reports errors, and you are preparing to switch to the TUI or remote access

  • The configuration has been changed but "it feels like it has not taken effect", and you suspect that the hot reload/restart was not triggered

  • You want to expose the console to the LAN or access it remotely via SSH/Tailscale

  • You want to do multi-instance isolation (for example, a "rescue robot"/redundancy)

  • Port conflicts, the process will not start, or the service "looks installed but is not running"

2. The Fastest Way to Start (Local)

Execute the following on the gateway host (for example, the Jetson):

openclaw gateway

Common parameters:

​x
# Print more complete debugging/tracing information to the current terminal (useful for troubleshooting)
openclaw gateway --port 18789 --verbose

# When the port is occupied, try to terminate the listener occupying the port and force startup
openclaw gateway --port 18789 --force

Port priority (from highest to lowest): --port > OPENCLAW_GATEWAY_PORT > gateway.port > the default 18789.

3. What "External Interfaces" the Gateway Provides

The same port (default 18789) provides both the WebSocket control plane and HTTP services (control interface, hooks, A2UI, etc.) at the same time, which is "single-port multiplexing".

Points you will commonly use:

  • Local console: http://127.0.0.1:18789/

  • OpenAI Chat Completions compatible interface: /v1/chat/completions

  • OpenResponses interface: /v1/responses

  • Tool invocation interface: /tools/invoke

In addition, by default the gateway also starts a Canvas static file service (default port 18793) to provide editable HTML/A2UI resources (served from ~/.openclaw/workspace/canvas by default). To disable it, set canvasHost.enabled=false or OPENCLAW_SKIP_CANVAS_HOST=1.

4. Hot Reload and "Restart-Required" Changes

The gateway monitors ~/.openclaw/openclaw.json (or the path specified by OPENCLAW_CONFIG_PATH), and configuration updates are usually applied automatically. The default reload mode is gateway.reload.mode="hybrid": safe changes are hot-applied, and critical changes trigger a restart.

You can explicitly configure the reload behavior:

xxxxxxxxxx
{
  "gateway": {
    "reload": { "mode": "hybrid", "debounceMs": 300 }
  }
}

Experience-based suggestions:

  • Changing business configurations such as models, agents, and routing usually does not require you to restart manually

  • Changing gateway.* (port, binding, authentication, TLS, HTTP, etc.) counts as an infrastructure change and is more likely to trigger a restart

5. Authentication and Remote Access (Most Error-Prone)

5.1 Gateway Authentication (token/password)

Gateway authentication is enabled by default: you can set gateway.auth.token (or OPENCLAW_GATEWAY_TOKEN) or gateway.auth.password. When connecting, the client needs to carry it in connect.params.auth.token/password.

If you use the wizard flow, a token is usually generated by default (even if it is bound only to loopback).

5.2 Recommended Way for Remote Access: Tunnel First, Then Access

Most recommended: Tailscale/VPN. Next: SSH tunnel.

Example (mapping remote 18789 to local 18789):

xxxxxxxxxx
ssh -N -L 18789:127.0.0.1:18789 user@host

Then you access it locally:

  • Web: http://127.0.0.1:18789/

  • WS: ws://127.0.0.1:18789

Note: even through a tunnel, if the gateway is configured with a token, the client still has to carry the token to connect.

5.3 Console Cannot Be Opened over Plain HTTP (device identity required)

If you open the console on the LAN with http://<lan-ip>:18789/, the browser may be in a non-secure context, which restricts WebCrypto and prevents the device identity from being generated, resulting in device identity required / connect failed.[^gateway_troubleshooting]

Preferred fix route:

  • Open locally: http://127.0.0.1:18789/

  • For remote scenarios, use Tailscale Serve to provide HTTPS

  • If HTTP must be used, enable gateway.controlUi.allowInsecureAuth: true and use the gateway token (token mode only, without device identity/pairing)[^gateway_troubleshooting]

6. Multiple Instances and "Rescue Robot" Mode

Try this operation only when needed

Usually running one gateway per host is enough; running multiple gateway instances is recommended only when redundancy or strong isolation (for example, a rescue robot) is required.

The core principle for multiple instances is "full isolation + no conflicts":

  • Different gateway.port

  • Different OPENCLAW_CONFIG_PATH

  • Different OPENCLAW_STATE_DIR

  • Different workspace (agents.defaults.workspace)

Under the dev profile, you can quickly start a fully isolated development instance without affecting the main environment:

xxxxxxxxxx
openclaw --dev setup
openclaw --dev gateway --allow-unconfigured
openclaw --dev status
openclaw --dev health

7. Troubleshooting Order, Which Locates Most Problems

7.1 Check the Status First

Execute in order:[^gateway_troubleshooting]

xxxxxxxxxx
openclaw status
openclaw status --all
openclaw status --deep

Common supplementary commands:

xxxxxxxxxx
openclaw gateway probe
openclaw channels status --probe
openclaw gateway status
openclaw logs --follow
openclaw doctor

7.2 Gateway Will Not Start: Configuration Validation Failure

OpenClaw configuration uses strict schema validation: unknown keys, type errors, or invalid values may all cause the gateway to refuse to start.

When validation fails, usually only diagnostic commands are available (for example, openclaw doctor / logs / health / status). It is recommended to directly run:

xxxxxxxxxx
openclaw doctor

7.3 Common Symptom: Service Installed but Not Actually Running

If you install the gateway as a service with systemd/launchd/schtasks, showing "loaded/installed" does not mean the process is running. Check first:[^gateway_troubleshooting]

xxxxxxxxxx
openclaw gateway status
openclaw logs --follow
OpenClaw Tools Introduction
OpenClaw Features Overview

COMPANY

  • About us
  • Team Style
  • Blog

LEARNING & EXPLORATION

  • Tutorials
  • Edge AI hardware
  • Educational robots
  • Embedded intelligent hardware

WHERE TO BUY

  • Yahboom Online Store
  • Amazon
  • Alibaba
  • AliExpress
  • Mercado

TECHNOLOGY SUPPORT

  • Email: support@yahboom.com

BE A DISTRIBUTOR

  • Email: sales@yahboom.com
QR Code

Copyright © 2017-2026 Yahboom. All Rights Reserved.

EN/中文