Agent create

[kindred blade]

I've created a new agent on my remote node. But i can't see the agent in the gateway.

[upbeat anchor]

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

[undone ibex]

Agents don’t “live” on nodes — only the machine running the Gateway owns/loads agents. A node is just a paired peripheral device (screen/camera/exec/etc), and it won’t show up as an agent in the Gateway UI. (Docs: https://docs.openclaw.ai/help/faq#do-nodes-run-a-gateway-service)

What usually happened here:

• You ran openclaw agents add ... on the node machine (or on your laptop while in “remote mode”), so it wrote to that machine’s ~/.openclaw/openclaw.json.
• But the Gateway you’re looking at is running on a different host, so it never sees that new agent.

Fix

Create the agent on the Gateway host (SSH into the box that runs openclaw gateway ...) and run:

openclaw agents list
openclaw agents add <agentId> --workspace <path>
openclaw gateway restart

Quick sanity checks (paste output)

On the host where the Gateway is running:

openclaw --version
openclaw gateway status
openclaw agents list

And tell me which machine you ran the “create agent” command on (gateway host vs node vs your local machine). If you paste those, I can tell you exactly where the agent got created and how to move/recreate it cleanly.

Docs for agent management: https://docs.openclaw.ai/cli/agents
Nodes overview: https://docs.openclaw.ai/nodes