fred/homelab-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1a67a0192868fac22cebbb1bd461501c410f9897
homelab-docs/infrastructure/OPENCLAW-QUICKSTART.md

8.1 KiB
Raw Blame History

OpenClaw Quick Start Guide

Container: CT 130 (10.0.10.28) Auth Token: 0b0259af04929be8424b51b6520b4bb48c70d0f595dde9fb6f4c3d5d6410a9fa Status: Gateway running and accessible on LAN

Gateway Status

✅ Onboarding Complete ✅ Gateway Running (check with pct exec 130 -- pgrep -f 'openclaw gateway') ✅ LAN Accessible at ws://10.0.10.28:18789 ✅ Model Configured: claude-sonnet-4-5 ✅ Hooks Enabled: boot-md, command-logger, session-memory ✅ Commands Enabled: bash (native commands enabled) ✅ User Profile: Created at /root/USER.md with Fred's preferences

Current Configuration

  • Bind Address: LAN (0.0.0.0:18789)
  • Auth Mode: Token-based
  • Tailscale: Disabled (using direct LAN access)
  • Dashboard: http://10.0.10.28:18789

Verify Gateway Status

# Check if Gateway is running
pct exec 130 -- pgrep -f "openclaw gateway"

# Test connectivity from Proxmox host
curl -I http://10.0.10.28:18789

# Or from your local machine
curl -I http://10.0.10.28:18789

Manual Start/Stop Commands

If you need to manually control the Gateway:

# Start Gateway in foreground (for testing)
ssh root@10.0.10.3 "pct exec 130 -- openclaw gateway"

# Start Gateway in background
ssh root@10.0.10.3 "pct exec 130 -- nohup openclaw gateway > /var/log/openclaw-gateway.log 2>&1 &"

# Stop Gateway
ssh root@10.0.10.3 "pct exec 130 -- pkill -f 'openclaw gateway'"

# View logs
ssh root@10.0.10.3 "pct exec 130 -- tail -f /var/log/openclaw-gateway.log"

Systemd Service (If Installed)

If the onboarding installed a systemd service:

# Check status
ssh root@10.0.10.3 "pct exec 130 -- systemctl status openclaw-gateway"

# Start/Stop/Restart
ssh root@10.0.10.3 "pct exec 130 -- systemctl start openclaw-gateway"
ssh root@10.0.10.3 "pct exec 130 -- systemctl stop openclaw-gateway"
ssh root@10.0.10.3 "pct exec 130 -- systemctl restart openclaw-gateway"

# Enable auto-start on boot
ssh root@10.0.10.3 "pct exec 130 -- systemctl enable openclaw-gateway"

# View logs
ssh root@10.0.10.3 "pct exec 130 -- journalctl -u openclaw-gateway -f"

Installing Desktop Client (iMac)

After Gateway is running:

  1. Download OpenClaw for macOS:

  2. Install:

    • Open the .dmg file
    • Drag OpenClaw to Applications folder
    • Open OpenClaw from Applications

  3. Configure Connection:

    • Gateway URL: ws://10.0.10.28:18789
    • Auth Token: 0b0259af04929be8424b51b6520b4bb48c70d0f595dde9fb6f4c3d5d6410a9fa
    • Or use the auto-discovery (should find Gateway on LAN)

  4. Device Pairing:

    • iMac should auto-pair (local network)
    • Check Gateway dashboard to approve pairing if needed

Configuring Your 4 Automation Workflows

Once desktop client is connected, configure these workflows:

1. Morning Brief (8:00 AM)

Create a new agent or scheduled task with this prompt:

I want you to send me a morning brief every morning at 8am my time. I want this morning brief to include:
- The local weather for the day
- A list of a few trending YouTube videos about my interests
- A list of tasks I need to get done today based on my todo list
- Tasks that you think you can do for me today that will be helpful based on what you know about me
- A list of trending stories based on my interests
- Recommendations you can make for me that will make today super productive

Schedule: Daily at 8:00 AM (use cron: 0 8 * * *)

