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:

  1. Go to Settings → API Tokens
  2. Click "Generate New Token"
  3. Name your token (e.g., "OpenClaw Integration")
  4. Select the scopes (permissions) you need:
    • walls:read - View walls and items
    • walls:write - Add/update/delete items
    • walls:manage - Create/delete/configure walls
    • account:read - View account info
  5. Click "Generate Token"
  6. 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.ai

3. Install the VitalWall Skill

# Install the VitalWall skill
openclaw skills install vitalwall

# Or if it's in your local skills directory
cd ~/.openclaw/skills/vitalwall

4. Configure the Skill

Edit the skill configuration with your API token:

cd ~/.openclaw/skills/vitalwall
cp config.example.yaml config.yaml

Edit 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: false

5. 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-walls

Usage 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

CommandDescriptionExample
list-wallsList all your wallsvitalwall list-walls
get-wallGet wall detailsvitalwall get-wall abc-123
create-wallCreate a new wallvitalwall create-wall "My Wall"
update-wallUpdate wall settingsvitalwall update-wall abc-123 --name "New Name"
delete-wallDelete a wallvitalwall delete-wall abc-123

Item Management

CommandDescriptionExample
list-itemsList wall itemsvitalwall list-items abc-123
add-itemAdd item to wallvitalwall add-item abc-123 --content "Hello"
delete-itemDelete specific itemvitalwall delete-item abc-123 item-456
clear-itemsClear all itemsvitalwall clear-items abc-123

Demo Walls

CommandDescriptionExample
create-demoCreate a demo wallvitalwall 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

  1. Generate separate tokens for different integrations

    • One token for OpenClaw
    • Another for custom scripts
    • Different tokens for different environments (dev/prod)
  2. Name your tokens descriptively

    • ✅ "OpenClaw on MacBook Pro"
    • ✅ "Production Automation Script"
    • ❌ "Token 1"
  3. Set expiration dates for better security

    • 90 days for development tokens
    • 365 days for production (with calendar reminder)
  4. 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:

  1. Revoke it immediately at /settings/api-tokens
  2. Generate a new token with the same scopes
  3. Update your integration with the new token
  4. 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" --html

Node.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:

  1. Create a Zap trigger (e.g., new sale in Stripe)
  2. Add OpenClaw webhook action
  3. Configure to run: vitalwall add-item <wall-id> --content "..."

Troubleshooting

"Unauthorized" Error

Problem: API token is invalid or revoked

Solution:

  1. Check that your token is correctly configured in config.yaml
  2. Verify the token hasn't been revoked at /settings/api-tokens
  3. Generate a new token if needed

"Insufficient Permissions" Error

Problem: Token doesn't have required scopes

Solution:

  1. Go to /settings/api-tokens
  2. Create a new token with the necessary scopes
  3. Update your config.yaml

"Wall not found" Error

Problem: Wall ID is incorrect or you don't have access

Solution:

  1. List your walls: vitalwall list-walls
  2. Copy the correct wall ID
  3. Verify you own this wall

Debug Mode

Enable debug logging to see detailed request/response information:

# config.yaml
debug: true

Then 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_here

Rate 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?

What's Next?