Use Token Plan with OpenClaw
Install OpenClaw
Install Node.js
Install OpenClaw
Configure
| Parameter | Value |
|---|---|
| I understand this is powerful and inherently risky. Continue? | Select "Yes" |
| Onboarding mode | Select "QuickStart" |
| Model/auth provider | Select "Skip for now". You can configure this later. |
| Filter models by provider | Select "All providers" |
| Default model | Keep the default setting. |
| Select channel (QuickStart) | Select "Skip for now". You can configure this later. |
| Configure skills now? (recommended) | Select "No". You can configure this later. |
| Enable hooks? | Press the Spacebar to select "Skip for now", then press the Enter key. |
| How do you want to hatch your bot? | Select "Hatch in TUI". |
Configure Token Plan in OpenClaw
- Use terminal
- Use web browser
Open the configuration file
Paste the configuration
YOUR_API_KEY with your Token Plan API key.Existing configuration: If you have an existing configuration, do not replace the entire content. For more information, see How to safely modify an existing configuration.Apply the configuration
Use OpenClaw
- Web browser
- CLI
Common commands
| Command | Description | Example |
|---|---|---|
| /help | Lists available commands. | /help |
| /status | Shows the current model, session, and gateway. | /status |
| /model <model_name> | Switches the model for the current session. | /model qwen3.6-plus |
| /new | Starts a new session. | /new |
| /compact | Compacts the conversation history, freeing space in the context window. | /compact |
| /think <level> | Sets the inference depth level. Options include off, low, medium, and high. | /think high |
| /skills | Lists all available skills. | /skills |
Switch models
- Switch model in current session (temporary)
-
Switch the default model (persistent)
Change the
agents.defaults.model.primaryfield in the configuration file. See Configure Token Plan in OpenClaw.
Integrate message channels
- WhatsApp
- Telegram
- Discord
Step 1: Install the WhatsApp plugin
The WhatsApp channel is integrated as a plugin. Run the following command to install the plugin:Step 2: Configure the WhatsApp channel
Enter the following prompt in an OpenClaw conversation. OpenClaw will ask for your phone number, which must be in E.164 format (a plus sign, followed by the country code and phone number). It then automatically adds the number to the configuration and completes the setup.selfChatMode. In this mode, the bot responds only to messages you send to yourself, without affecting other chats.Step 3: Link WhatsApp
- Run the following command to start the WhatsApp linking process. A QR code is displayed in the terminal.
- Open WhatsApp on your phone and scan the QR code in the terminal to complete the linking process.
- Restart the gateway.
Step 4: Test
- Run the following command to check the WhatsApp channel status:
ON with a status of OK.- In WhatsApp, send a message to yourself to verify that the bot responds correctly.
Use cases
Use case 1: Automating X (Twitter)
You can use OpenClaw to automate your X (Twitter) account, letting you create posts, reply to posts, search, and browse your timeline.
Configuration steps
Configuration steps
- Run the following command in your terminal to install twitter-cli.
- Enter the following prompt in an OpenClaw conversation to automatically install the Skill.
- Once the installation is complete, return to the terminal and restart the gateway to activate the Skill.
- Verify the Skill installation.
- twitter-cli uses browser cookies for authentication. Ensure you are signed in to x.com in a supported browser (Chrome, Edge, Firefox, Arc, or Brave). twitter-cli will automatically extract your cookies. Alternatively, you can manually set authentication credentials using environment variables:
auth_token and ct0 under Cookies.Example 1: Automatically publish a post
Example 1: Automatically publish a post
Check Sam Altman's recent posts, summarize the key points, and then help me publish a post with my take on it. OpenClaw will automatically fetch the latest updates, analyze the content, and publish the post.Example 2: Search for trending topics
Example 2: Search for trending topics
Help me search for posts about harness engineering from yesterday. OpenClaw will search for relevant posts and summarize the key points.Use case 2: YouTube video analysis and download
With OpenClaw, you can search for YouTube videos by keyword, sort them by date, retrieve video metadata in batches, and download them.
Configuration steps
Configuration steps
- Run the following command in your terminal to install yt-dlp.
- Verify the installation.
- (Optional) Configure cookie authentication. To access age-restricted, members-only, or private videos, configure YouTube cookies. Ensure you are signed in to youtube.com in your browser, then enter the following prompt in an OpenClaw conversation:
yt-dlp command to perform video-related operations.Example 1: Summarize video content
Example 1: Summarize video content
Help me summarize the main content of this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0. OpenClaw will extract the video information and generate a summary.Example 2: Download a video
Example 2: Download a video
Help me download this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0. OpenClaw will call yt-dlp to download the video to your local machine.Use case 3: Scheduling AI news delivery
Use the OpenClaw cron job feature to automatically fetch the latest AI news and send it to WhatsApp daily.
Configuration steps
Configuration steps
- Run the following command in your terminal:
| Parameter | Description |
|---|---|
--name | A unique name for the cron job. |
--cron | The schedule in cron expression format. For example, "0 9 * * *" runs the job daily at 09:00. |
--tz | The time zone for the schedule, such as "UTC", "America/New_York", or "Europe/London". |
--message | The prompt sent to the agent, which specifies what content to fetch and how to summarize it. |
--channel | The channel for delivering the result, such as whatsapp. |
--announce | Announces the result in the specified channel. |
--to | The recipient's WhatsApp phone number. Use E.164 format: a plus sign (+), country code, and phone number. |
-
After creating the cron job, you can trigger a manual run to verify that it works correctly.
- List the cron jobs to get the task ID.
- Manually trigger the job.
- Check the job's execution status.
"status": "ok" and "delivered": true, this indicates that the news was delivered successfully to WhatsApp.Use case 4: Stock market monitoring and analysis
Use OpenClaw to analyze stock trends and get technical analysis and investment advice.
Configuration steps
Configuration steps
- Install the Skill. Enter the following prompt in an OpenClaw conversation, and OpenClaw will automatically complete the installation:
- Once the installation is complete, return to the terminal and restart the gateway to activate the Skill.
- In an OpenClaw conversation, ask a stock market-related question, such as
Analyze NVDA stock.
Learn more
Skill
A skill is an extensible capability module. The agent automatically matches and loads the appropriate skill for a given request. OpenClaw lets you view and enable built-in skills, install community skills from ClawHub, or create custom skills.
View existing skills
- Run the following commands to view your installed skills and their status.
- Built-in skills are disabled by default. To enable built-in skills, add them to the
skills.allowBundledwhitelist in your~/.openclaw/openclaw.jsonfile. OpenClaw loads only the built-in skills listed in this whitelist.
skills.entries section of your ~/.openclaw/openclaw.json file. For details, refer to the Skills configuration documentation.
Find more skills
Use one of the following methods to find and install more skills.
- Search and install from ClawHub ClawHub offers over 3,000 community skills. You can browse them on the website or search for them from the command line.
-
Ask OpenClaw directly
Describe what you need directly in the conversation, for example:
Help me find a skill that can check the weather. OpenClaw will automatically search for and install a matching skill.
Create a custom skill
- Create a directory for your skill.
- In this directory, create a
SKILL.mdfile. The file consists of two parts: YAML front matter and Markdown instructions. Thenameanddescriptionfields are required. The agent uses thedescriptionto determine whether to load the skill, so ensure it is accurate.
- Restart the gateway to activate the skill.
FAQ
How do I view the models configured for Token Plan?
How do I view the models configured for Token Plan?
openclaw tui to open the OpenClaw command line. Then, enter /model to view the model list. Press Enter to select a model and Esc to exit the list.What should I do if I receive an "API rate limit reached" error?
What should I do if I receive an "API rate limit reached" error?
-
Incorrect OpenClaw configuration
An incorrect Base URL or model provider configuration can cause requests to be routed to a generic API instead of the dedicated channel for Token Plan, triggering the rate limit.
-
If you are using a Token Plan plan, verify that the
models,agents, andgatewayfields (including nested fields) in your OpenClaw configuration file match the configuration provided in the documentation. For example, the structure for the model provider is{ "models": { "providers": { "bailian": {...} } } }. - If you are not currently using a Token Plan plan, we recommend switching to one for a dedicated quota.
-
If you are using a Token Plan plan, verify that the
- You may have exceeded your plan's quota. Check your plan's usage on the Token Plan page.
- Try resetting your API key: If the issue persists after the steps above, go to the Token Plan page to reset it.
Why am I receiving an "HTTP 401: Incorrect API key provided." or "No API key found for provider xxx" error?
Why am I receiving an "HTTP 401: Incorrect API key provided." or "No API key found for provider xxx" error?
- The API key is invalid, expired, empty, incorrectly formatted, or does not match the endpoint environment. Verify that the API key is the one designated for your Token Plan plan. Ensure that you have copied the entire key without any extra spaces and that your subscription is active.
-
An outdated OpenClaw configuration is cached, causing an error. To fix this, delete the
providersconfiguration in the~/.openclaw/agents/main/agent/models.jsonfile and restart OpenClaw.
I have already configured other channels. How can I safely add Token Plan models without losing my existing configuration?
I have already configured other channels. How can I safely add Token Plan models without losing my existing configuration?
- If OpenClaw is working correctly: Enter the following prompt in an OpenClaw conversation to merge the configurations.
- If OpenClaw has no model configured or is not working: Follow the instructions in Guided configuration.
Prompt content (replace YOUR_API_KEY with your actual API key)
Prompt content (replace YOUR_API_KEY with your actual API key)
openclaw models status.What should I do if I receive a "device identity required" error?
What should I do if I receive a "device identity required" error?
- You have accessed the address in your browser for the first time and have not completed device pairing.
- The browser cache was cleared, and the device key was lost.
- After reinstalling or upgrading OpenClaw, the key file in the
~/.openclaw/identity/directory is missing.
openclaw devices list. Verify that your device appears in the "Paired" list. This confirms a successful pairing.