2. Proactive Coder (11:00 PM)

Create a scheduled coding agent:

I am a 1 man business. I work from the moment I wake up to the moment I go to sleep. I need an employee taking as much off my plate and being as proactive as possible.

Please take everything you know about me and just do work you think would make my life easier or improve my business and make me money. I want to wake up every morning and be like "wow, you got a lot done while I was sleeping."

Don't be afraid to monitor my business and build things that would help improve our workflow. Just create PRs for me to review, don't push anything live. I'll test and commit. Every night when I go to bed, build something cool I can test. Schedule time to work every night at 11pm.

Schedule: Daily at 11:00 PM (use cron: 0 23 * * *) Tools Enabled: file, bash, git (for creating PRs)

3. Second Brain (NextJS Document Viewer)

Initial setup prompt:

I want you to build me a 2nd brain. This should be a NextJS app that shows a list of documents you create as we work together in a nice document viewer that feels like a mix of Obsidian and Linear.

I want you to create a folder where all the documents in that folder are viewable in this 2nd brain. Update your memories/skills so that as we talk every day, you create documents in that 2nd brain that explore some of the more important concepts we discuss.

You should also create daily journal entries that record from a high level all our daily discussions.

This is a project task, not a scheduled task Agent should: Create the NextJS app, set up document folder, configure auto-documentation

4. Afternoon Research Report

Create a scheduled research agent:

I want a daily research report sent to me every afternoon. Based on what you know about me I want you to research and give me a report about a concept that would improve me, processes that would improve our working relationship, or anything else that would be helpful for me.

Examples would be:
- Deep dives on concepts I'm interested in like machine learning
- A new workflow we can implement together that will improve our productivity

Schedule: Daily at 2:00 PM (use cron: 0 14 * * *) Tools Enabled: web search, web fetch

Troubleshooting

Gateway won't start

# Check config
ssh root@10.0.10.3 "pct exec 130 -- openclaw doctor"

# Fix configuration issues
ssh root@10.0.10.3 "pct exec 130 -- openclaw doctor --fix"

# Check logs
ssh root@10.0.10.3 "pct exec 130 -- cat /var/log/openclaw-gateway.log"

Can't connect from iMac

# Verify Gateway is listening on LAN interface
ssh root@10.0.10.3 "pct exec 130 -- netstat -tlnp | grep 18789"

# Test from Proxmox host
ssh root@10.0.10.3 "curl -I http://10.0.10.28:18789"

# Check firewall (container shouldn't have firewall by default)
ssh root@10.0.10.3 "pct exec 130 -- iptables -L"

Auth token issues

# Verify token is set
ssh root@10.0.10.3 "pct exec 130 -- openclaw config get gateway.auth.token"

# Reset token if needed
ssh root@10.0.10.3 "pct exec 130 -- openclaw config set gateway.auth.token NEW_TOKEN_HERE"

Configuration Files

Main config: /root/.openclaw/openclaw.json Gateway state: /root/.openclaw/gateway/ Agent configs: /root/.openclaw/agents/ Credentials: /root/.openclaw/credentials/

Backup Important Files

Regularly backup the OpenClaw state:

# From Proxmox host
ssh root@10.0.10.3 "pct exec 130 -- tar -czf /tmp/openclaw-backup.tar.gz /root/.openclaw"
ssh root@10.0.10.3 "pct exec 130 -- mv /tmp/openclaw-backup.tar.gz /mnt/omv-backups/openclaw/"

Next Steps After Setup

  1. ✅ Complete onboarding
  2. ✅ Verify Gateway is running and accessible
  3. Install desktop client on iMac
  4. Configure device pairing
  5. Set up 4 automation workflows
  6. Test voice integration on iMac
  7. Configure Home Assistant integration
  8. Set up n8n webhook integration
  9. Test all scheduled tasks

Resources

Status: Gateway running and ready for iMac client connection Last Updated: 2026-01-31

Reference in New Issue View Git Blame Copy Permalink