Install
openclaw plugins install clawhub:fluent-openclawFluent for OpenClaw
Fluent connects OpenClaw to a personal context layer you own: your kitchen, your closet, your budgets — the real state of your life, not a guess. Ask "what should I cook this week?" or "does this jacket fit what I own?" and your assistant answers from what's actually there.
You stay in control. Nothing is written without your explicit approval, every fact carries its source, and your data is yours to export or delete. Fluent holds the context; your assistant does the thinking — it won't shop, check out, or act on your accounts.
Works with the hosted Fluent service or your own self-hosted runtime. Free while in early access.
This repository is the canonical public source for the published fluent-openclaw package. The embedded openclaw-plugin/fluent bundle shipped inside fluent-oss is a separate OSS helper package with its own metadata and versioning; neither package line is generated from the other.
Release Status
fluent-openclaw is now a public beta release.
- package version:
0.1.9 - install surface: public
- Fluent early access: scoped self-serve account creation when launch controls allow it, currently free
- plugin-managed hosted auth: beta
- setup command labels:
cloudandoss - minimum compatible Fluent MCP contract version:
2026-07-09.fluent-core-v2.0 - current reference Fluent MCP contract version:
2026-07-09.fluent-core-v2.0 - public profile: 26 tools, 3 resources, 14 explicit writes, and 3 optional render adapters
- required hosted scopes:
meals:read,meals:write,style:read,style:write,offline_access - packaging decision: standalone
fluent-openclawis the canonical published package; thefluent-ossembedded bundle is a separate OSS helper
Install
Public install:
openclaw plugins install fluent-openclaw
Local checkout install:
openclaw plugins install .
The package targets Node.js 22+ and OpenClaw plugin API 2026.3.24-beta.2 or newer.
For both managed early access and self-hosted use, the supported public OpenClaw install surface is still fluent-openclaw. Do not treat fluent-oss/openclaw-plugin/fluent as the same package release line.
Early-Access Setup
- Install
fluent-openclaw. - Run
openclaw fluent auth login. - Open the printed URL in your browser and finish sign-in.
- Bind Fluent early access into OpenClaw with
openclaw fluent mcp --track cloud. - Confirm the connection with
openclaw fluent doctor.
Run Fluent Yourself
- Start Fluent open-source runtime by following the public docs in shaner-git/fluent-oss.
- Bind Fluent open-source runtime into OpenClaw:
openclaw fluent mcp --track oss --base-url http://127.0.0.1:8788 --token <oss-token>
- Confirm the connection with:
openclaw fluent doctor --track oss --base-url http://127.0.0.1:8788 --token <oss-token>
- Start a fresh OpenClaw session so it reloads the updated MCP registry.
Commands
openclaw fluent auth loginopenclaw fluent auth refreshopenclaw fluent auth statusopenclaw fluent auth logoutopenclaw fluent mcp --track cloudopenclaw fluent mcp --track oss --base-url http://127.0.0.1:8788 --token <oss-token>openclaw fluent doctoropenclaw fluent deep-check
openclaw fluent doctor verifies local auth state, mcp.servers.fluent binding, and the live Fluent compatibility probe. openclaw fluent deep-check is an explicit alias for the same full check.
OpenClaw Compared With ChatGPT, Claude, Codex, And Generic MCP
| Capability | OpenClaw | ChatGPT | Claude | Codex | generic MCP clients |
|---|---|---|---|---|---|
| Fluent MCP public tools | Yes | Yes | Yes | Yes | Yes |
| Fluent MCP public resources | Yes | Yes | Yes | Yes | Yes |
| Native packaged Fluent client plugin | Yes | No | No | Yes | No |
| Bundled Fluent skills and routing hints | Yes | No | No | Yes | No |
| Plugin-managed hosted auth helper in this package | Yes | No | No | No | No |
| Open-source MCP binding helper in this package | Yes | No | No | Yes | Manual config |
| Rich Fluent app views | Host-dependent for promoted surfaces only | Promoted surfaces only | Host-dependent for promoted surfaces only | Host-dependent for promoted surfaces only | Host-dependent for promoted surfaces only |
| Text-first Fluent workflows | Yes | Yes | Yes | Yes | Yes |
| Current Fluent app widgets | Host-dependent for promoted surfaces only | Promoted grocery-list, budgets, and Style closet surfaces only | Host-dependent for promoted surfaces only | Host-dependent for promoted surfaces only | Host-dependent for promoted surfaces only |
Practical guidance:
- Fluent keeps the same memory and tools across clients. Each assistant may present them differently.
- OpenClaw supports the same canonical public Fluent
/mcpprofile as ChatGPT, Claude, Codex, and generic MCP clients, plus a native plugin package with Fluent skills, auth helpers, and MCP setup commands. - The package requires Fluent contract
2026-07-09.fluent-core-v2.0as both its minimum compatible and current reference contract. - The current public profile is text/data first by default. It exposes Meals and Style, narrow
meals-groceriesandstyle-clothingbudget context, and only the currently promoted grocery-list, Budgets Envelope Setup, and Style Closet Manager view families. - Health/Wellbeing is reserved and not an active public product surface in this package.
- Claude, Codex, OpenClaw, and generic MCP clients should use Fluent's tools and complete text-first answers unless the host explicitly proves MCP Apps-style widget support.
- OpenClaw should be treated like Claude and Codex for Fluent UI expectations: use Fluent's saved memory and let the host present the results conversationally.
Known Limitations
- This package is public beta, not GA.
- Fluent is scoped self-serve early access and currently free. Account creation can pause when launch controls or the current cohort cap require it, and plugin-managed hosted auth remains beta.
- OpenClaw does not render Fluent rich app views today.
- Open-source runtime setup still requires an explicit bearer token.
- Browser and retailer execution helpers are intentionally omitted from the OpenClaw package.
- Unsafe local browser automation and retailer checkout scripts are not part of this plugin and are not required for standard installs.
Docs
- Package versioning: docs/package-versioning.md
- OpenClaw setup: guides/connecting-to-openclaw.md
- Client configuration: guides/client-configuration.md
- Troubleshooting: guides/troubleshooting.md
- Package known limitations: docs/known-limitations.md
- Package support matrix: docs/support-matrix.md
- GitHub release checklist: docs/github-release-checklist.md
- Public docs repo: shaner-git/fluent-docs
Contact
- General:
hello@meetfluent.app - Support:
hello@meetfluent.app - Security and privacy:
security@meetfluent.app
Notes
- Fluent early access is the managed path; the open-source runtime is available when you want to run Fluent yourself.
- The plugin manages hosted auth and rewrites
mcp.servers.fluentfor OpenClaw. - The bundled
openclaw-plugin/fluentcopy insidefluent-ossis an OSS helper package, not the publishedfluent-openclawartifact. - Browser and retailer execution helpers are intentionally excluded so normal installs do not require unsafe-install overrides.
