- FreeToken openclaw uses browser sessions instead of traditional provider API keys.
- Supported providers include DeepSeek, Qwen, Kimi, Claude, ChatGPT, Gemini, Grok, and others.
- Basic setup requires Node.js 22.12.0 or newer and pnpm 9.0.0 or newer.
- Daily workflow uses Chrome debug mode, onboarding, and the OpenClaw gateway server.
- Security priority is protecting local cookies, bearer credentials, and workspace access.
FreeToken openclaw Overview
FreeToken openclaw is a browser-authenticated OpenClaw setup designed to connect with multiple AI web services through a unified gateway. Instead of starting with a separately purchased API key for every provider, the workflow uses a browser login, captures the required session credentials locally, and exposes configured models through the OpenClaw interface.
This approach is useful for experimentation, model comparison, and personal agent workflows. It is not the same as an official unlimited API service. Web sessions can expire, web endpoints may apply rate limits, and each provider’s terms of use still apply.
Unified Gateway
Chat with configured providers through one Web UI, CLI/TUI, or local HTTP gateway.
Browser Authentication
Sign in through supported web interfaces, then let the onboarding flow save local session data.
Multi-Model Testing
Compare answers from several providers or broadcast one question with AskOnce.
| Area | FreeToken openclaw approach | Practical meaning |
|---|---|---|
| Authentication | Browser login and local session capture | Provider access begins in a normal browser session |
| Model access | Unified provider layer | Switch models without changing the entire client |
| Gateway | Local HTTP service | Web UI, CLI, and integrations can use one running service |
| Tool calling | Prompt-injected local tools | Configured agents may use tools such as read, write, exec, and web search |
| Licensing | MIT project license | Review project terms and third-party service terms separately |
Treat this setup as a local research and automation environment. Begin with one provider, verify the gateway, and add more sessions only after the basic workflow is stable.
Provider and Model Comparison
The provider layer is the main reason to use OpenClaw in a zero-token configuration. Several web providers are listed as tested, while Manus is described separately with an API-based free quota. Support details can vary by provider, so configure only the services you actively need.
| Provider | Example models | Chat | Tool calling | Authentication style |
|---|---|---|---|---|
| DeepSeek Web | deepseek-chat, deepseek-reasoner | Supported | Supported | Browser session |
| Qwen Web | Qwen 3.5 Plus, Qwen 3.5 Turbo | Supported | Supported | Browser session |
| Kimi | Moonshot v1 8K/32K/128K | Supported | Supported | Browser session |
| Claude Web | Claude Sonnet 4-6, Opus 4-6, Haiku 4-6 | Supported | Supported | Browser session |
| ChatGPT Web | GPT-4, GPT-4 Turbo | Supported | Supported | Browser session |
| Gemini Web | Gemini Pro, Gemini Ultra | Supported with stability notes | Supported with DOM polling notes | Browser session |
| Grok Web | Grok 1, Grok 2 | Supported | Supported | Browser session |
| GLM Web | GLM-4 Plus, GLM-4 Think | Supported | Supported | Browser session |
| Doubao Web | doubao-seed-2.0, doubao-pro | Limited chat notes | Not available in the listed tool-calling matrix | Browser session |
| Manus | Manus 1.6, Manus 1.6 Lite | Supported through listed quota | Not presented as zero-token web access | API key with free quota |
For model switching, use the /model command in the chat box. Exact model identifiers are preferable when a provider has multiple variants. For example, a Claude configuration may resolve more reliably with /model claude-web/claude-sonnet-4-6 than with the shorter provider-only command.
| Command | Purpose | Example |
|---|---|---|
/models | List configured providers and models | Shows active model, aliases, and configuration |
/model provider | Select a provider alias | /model deepseek-web |
/model provider/model | Select an exact model | /model claude-web/claude-sonnet-4-6 |
| AskOnce | Send one question to multiple models | Compare replies side by side |
Do not assume every provider has identical behavior. Gemini may have DOM polling instability, and Doubao is excluded from the listed tool-calling flow because of a stream parser limitation.
Step-by-Step Setup Guide
The recommended installation path uses Node.js, pnpm, a Chrome debug session, the web authentication wizard, and the gateway server. Keep the browser and terminal sessions available while completing onboarding.
Install the Required Tools
Use Node.js version 22.12.0 or newer and pnpm version 9.0.0 or newer. macOS and Linux are supported directly. On Windows, use WSL2 and then follow the Linux workflow.
Clone and Build the Project
Clone the OpenClaw zero-token project, enter its directory, then run pnpm install, pnpm build, and pnpm ui:build. Use pnpm for the build commands rather than substituting another package manager.
Start Chrome Debug Mode
Run ./start-chrome-debug.sh and keep that terminal open. The browser debug session provides the environment for logging into supported web providers.
Log In and Run Onboarding
Sign in to the provider websites you want to use. In a new terminal, run ./onboard.sh webauth, choose the relevant provider, and allow the wizard to capture the required local session credentials.
Start the Gateway
Run ./server.sh. The command starts the gateway and Web UI, then prints the address to open in your browser. Use ./server.sh status to inspect the service later.
| Setup stage | Command or action | Expected result |
|---|---|---|
| Dependencies | pnpm install | Installs project packages |
| Application build | pnpm build | Builds the main application |
| UI build | pnpm ui:build | Builds the Web UI |
| Browser session | ./start-chrome-debug.sh | Opens Chrome debug environment |
| Authentication | ./onboard.sh webauth | Creates provider authentication configuration |
| Gateway | ./server.sh | Starts the local HTTP gateway and Web UI |
Configure DeepSeek, Qwen, or another single provider first. Confirm that /models lists the provider and that a basic chat request works before adding additional browser sessions.
Gateway Usage and Configuration
Once the gateway is running, the Web UI is the simplest place to test configured models. The CLI/TUI is available with node openclaw.mjs tui, while local integrations can send requests to the HTTP endpoint using the gateway token defined in configuration.
The default example configuration uses port 3001 and token-based gateway authentication. Keep this gateway token separate from provider cookies and bearer credentials. They protect different boundaries: the gateway token controls local API access, while provider credentials authorize web sessions.
curl \
-H "Authorization: Bearer YOUR_GATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-web/deepseek-chat",
"messages": [{"role": "user", "content": "Hello!"}]
}'
| Interface | Access method | Best use |
|---|---|---|
| Web UI | Open the URL printed by ./server.sh | Everyday chat and model switching |
| CLI/TUI | node openclaw.mjs tui | Terminal-based interaction |
| HTTP API | Local gateway request with bearer token | Scripts and compatible integrations |
| Model catalog | /models | Confirm configured providers and aliases |
| Model switcher | /model | Change the active provider or model |
Tool calling is designed to activate when a prompt suggests an action such as searching, fetching, reading, writing, messaging, or executing a local command. Workspace restrictions are controlled through the configured agent workspace, so keep that directory narrowly scoped.
Only providers completed through ./onboard.sh webauth are written into the configuration and displayed by /models. A provider may be supported by the project but absent from your local catalog until onboarding is complete.
Security, Troubleshooting, and Maintenance
Browser-authenticated automation requires careful credential handling. Cookies and bearer tokens are stored in local authentication files, including the project’s local state area. Never commit those files to a repository, paste them into public issue reports, or share them in screenshots.
Web sessions may expire, and providers may impose rate limits. This makes the setup better suited to personal testing and moderate workloads than to heavy production traffic. Re-authenticate through the browser when a provider stops responding or the local session becomes invalid.
Maintenance Checklist:
- Keep auth.json and local state directories out of version control
- Use a narrowly scoped workspace for agent file access
- Check provider sessions when requests begin failing
- Use ./server.sh status before restarting the gateway
- Run the doctor command when required directories are missing
| Symptom | Recommended action | Important limitation |
|---|---|---|
| Missing directories | Run node dist/index.mjs doctor | The command does not create openclaw.json or auth-profiles.json |
| Missing authentication files | Run ./onboard.sh webauth again | Re-authentication may be required |
ERR_MODULE_NOT_FOUND | Remove dist, dist-runtime, and node_modules; reinstall and rebuild | Finish with pnpm ui:build |
| Hash mismatch errors | Perform a clean rebuild | Use pnpm build, not npm run build |
| Expired web session | Log in again through Chrome and rerun onboarding | Session lifetime depends on the provider |
| Gateway problem | Use ./server.sh restart or inspect ./server.sh status | Confirm the printed port and local token |
A clean rebuild follows this sequence:
rm -rf dist dist-runtime node_modules
pnpm install
pnpm build
pnpm ui:build
./server.sh restart
When adding a new web provider, the project structure separates authentication, API client, and stream handling. A provider generally needs an authentication module, a web client, a stream handler, and registration in the stream factory. This separation makes provider-specific behavior easier to maintain.
Use browser automation only in ways permitted by each service. The project disclaimer places responsibility for compliance with third-party terms on the operator.
FreeToken openclaw FAQ
Q: What is FreeToken openclaw?
FreeToken openclaw refers to a browser-authenticated OpenClaw workflow that connects multiple AI web providers through one local gateway. It reduces reliance on separately purchased API keys but does not remove provider limits, session expiration, or service terms.
Q: Does FreeToken openclaw require an API token?
The listed zero-token web providers use browser login and locally stored session credentials instead of a traditional provider API key. Manus is listed separately with an API key and free quota, so it should not be treated as the same authentication path.
Q: Which operating systems are supported?
macOS and Linux are supported directly. Windows users should use WSL2 and then follow the Linux installation steps.
Q: Why does a configured provider not appear in /models?
Only providers completed through ./onboard.sh webauth are written into the local OpenClaw configuration. Run the onboarding wizard for that provider, then check /models again.
The most reliable workflow is simple: build with pnpm, authenticate one provider, verify /models, start the gateway, and expand gradually.