Give your virtual office a name. This appears in the sidebar and page title.
2. CONNECT AGENT PROVIDERS
Tell the Virtual Office where your agent runtimes live. OpenClaw and Hermes agents can appear together in the same office.
This is the folder that contains your openclaw.json and agents/ directory.
๐ Where to find it:
Linux/Mac (most common): /home/youruser/.openclaw
Not sure? Run this in your terminal: ls ~/.openclaw/openclaw.json
If it prints a path, use the folder part (e.g. /home/youruser/.openclaw).
๐ Gateway Connection
Configure the gateway to allow this browser to connect for live agent status and chat.
Auth token for chat & live status. Auto-read from OpenClaw config. Override to connect to a different instance.
๐ง No agents found? Here's what to check:
1. Is the path correct?
The folder should contain openclaw.json and an agents/ directory.
2. Do you have agents configured?
Open your openclaw.json and look for "agents" โ "list". Each agent needs a workspace directory.
3. Permissions?
The Virtual Office server needs read access to the agents/ folder.
Still stuck? You can skip this step and set the path later from โฐ Menu. The office will work โ agents just won't appear until connected.
โ๏ธ Hermes Agents
Virtual Office can also discover Hermes Agent profiles and show them beside OpenClaw agents. It uses the Hermes CLI/status surfaces and does not read Hermes secrets or private memory files.
Enter the local Hermes home and CLI paths.
โ Codex CLI Agents
Virtual Office can discover, create, and chat with Codex-backed workspace agents through the native Codex app-server bridge.
When enabled, VO handles Codex approvals instead of user-level approval hooks such as Desktop or Flux Island.
โ Claude Code Agents
Virtual Office can discover, create, and chat with Claude Code-backed workspace agents through the native Claude Code CLI stream-json protocol.
3. AGENT BROWSER (OPTIONAL)
Connect a browser so your agents can browse the web and you can watch live. You can skip this and set it up later.
The address where Chrome/Chromium remote debugging is running.
URL for the live browser view (KasmVNC, noVNC, etc.). This is what shows in the floating browser window so you can watch your agents browse in real time.
What is this? The Agent Browser gives your AI agents a real web browser you can watch live. You need two things:
1. CDP (Chrome DevTools Protocol) โ how agents control the browser 2. VNC Viewer โ how you watch the browser live in the office
Bundled browser image: run ./start.sh --browser from the repository root. It provides CDP on port 9224 and the viewer on port 6901.
Alternatively, start Chrome with --remote-debugging-port and enter its CDP URL above.
Not sure? Skip this step โ everything else works without it. You can set it up later from โฐ Menu.
4. SMS PANEL (OPTIONAL)
Let an AI agent send and receive SMS messages through your office. You can skip this and set it up later.
This agent owns the Twilio inbox and is the default AI responder for every contact thread.
All three Twilio fields are required for sending SMS.
๐ฃ Feishu Notifications
Not configured
AI notifications are sent to the originating user's bot DM. The fallback ID is optional.
้ฟ่ฟๆฅๅฐๅจไฟๅญ้ ็ฝฎๅๅฏๅจใ
The full webhook is stored server-side and never shown back in the browser. Leave the field blank to keep the existing saved webhook.
What is this? The SMS Panel lets you send and receive text messages through an AI agent in your office.
What you need: 1. A Twilio account (free trial works) 2. A Twilio phone number (you get one free with trial) 3. Your Account SID and Auth Token from the Twilio Console dashboard
How to get started:
โข Sign up at twilio.com/try-twilio
โข Copy your Account SID and Auth Token from the dashboard
โข Get a phone number from Console โ Phone Numbers โ Buy a Number
โข Paste all three values above
Photos, videos, and attachments:
โข Incoming MMS media can display in the SMS inbox when Twilio credentials are configured.
โข Outgoing MMS attachments require the office to have a public HTTPS media URL that Twilio can fetch. If the office is only local/private, sending uploaded attachments will not work until a public media endpoint is configured.
โข Text-only SMS still works without a public media URL.
Not sure? Skip this step โ everything else works without it. You can enable it later from โฐ Menu.
5. PC PERFORMANCE (OPTIONAL)
Monitor a PC's CPU, RAM, and GPU stats live in your office dashboard. You can skip this and set it up later.
The address where the PC Metrics Server is running. This can be a local or remote machine.
What is this? The PC Performance panel shows live CPU, RAM, and GPU usage graphs in your office sidebar.
How it works:
You run a small Python script on the PC you want to monitor. It exposes metrics on a port, and the Virtual Office reads from it.
Quick setup (on the target PC): pip install psutil python pc-metrics-server.py 8099
The script is included with the Virtual Office at /app/pc-metrics-server.py. Copy it to any PC you want to monitor.
For GPU monitoring (NVIDIA only): pip install pynvml
URL examples:
โข Same machine: http://127.0.0.1:8099
โข LAN PC: http://192.168.1.100:8099
โข Tailscale: http://100.x.x.x:8099
Not sure? Skip this step โ you can enable it later from โฐ Menu โ Settings.
6. YOU'RE ALL SET!
Your Virtual Office is ready. You can always change settings later from the โฐ Menu button in the toolbar.
What you can do: โข โ๏ธ Edit Office โ Place furniture, resize canvas, paint walls & floors
โข ๐ค Agents โ Customize agent appearance, assign desks, set branches
โข ๐ฌ Chat โ Talk to any agent through the chat panel
โข โฐ Menu โ Change office name, connection settings, export/import config
Live presence: Virtual Office tracks agent activity through the gateway and keeps long-running work visible until it finishes.
โ๏ธ API Usage: The sidebar automatically detects your AI providers (Anthropic, OpenAI, Google, etc.) from your OpenClaw config and shows live usage, quotas, and API key health. No extra setup needed โ just connect to OpenClaw above.