OpenClaw Integration
Control your VitalWall walls using voice commands, text chat, and automation with OpenClaw (formerly Clawdbot) - the AI assistant that connects to your tools and services.
What is OpenClaw?
OpenClaw is an AI-powered assistant that runs on your computer and connects to your favorite tools. With the VitalWall skill installed, you can:
- Create walls with voice commands
- Add items to walls via natural language
- Manage wall settings through conversation
- Automate wall updates from scripts and workflows
Quick Start
1. Generate Your API Token
First, create a personal API token to authenticate OpenClaw with your VitalWall account:
- Go to Settings → API Tokens
- Click "Generate New Token"
- Name your token (e.g., "OpenClaw Integration")
- Select the scopes (permissions) you need:
walls:read- View walls and itemswalls:write- Add/update/delete itemswalls:manage- Create/delete/configure wallsaccount:read- View account info
- Click "Generate Token"
- Copy your token immediately - you won't see it again!
⚠️ Important: Store your API token securely (password manager recommended). It provides access to your VitalWall account.
2. Install OpenClaw
If you don't have OpenClaw installed:
# macOS (Homebrew)
brew install openclaw
# Or download from openclaw.ai3. Install the VitalWall Skill
# Install the VitalWall skill
openclaw skills install vitalwall
# Or if it's in your local skills directory
cd ~/.openclaw/skills/vitalwall4. Configure the Skill
Edit the skill configuration with your API token:
cd ~/.openclaw/skills/vitalwall
cp config.example.yaml config.yamlEdit config.yaml:
# VitalWall Skill Configuration
supabase_url: "https://clyfgobyllqtvmfchczj.supabase.co"
# Use your personal API token (recommended)
auth_mode: "api_token"
api_token: "vw_live_your_token_here" # Paste your token here
# Optional: enable debug logging
debug: false5. Test the Integration
Try these commands with OpenClaw:
"Create a new wall called Team Updates"
"Add an item to my wall: Just shipped v2.0!"
"Show me all my walls"Or test directly:
cd ~/.openclaw/skills/vitalwall
./bin/vitalwall list-wallsUsage Examples
Voice Commands
Talk to OpenClaw naturally:
Create a wall:
- "Create an event ticketing wall"
- "Make a new wall for customer reviews"
- "Set up a grid wall with 4 columns"
Add items:
- "Add a ticket sale to my wall: Taylor Swift concert, $250"
- "Post this to my team wall: Deployed to production"
- "Add a new review: 5 stars from John D."
Manage walls:
- "Show me all my walls"
- "Update my sales wall to show 100 items"
- "Clear all items from my test wall"
- "Delete my old demo wall"
Get information:
- "How many walls do I have?"
- "When was my ticketing wall last updated?"
- "Show me recent items on my team wall"
Text Commands
Use the CLI directly for scripts and automation:
# List all your walls
vitalwall list-walls
# Create a new wall
vitalwall create-wall "Product Launches" \
--layout grid \
--limit 50 \
--description "Recent product launches"
# Add an item
vitalwall add-item <wall-id> \
--content "<div class='launch'>Launched v2.0</div>" \
--html
# Update wall settings
vitalwall update-wall <wall-id> \
--name "Updated Name" \
--limit 100
# Create a demo wall
vitalwall create-demo event-ticketing
# Clear all items
vitalwall clear-items <wall-id>
# Delete a wall
vitalwall delete-wall <wall-id>Command Reference
Wall Management
| Command | Description | Example |
|---|---|---|
list-walls | List all your walls | vitalwall list-walls |
get-wall | Get wall details | vitalwall get-wall abc-123 |
create-wall | Create a new wall | vitalwall create-wall "My Wall" |
update-wall | Update wall settings | vitalwall update-wall abc-123 --name "New Name" |
delete-wall | Delete a wall | vitalwall delete-wall abc-123 |
Item Management
| Command | Description | Example |
|---|---|---|
list-items | List wall items | vitalwall list-items abc-123 |
add-item | Add item to wall | vitalwall add-item abc-123 --content "Hello" |
delete-item | Delete specific item | vitalwall delete-item abc-123 item-456 |
clear-items | Clear all items | vitalwall clear-items abc-123 |
Demo Walls
| Command | Description | Example |
|---|---|---|
create-demo | Create a demo wall | vitalwall create-demo event-ticketing |
Available demo slugs: event-ticketing, developer-blog, luxury-ecommerce, crypto-trading, restaurant-orders, fitness-bookings, iot-sensors, and more.
API Token Scopes
When creating your API token, select the appropriate scopes for your use case:
walls:read
- View walls and their settings
- List items on walls
- Get wall details
- Recommended for: Read-only integrations, monitoring
walls:write
- Add new items to walls
- Update existing items
- Delete items
- Recommended for: Event posting, content updates
walls:manage
- Create new walls
- Update wall settings (name, layout, limits)
- Delete walls
- Recommended for: Full automation, admin tasks
account:read
- View your account information
- Get user profile details
- Recommended for: Integration setup, debugging
Scope Combinations
For most users (posting content):
- ✅
walls:read - ✅
walls:write
For full automation:
- ✅
walls:read - ✅
walls:write - ✅
walls:manage - ✅
account:read
For monitoring only:
- ✅
walls:read - ✅
account:read
Security Best Practices
Token Management
-
Generate separate tokens for different integrations
- One token for OpenClaw
- Another for custom scripts
- Different tokens for different environments (dev/prod)
-
Name your tokens descriptively
- ✅ "OpenClaw on MacBook Pro"
- ✅ "Production Automation Script"
- ❌ "Token 1"
-
Set expiration dates for better security
- 90 days for development tokens
- 365 days for production (with calendar reminder)
-
Revoke unused tokens immediately
- Check your token list monthly
- Remove tokens for old integrations
Storing Tokens
✅ DO:
- Store in password manager (1Password, LastPass, etc.)
- Use environment variables for scripts
- Use OpenClaw's encrypted config
- Keep tokens in
.gitignored files
❌ DON'T:
- Commit tokens to git repositories
- Share tokens in Slack/email
- Store in plaintext notes
- Reuse tokens across multiple systems
If Your Token is Compromised
If you believe your token was exposed:
- Revoke it immediately at /settings/api-tokens
- Generate a new token with the same scopes
- Update your integration with the new token
- Review audit logs for suspicious activity
Automation Examples
Bash Script: Post Events to Wall
#!/bin/bash
# post-to-wall.sh - Post events to VitalWall
WALL_ID="your-wall-id-here"
# Source VitalWall CLI
source ~/.openclaw/skills/vitalwall/bin/lib.sh
load_config
# Add an event
EVENT_HTML='<div class="event">
<h3>New Sale</h3>
<p>$250 - Taylor Swift Tickets</p>
<span class="time">2 minutes ago</span>
</div>'
vitalwall add-item "$WALL_ID" --content "$EVENT_HTML" --htmlNode.js: Automated Wall Updates
const { exec } = require('child_process');
const util = require('util');
const execPromise = util.promisify(exec);
async function addToWall(wallId, content) {
const command = `vitalwall add-item ${wallId} --content "${content}"`;
const { stdout } = await execPromise(command);
return JSON.parse(stdout);
}
// Use in your app
await addToWall('abc-123', 'New order received!');Zapier Integration (via Webhooks)
Use OpenClaw's webhook skill to trigger wall updates:
- Create a Zap trigger (e.g., new sale in Stripe)
- Add OpenClaw webhook action
- Configure to run:
vitalwall add-item <wall-id> --content "..."
Troubleshooting
"Unauthorized" Error
Problem: API token is invalid or revoked
Solution:
- Check that your token is correctly configured in
config.yaml - Verify the token hasn't been revoked at /settings/api-tokens
- Generate a new token if needed
"Insufficient Permissions" Error
Problem: Token doesn't have required scopes
Solution:
- Go to /settings/api-tokens
- Create a new token with the necessary scopes
- Update your
config.yaml
"Wall not found" Error
Problem: Wall ID is incorrect or you don't have access
Solution:
- List your walls:
vitalwall list-walls - Copy the correct wall ID
- Verify you own this wall
Debug Mode
Enable debug logging to see detailed request/response information:
# config.yaml
debug: trueThen run commands and check the output for detailed logs.
API Reference
For direct API integration (without OpenClaw), see our API Documentation.
All API token requests should include the header:
X-API-Token: vw_live_your_token_hereRate Limits
API tokens are subject to rate limiting to ensure fair usage:
- Read operations: 100 requests/minute
- Write operations: 60 requests/minute
- Burst allowance: 20 requests
If you exceed rate limits, you'll receive a 429 Too Many Requests response. The audit log will record rate limit events.
Support
Need help with the OpenClaw integration?
- Documentation: VitalWall Docs
- OpenClaw Docs: openclaw.ai/docs
- Email Support: support@vitalwall.com
- Community: Discord
