Reference
Your Dashboard — Every Button Explained
A complete guide to the OpenClaw Control UI. What every page, button, and field does — so you never feel lost.
⏱ 10 minute reference
ℹ️ Seeing "OpenClaw Gateway Dashboard" after clicking "Meet [Agent Name]"?
That is expected for many Heyron users right now. Heyron currently uses the OpenClaw dashboard as the active control UI while the newer branded UI rolls out. You're still in the right place, and you're still talking to your Heyron agent.
The left sidebar is your navigation. It's organized into 4 groups, each with an icon and a label. Click a group to expand it and see its pages:
- 💬 Chat — Talk to your agent
- 📊 Control — Monitor and manage your agent's operations
- 🤖 Agent — Configure your agent's identity, skills, and connections
- ⚙️ Settings — System configuration, infrastructure, and debugging
Each group expands to reveal its pages. You can collapse groups you don't need to keep things tidy.
Chat Page
This is the core of the experience — your direct conversation with your agent.
- Message input — Type your message and press Enter or click Send.
- Stop button — Appears while your agent is thinking. Click to cancel the current response.
- Attachment button — Attach files to your message (not yet supported in the web chat — we're on it! 🦝). Use Discord or Telegram for file sharing in the meantime.
- Model selector — Lets you switch which AI model your agent uses mid-conversation (if visible).
- Session indicator — Shows which session you're currently chatting in.
- Chat bubbles — Your messages appear on the right, agent responses on the left.
- Tool call cards — When your agent uses tools (web search, file operations, etc.), you'll see expandable cards showing exactly what it did and what it returned.
- Typing indicator — Shows when your agent is generating a response.
Overview Page 📊
The dashboard home. Shows the at-a-glance status of your agent.
- Status cards — Gateway status, uptime, current model, and channel connections.
- Attention items — Issues that need your attention — disconnected channels, errors, missing config.
- Event log — Recent activity feed showing messages sent/received, tool calls, and errors.
- Quick hints — Suggestions for things to set up or fix if your agent isn't fully configured yet.
Channels Page 🔗
Manage your chat connections — Discord, Telegram, and more.
- Channel cards — Each connected channel shows its name and current status.
- QR code / Login buttons — For channels that need browser login (like WhatsApp), you'll see a QR code to scan.
- Status indicators — Green = connected, Yellow = connecting, Red = disconnected.
- Per-channel config — Click a channel to see its settings and options.
- Add channel — Instructions for connecting new channels to your agent.
⚠️ Warning
Don't edit channel configs unless you know what you're doing. A wrong change can disconnect your agent from that channel.
Instances Page 📡
Shows all running OpenClaw instances and processes.
- Presence list — Shows which gateway instances are currently active.
- Refresh button — Update the list to see current status.
ℹ️ Info
Most users will only see one instance here. This page is mainly for advanced multi-gateway setups.
Sessions Page 📄
View and manage your agent's conversation sessions.
- Session list — Each channel and conversation gets its own session.
- Session key — The unique identifier, e.g.
agent:main:discord:channel:123456.
- Per-session overrides — Toggle thinking mode, verbose mode, fast mode, or reasoning for individual sessions.
- Token count — How many tokens each session has used.
ℹ️ Info
Each Discord channel, Telegram chat, and web chat gets its own separate session. They don't share context with each other.
Usage Page 📊
Track your API usage and costs.
- Token usage — How many tokens you've used (input vs output).
- Cost estimates — Approximate cost based on model pricing.
- Time period filters — View by day, week, or month.
- Per-model breakdown — See which models are costing the most.
Cron Page ⏰
Schedule recurring tasks and reminders for your agent.
- Job list — All scheduled jobs with their status (enabled/disabled).
- Add job button — Create a new scheduled task.
- Job fields — Name, schedule (cron expression or interval), message/prompt, and optional model override.
- Run now button — Trigger a job immediately without waiting for its schedule.
- Run history — See when each job last ran and its result.
- Enable/disable toggle — Turn jobs on or off without deleting them.
💡 Tip
Cron is powerful — use it for daily briefings, periodic checks, and reminders. Example: schedule a "morning briefing" every day at 8am that summarizes your calendar and emails.
Agents Page 📁
View your agent(s) and their configuration.
- Agent overview — Name, status, and workspace path.
- Status tab — Shows agent health and recent activity.
- Files tab — Browse your agent's workspace files:
SOUL.md, AGENTS.md, MEMORY.md, the memory/ folder, and more.
- Tools & Skills tab — See what tools and skills are available. Shows "Available Right Now" (what works in the current session) vs "Tool Configuration" (what's configured overall).
⚠️ Note
The Files tab lets you
browse but not edit files directly (inline editing is on the roadmap!). For now, tell your agent in chat — e.g. "update my SOUL.md to be more friendly."
💡 Common confusion: “Where is the SOUL.md text editor?”
If you're following an older tutorial, you may expect a built-in file editor in Config. In the current UI, the safest path is to ask in Chat:
Update my SOUL.md with this tone: .... Your agent can write the file directly and you can verify it in
Agents → Files.
Skills Page ⚡
Manage installed skills — instruction files that teach your agent new abilities.
- Skill list — All installed skills with their descriptions.
- Enable/disable toggle — Turn skills on or off.
- Install button — Install new skills from the library or a URL.
- API key fields — Some skills need API keys — enter them here.
- Skill status — Shows if a skill is active, disabled, or has errors.
ℹ️ Info
Skills are instruction files that teach your agent new abilities. Check the
Skills tutorial for ready-to-use skills and how to install them.
Nodes Page 💻
Manage connected node hosts — external machines your agent can access.
- Node list — Connected machines and hosts.
- Capabilities — What each node can do (exec commands, browser access, etc.).
- Exec approvals — Allowlists for what commands your agent can run on each node.
ℹ️ Info
Most users won't need this page. It's for advanced setups where your agent connects to external machines (like a home server or VPS).
Config Page ⚙️
The raw configuration editor for your entire OpenClaw setup.
- Form view — User-friendly fields organized by category.
- JSON editor — Raw JSON editor for advanced users who want full control.
- Apply & Restart button — Save your changes and restart the gateway to apply them.
- Schema validation — Shows errors if your config is invalid before you save.
🛑 Danger
Be very careful editing config directly. A bad change can break your agent. If you're unsure, ask your agent to make config changes for you in chat — it's safer and it knows the schema.
Communications Page 📤
Channel and messaging configuration.
- Reply behavior — How your agent sends and receives messages.
- Streaming settings — Enable/disable streaming responses and chunk sizes.
- Per-channel overrides — Customize messaging behavior for specific channels.
Appearance Page ✨
UI theme and display settings.
- Dark/Light mode toggle — Switch between dark and light themes.
- Language selector — English, Chinese, Spanish, Portuguese, German.
- UI preferences — Other display customizations.
Automation Page 💻
Exec approvals and command security — control what your agent is allowed to run.
- Gateway exec allowlist — What commands your agent can run on the gateway host.
- Node exec allowlists — What commands can run on connected nodes.
- Ask policy — How the agent requests permission for new or unlisted commands.
Infrastructure Page 🌐
Gateway and network settings.
- Gateway bind settings — What address and port the gateway listens on.
- Auth settings — Token or password for gateway access.
- Proxy settings — Network proxy configuration.
- Remote settings — Remote gateway connection details (for VPS or cloud setups).
AI Agents Page 🧠
Agent and model configuration.
- Agent list — All configured agents.
- Default model — Which AI model your agent uses by default.
- Model overrides — Per-agent or per-session model settings.
- Bindings — Route different conversations to different agents.
Debug Page 🐛
Diagnostics and troubleshooting tools.
- Status snapshot — Current gateway health and state at a glance.
- Health check — Detailed health information for all subsystems.
- Models list — All available models and their current status.
- Event log — Raw event stream for debugging.
- Manual RPC — Send raw commands to the gateway (advanced).
⚠️ Warning
This is a developer tool. You can break things here. Use it only for troubleshooting — not for everyday config changes.
Logs Page 📜
Live log viewer — your first stop when something goes wrong.
- Log stream — Real-time gateway logs as they happen.
- Filter bar — Filter by log level: error, warn, info, debug.
- Export button — Download logs for sharing with support.
💡 Tip
If something goes wrong, check Logs first. Error messages here often explain exactly what happened and point you to the fix.
📋 Quick Reference: "Where Do I Go To…"
| I want to… |
Go here |
| Change my agent's personality |
Chat — tell your agent "update my SOUL.md" |
| I can't find a SOUL.md editor in dashboard settings |
Use Chat to request the edit, then confirm file contents in Agents → Files |
| I clicked "Meet [Agent]" and landed in OpenClaw — is that normal? |
Yes. This dashboard is the current Heyron control UI for many users. |
| Connect to Discord or Telegram |
Channels page |
| See what my agent can do |
Agents → Tools & Skills tab |
| Change which AI model I use |
Chat (model selector) or AI Agents page |
| Schedule a daily briefing |
Cron page |
| Check my API usage / costs |
Usage page |
| Fix something broken |
Debug or Logs page |
| Dashboard works on phone/Chrome but not in Edge |
Try a private window, disable extensions/shields, then check Blank Screen troubleshooting |
| Install a new skill |
Skills page |
| Edit my config |
Config page (careful!) or ask your agent in chat |