Prerequisites: Node.js v18 or higher.
Install
Verify:
Commands
| Command | Description |
|---|
celerflow login | Authenticate via browser (device code flow with Google OAuth). |
celerflow connect --code <CODE> | Connect local agent to a workspace using a setup code. |
celerflow status | Show connection status, workspace, agent list, and token info. |
celerflow doctor | Run diagnostics: auth, network, token validity, registration. |
celerflow disconnect | Gracefully disconnect the agent (data preserved). |
celerflow remove | Permanently remove the agent and delete its data. |
Authentication flow
- The CLI requests a device code from the CelerFlow API.
- Your browser opens to
celerflow.vercel.app/cli-auth.
- Sign in with Google and confirm the code displayed in the terminal.
- The CLI receives your token and saves it to
~/.celerflow/credentials.json.
Credentials persist across sessions. You only need to log in once per machine. Use --force to re-authenticate.
Connecting an agent
celerflow connect --code ABC123
- Sends the setup code to CelerFlow for verification.
- Registers the agent with a unique ID.
- Receives a bootstrap token for future API calls.
- Generates
openclaw.plugin.json in the agent workspace with the CelerFlow plugin config.
- Saves agent configuration to
~/.celerflow/agent.json.
Don’t share or commit agent.json or openclaw.plugin.json — they contain your bootstrap token.
Global options
| Option | Description |
|---|
--json | Output as JSON (supported by status). |
--yes | Skip confirmation prompts (supported by remove). |
--no-browser | Print the auth URL instead of opening a browser (supported by login). |
Uninstall
npm uninstall -g celerflow
rm -rf ~/.celerflow
