Administration
Manage people, permissions, sign-in, updates and data.
Permissions decide who can do what in your Sunport. Some things wait for a person's decision, an approval, before they happen.
- Use it when
- You add people, share agents, or wonder why something was refused
- You get
- Two roles, teams, exact permissions, and approvals on record
- Cost
- None of their own
- Setup time
- One invitation per person
- Needs
- An administrator to change roles, teams and permissions
Roles
Everyone who signs in has one of two roles:
- Administrator: manages people, agents, billing and settings. They hold every permission, except denies set on them.
- User: uses the agents an administrator gives them, and sees only their own usage.
The Sunport owner is an administrator whose login only they change. A new owner is set in the OpenOrange app.
Agents
A user reaches an agent at one of two levels: Chat, or Chat and settings. Whoever creates an agent owns it. Settings › Access sets what every owner gets on their own agents.
Teams
A team is a department, and it holds permissions. Everyone in it who isn't an administrator holds them while they are in it. A new member holds them from their first sign-in. Someone who leaves loses them.
Permissions
A permission allows or denies an area, or one exact action:
- View sees an area. Manage also changes it.
- An exact permission is written
ACTION:RESOURCE, such asbilling.read:*. - A deny wins over any allow, a person's own included.
- You can give only what you hold yourself.
So far the dashboard honors only some permissions, marked Works in the dashboard too.
The rest work in oo and the API.
Roles, invitations and sign-ins need an administrator with full access. That is their own sign-in, or an unrestricted key of their own.
Sign-in
People sign in on your Sunport's own sign-in page:
- with their email and password;
- with a passkey added in Settings › Profile;
- with a code sent to their email, while emailed codes are on;
- with Sign in with OpenOrange, once an administrator turns it on.
The owner can also open the Sunport from the OpenOrange app.
Approvals
Some things wait for a person's decision before they happen:
- Asked of you: an agent asks before acting for you, or asks you for a secret. Only you decide, signed in as yourself.
- Clem's changes: some changes Clem makes for an administrator wait for their click, such as making someone an administrator. Clem lists them.
- Pending requests: an operation waits for a person's decision. Nobody decides their own request.
- An agent's skills: when someone who can't change an OpenClaw agent, other than Clem, has it save a skill, the people who can change it are asked. The first approval saves it; any decline ends it. The person who asked is told either way.
An approval is a record, not a permission. It grants nothing. An agent never sees a secret you type. The number beside Settings in the account menu counts what waits for you.
Limits
- A team adds nothing to an administrator, and limits nothing. Only a deny changes what they can do.
- Someone invited holds no permissions until they sign up.
- Nobody changes their own role or sign-in.
- The last active administrator can't be made a user or turned off.
- A deny on seeing any one person keeps the whole Users list from you.
- Clem's changes expire if nobody approves them within a day.
- At most 10 of an agent's skill changes wait at once.
How-to guides
- Invite a person
- Approve an access request
- Change a person's role
- Put people in a team
- Give a permission
- Let people use an agent
- Limit what a person spends
- Link a person's chat account
- Turn off someone's sign-in
- Send a new sign-in link
- Remove a person
- Set agent owners' access
- Decide an approval
- Approve Clem's changes
- Choose how people sign in
- Set a password or passkey
- Edit your profile
Data, privacy and updates
Your Sunport sends OpenOrange only what it needs, and what you choose to share. Administrators choose what is shared, what is kept, and when updates install.
- Use it when
- You must say what OpenOrange sees, keeps or changes
- You get
- Choices for sharing, request content, keys, updates and backups
- Cost
- Backups, snapshots and extra disk are charged to your prepaid balance
- Setup time
- Defaults apply until an administrator changes them
- Needs
- An administrator; holding the keys is the owner's
What your Sunport sends OpenOrange
Settings › Data sharing lists two kinds.
Always sent is what OpenOrange needs to run, bill and update your Sunport. Each item says why it is sent. The record of a model call through OpenOrange never holds its prompt or reply.
Optional sharing starts off until an administrator turns it on:
- Diagnostic evidence: redacted logs from your server, to investigate a problem.
- Investigator access: an investigator may read conversations, files and personal data.
- AI triage of alerts: alert details go to an AI model that suggests a cause.
Two choices start differently:
- Automatic key handoff starts on. With it off, moving to a new server needs your recovery file.
- Error reports start on for public Sunports, and off for enterprise ones.
What is off isn't sent, and OpenOrange refuses it.
Request content
The text of model requests and replies is kept for the Requests pages. Settings › Privacy chooses:
- how long it is kept: not at all, 7, 30 or 90 days, or forever;
- a disk budget, past which the oldest text is cleared first;
- whether administrators can open other people's.
Everyone can open their own. Every view is recorded in the audit log. Usage and billing numbers are always kept.
Keys
Your Sunport's keys open its conversations, request logs and nightly backups. Until you hold them, OpenOrange keeps a copy to restore or move your Sunport. The owner can hold them. OpenOrange then deletes its copy for good.
Maintenance access
OpenOrange can't sign in to your Sunport's server until an administrator opens access. Access lasts 1 hour, 24 hours, or until someone ends it. Every change is recorded in the audit log.
Updates
New OpenOrange releases install automatically, unless you hold them. Settings › Updates chooses:
- windows when updates may start, in your time zone;
- a hold until a date;
- whether security updates install at once, outside your windows.
An update already running may finish. Update now asks for the newest release for your Sunport, outside your windows. While agents are working, it waits until they finish, unless you install at once. The dashboard and Clem restart, and each agent restarts in turn. New chat messages can't be sent until the update has finished. To plan updates, your Sunport tells OpenOrange how many agent runs are open and when it was last used. It also sends the browser time zone of the administrator who last used the dashboard. Managed by OpenOrange lists what OpenOrange sets for your Sunport.
Backups
Settings › Backups holds three kinds:
- Nightly backups (off-server) copy the database, settings and files into OpenOrange's backup storage.
- Daily backups copy a machine's whole disk once a day. The last seven are kept.
- Snapshots copy a machine's whole disk, and stay until you delete them.
Each is charged to your prepaid balance at the provider's price.
Limits
- Usage and billing numbers are kept whatever the content setting.
- Holding the keys can't be undone.
- Turning backups off deletes them, and can't be undone.
- Update now skips your schedule, but not a hold.
- The dashboard restores agent and service VMs only.
- A bigger disk can't shrink again.
How-to guides
How-to guides
Invite a person
Before you start: you need to be an administrator, and your Sunport's mail must be set up. An administrator can make you one.
- Open Users and choose Invite.
- In Email, type their address.
- Under Role, choose User or Administrator.
- For a user, choose the Agents they can use.
- Under What they can do with these agents, choose Chat or Chat and settings.
- Optionally, choose a Team.
- Choose Send invite.
Check it worked: Invite sent. appears, and their row in Users shows Invited.
Permissions and approvals explains roles and levels.
Approve an access request
Before you start: you need to be an administrator, signed in as yourself. An administrator can make you one.
- Open Users. Requests wait under Access requests.
- Check who wrote, and whether their email is confirmed.
- Choose Access to: and pick the agents they get.
- To tell them, turn on Email them that they're in.
- Choose Approve as user, or Decline.
Check it worked: the request leaves Access requests, and they appear in Users.
Permissions and approvals explains roles and levels.
Change a person's role
Before you start: you need to be an administrator, signed in as yourself.
- Open Users and open the person.
- Open the ⋯ menu beside Edit.
- Choose Make administrator, or Make user.
- Confirm with the same button.
Check it worked: their page shows Administrator or User.
Permissions and approvals explains what each role holds.
Put people in a team
Before you start: you need to be an administrator. An administrator can make you one.
- Open Users and choose Teams.
- Choose New team, type a Name, and choose Create.
- Open the team and give it permissions under Team permissions.
- Open Users, open a person, and choose Edit.
- In Team, type the team's name and choose Save.
Check it worked: the team's People lists them.
Permissions and approvals explains teams.
Give a permission
Before you start: in the dashboard, you need to be an administrator, signed in as yourself. With oo, See users (people.read) and Manage API permissions (access.manage) are enough. You can give only what you hold.
- Open Users, open the person, and open the Permissions tab. For a team, open Teams and the team.
- Choose Add permission.
- Under Allow or deny, choose Allow or Deny.
- Choose what it covers, or Choose permissions to pick areas.
- Under Which agents?, choose All agents or Choose agents.
- Choose Allow, or Deny.
Check it worked: it shows under Allowed and denied.
Permissions and approvals explains areas and denies.
Link a person's chat account
Before you start: you need to be an administrator. An administrator can make you one.
- Open Users and open the person.
- Open the Chats tab and choose Link a chat account.
- Pick it under Seen accounts, or type it under Enter an ID and choose Continue.
- Choose Link account.
Check it worked: the account shows under Chat accounts.
Permissions and approvals explains who reaches which agent.
Turn off someone's sign-in
Before you start: you need to be an administrator, signed in as yourself. An administrator can make you one.
- Open Users and open the person.
- Open the ⋯ menu beside Edit.
- Choose Disable sign-in, then Disable sign-in again.
Check it worked: their page shows Disabled. Enable sign-in in the same menu turns it back on.
Permissions and approvals explains roles and sign-in.
Send a new sign-in link
Before you start: you need to be an administrator, signed in as yourself. An administrator can make you one. Their sign-in must be on.
- Open Users and open the person.
- Open the ⋯ menu beside Edit.
- Choose Send a new sign-in link…, then Send link.
Check it worked: Sign-in link sent. appears.
Permissions and approvals explains how people sign in.
Remove a person
Before you start: you need to be an administrator, signed in as yourself. An administrator can make you one.
- Open Users and open the person.
- Open the ⋯ menu beside Edit and choose Remove from Sunport….
- Read the list of what happens.
- Choose Remove from Sunport.
Check it worked: their row in Users shows Removed.
Permissions and approvals explains roles and sign-in.
Set agent owners' access
Before you start: you need to be an administrator, signed in as yourself. An administrator can make you one.
- Open Settings › Access.
- Under An agent's owner gets, choose Chat or Chat and settings.
- Choose Save.
- Confirm with Lower to Chat, or Raise to Chat and settings.
Check it worked: the page says agent owners now get the level you chose.
How agents work explains owners and access levels.
Decide an approval
Before you start: the approval must be asked of you. Sign in as yourself, not with a narrower key.
- Open Settings › Approvals.
- Under Asked of you, read what the agent asks.
- Choose Approve or Decline.
- For a secret, type it and choose Save.
Check it worked: choose History. It shows Approved, Declined or Given.
oo clem waiting lists them.Permissions and approvals explains what waits for whom.
Choose how people sign in
Before you start: you need to be an administrator, signed in as yourself. An administrator can make you one.
- Open Settings › Sign-in.
- Turn Let members sign in with OpenOrange on or off.
- Turn Let people sign in with a code sent to their email on or off.
- For the owner, open Settings › Maintenance access.
- Turn Allow opening from the app on or off.
Check it worked: Saved. appears beside each switch you changed.
Permissions and approvals explains each way to sign in.
Set a password or passkey
Before you start: you need your own login, not a key.
- Open Settings › Profile.
- Under Password, type your Current password, if asked, and a New password.
- Choose Set password, or Change password.
- Under Passkeys, choose Add a passkey and follow your device.
Check it worked: Password set. You can now sign in with it., Password changed. Your other devices are signed out. or Passkey added. You can sign in with it now. appears.
Permissions and approvals explains each way to sign in.
Edit your profile
Before you start: you need your own login.
- Open Settings › Profile and choose Edit profile.
- Change Name, or choose Change image.
- Choose Save changes.
Check it worked: Profile updated appears.
Choose your theme and currency
Before you start: anyone signed in can choose these.
oo has no command for this. Choose them in the dashboard:
- Open Settings › Preferences.
- Under Theme, choose System, Light or Dark.
- Under Currency, if it shows, choose USD or RUB.
- Under Activity view, choose List or Map.
Check it worked: each choice applies as soon as you make it.
Schedule updates
Before you start: you need Change settings (settings.write). Not an administrator? Ask one to give you See settings and Change settings.
- Open Settings › Updates.
- Under Automatic updates, keep Install updates automatically on.
- To limit when, turn on Only during set windows. Set each window's days, From and Until.
- Choose a Time zone.
- To pause, turn on Hold updates until a date and pick Resume on.
- Turn Install security updates at once on or off.
- Choose Save.
Check it worked: Saved. appears, and the summary says when updates install.
Data, privacy and updates explains how updates install.
Update your Sunport now
Before you start: you need Change settings (settings.write). Not an administrator? Ask one to give you See settings and Change settings.
- Open Settings › Updates.
- Under Update now, choose Update to followed by the version on offer.
- To be safe, turn on Snapshot every machine first.
- Choose Update now.
Check it worked: Update history shows it In progress, then Succeeded.
The dashboard and Clem restart, and each agent restarts in turn. New chat messages can't be sent until it has finished. Afterwards, oo update matches your oo to the Sunport.
--install --now) installs at once and stops their work. Don't update (--cancel) drops the waiting update.Data, privacy and updates explains how updates install.
Set request retention
Before you start: in the dashboard, you need to be an administrator. With oo, See settings (settings.read) and Change settings (settings.write) are enough; an administrator can give you See settings and Change settings.
- Open Settings › Privacy.
- Under Keep request and response content, choose a period.
- Under Disk budget, choose the most disk it may use.
- Turn Administrators can view content on or off.
- Choose Save.
Check it worked: Saved. appears.
Data, privacy and updates explains what is kept.
Hold the keys yourself
Before you start: you need to be the Sunport's owner, signed in as yourself.
- Open Settings › Privacy.
- Under Keys, choose Download recovery file.
- Keep the file somewhere safe.
- Under Keys, choose the recovery file you just downloaded.
- In Hold this Sunport's keys yourself?, choose Hold the keys.
Check it worked: Keys says your Sunport holds its keys itself.
Data, privacy and updates explains what the keys open.
Let OpenOrange into your server
Before you start: in the dashboard, you need to be an administrator. With oo, See settings (settings.read) and Full control of the Sunport (sunport.root) are enough; an administrator can give you See settings and Full control of the Sunport.
- Open Settings › Maintenance access.
- Choose Open access.
- Under How long, choose 1 hour, 24 hours or Until closed.
- For Until closed, tick I understand that access stays open until someone ends it.
- Choose Open access.
Check it worked: the page shows Open. End access now ends it early.
Data, privacy and updates explains maintenance access.
Export activity
Before you start: in the dashboard, you need to be an administrator. With oo, See users (people.read) is enough; an administrator can give you See users.
- Open Overview and choose the period.
- Choose Export people CSV.
Check it worked: your browser downloads a CSV file.
Data, privacy and updates explains what your Sunport keeps.
Turn on backups
Before you start: you need Manage recovery (recovery.manage) and Start jobs (jobs.create). Not an administrator? Ask one to give you See recovery, Manage recovery and Start jobs.
- Open Settings › Backups.
- Under Nightly backups (off-server), choose Turn on.
- Under a machine's Daily backups, choose Turn on.
Check it worked: The first backup runs tonight. appears, and the machine says when its daily backups are taken.
Data, privacy and updates explains each kind of backup.
Take a snapshot
Before you start: you need Manage recovery (recovery.manage) and Start jobs (jobs.create). Not an administrator? Ask one to give you See recovery, Manage recovery and Start jobs.
- Open Settings › Backups.
- Under the machine's Snapshots, optionally type a name.
- Choose Take snapshot.
Check it worked: the snapshot shows Being taken…, then its size.
Data, privacy and updates explains each kind of backup.
Restore a VM backup
Before you start: you need to be an administrator. An administrator can make you one. The VM must be running.
- Open Settings › Backups.
- Under the VM's Restore, choose a backup or snapshot.
- Choose Restore….
- Type the VM's name and choose Overwrite and restore.
Check it worked: the VM's Restore says it was restored from that copy.
Data, privacy and updates explains each kind of backup.
Grow the server disk
Before you start: you need to be an administrator. An administrator can make you one.
- Open Settings › Server disk.
- Under Grow the disk, choose a New size.
- To apply it now, tick Restart the Sunport now so it takes effect.
- Choose Grow disk.
- Check the price, and choose Grow disk again.
Check it worked: the page shows the new size once the grow is done.
Data, privacy and updates explains what is charged.