clawharbor

Category: Tools & Productivity | Uploader: clawharbor | Downloads: 0 | Version: v1.0（Latest）

Virtual office dashboard — pixel-art NPCs for your OpenClaw agents. Install, manage, and interact with your retro AI office.

Changelog: Source: GitHub https://github.com/clawharbor/clawharbor

Directory Structure

Current level: Root

📁 app/
- 📁 api/
  - 📁 auth/
    
    📁 token/
    
    📄 route.ts 858 B
  - 📁 demo/
    
    📁 actions/
    
    📄 route.ts 375 B
    
    📁 autowork/
    
    📄 route.ts 495 B
    
    📁 battle/
    
    📄 route.ts 2.8 KB
    
    📁 challenges/
    
    📄 route.ts 1.4 KB
    
    📁 chat/
    
    📄 route.ts 1.2 KB
    
    📁 config/
    
    📄 route.ts 394 B
    
    📁 meeting/
    
    📁 start/
    
    📄 route.ts 727 B
    
    📄 route.ts 395 B
    
    📁 message/
    
    📄 route.ts 217 B
    
    📁 stop/
    
    📄 route.ts 214 B
    
    📄 route.ts 2.0 KB
  - 📁 github/
    
    📁 stars/
    
    📄 route.ts 964 B
  - 📁 office/
    
    📁 actions/
    
    📄 route.ts 19.5 KB
    
    📁 autowork/
    
    📄 route.ts 13.9 KB
    
    📁 challenges/
    
    📄 route.ts 4.0 KB
    
    📁 chat/
    
    📄 route.ts 9.5 KB
    
    📁 config/
    
    📄 route.ts 2.1 KB
    
    📁 cooldown/
    
    📄 route.ts 1.3 KB
    
    📁 logs/
    
    📄 route.ts 5.4 KB
    
    📁 meeting/
    
    📁 simulate/
    
    📄 route.ts 11.0 KB
    
    📁 start/
    
    📄 route.ts 1.6 KB
    
    📄 route.ts 3.4 KB
    
    📁 message/
    
    📄 route.ts 4.2 KB
    
    📁 open-file/
    
    📄 route.ts 2.4 KB
    
    📁 screenshot/
    
    📄 route.ts 3.3 KB
    
    📁 stop/
    
    📄 route.ts 2.2 KB
    
    📄 route.ts 26.1 KB
  - 📁 og/
    
    📄 route.tsx 4.4 KB
  - 📁 payroll/
    
    📁 bankr/
    
    📄 route.ts 2.3 KB
- 📁 card/
  - 📁 [name]/
    
    📄 layout.tsx 1.4 KB
    
    📄 page.tsx 12.8 KB
  - 📄 page.tsx 3.7 KB
- 📁 creators/
  - 📄 page.tsx 13.5 KB
- 📁 demo/
  - 📄 data.ts 21.4 KB
  - 📄 page.tsx 110 B
- 📁 help/
  - 📄 page.tsx 8.7 KB
- 📁 install/
  - 📄 page.tsx 13.2 KB
- 📁 landing/
  - 📄 page.tsx 29.0 KB
- 📁 leaderboard/
  - 📄 page.tsx 8.8 KB
- 📁 quest-templates/
  - 📄 data.ts 6.1 KB
- 📁 showcase/
  - 📄 page.tsx 9.9 KB
- 📁 stats/
  - 📄 page.tsx 16.8 KB
- 📄 icon.tsx 612 B
- 📄 layout.tsx 2.5 KB
- 📄 not-found.tsx 983 B
- 📄 page.tsx 104.8 KB
- 📄 robots.ts 287 B
- 📄 sitemap.ts 1.3 KB
📁 bin/
- 📄 first-time-setup.sh 4.3 KB
- 📄 openclawfice.js 28.0 KB
- 📄 sync-cooldowns.ts 7.8 KB
📁 components/
- 📄 AccomplishmentDetailModal.tsx 5.6 KB
- 📄 AchievementToast.tsx 4.0 KB
- 📄 ActivityHeatmap.tsx 7.9 KB
- 📄 AgentBattle.tsx 21.3 KB
- 📄 AgentCard.tsx 12.4 KB
- 📄 AgentPanel.tsx 27.0 KB
- 📄 AgentPayroll.tsx 27.3 KB
- 📄 AutoworkBanner.tsx 3.0 KB
- 📄 BootSequence.tsx 7.6 KB
- 📄 BurnoutSystem.tsx 14.9 KB
- 📄 CallMeetingModal.tsx 6.7 KB
- 📄 Celebration.tsx 5.8 KB
- 📄 ChatBubble.tsx 1.9 KB
- 📄 CommandPalette.tsx 16.1 KB
- 📄 CooldownTimer.tsx 3.5 KB
- 📄 CustomizeDemo.tsx 6.4 KB
- 📄 DailyChallenge.tsx 4.3 KB
- 📄 DemoBanner.tsx 5.2 KB
- 📄 DemoTour.tsx 8.5 KB
- 📄 index.ts 1.6 KB
- 📄 MeetingRoom.tsx 10.4 KB
- 📄 MultiRoomGrid.tsx 31.3 KB
- 📄 NPC.tsx 21.3 KB
- 📄 NPCParticles.tsx 5.5 KB
- 📄 OfficeEvents.tsx 12.7 KB
- 📄 OfficeReplay.tsx 21.3 KB
- 📄 OnboardingModal.tsx 8.5 KB
- 📄 Room.tsx 4.4 KB
- 📄 SettingsPanel.tsx 9.6 KB
- 📄 ShareCard.tsx 17.2 KB
- 📄 ShareModal.tsx 6.7 KB
- 📄 TemplateGallery.tsx 7.0 KB
- 📄 types.ts 1.4 KB
- 📄 utils.ts 5.0 KB
📁 docs/
- 📁 blog/
  - 📄 building-virtual-office-for-ai-agents.md 5.2 KB
- 📁 community/
  - 📄 COMMUNITY.md 10.6 KB
  - 📄 GOOD-FIRST-ISSUES.md 13.5 KB
- 📁 configuration/
  - 📄 AGENTS.md 13.2 KB
  - 📄 CONFIGURING-YOUR-OFFICE.md 17.8 KB
- 📁 development/
  - 📄 API-REFERENCE.md 9.3 KB
  - 📄 ROADMAP.md 5.3 KB
  - 📄 TESTING-GUIDE.md 11.8 KB
- 📁 getting-started/
  - 📄 FIRST-5-MINUTES.md 5.8 KB
- 📁 guides/
  - 📄 KEYBOARD-SHORTCUTS.md 2.7 KB
- 📁 internal/
  - 📁 marketing/
    
    📄 LAUNCH-ANNOUNCEMENT-READY.md 10.5 KB
    
    📄 LAUNCH-CHECKLIST-SIMPLE.md 1.4 KB
    
    📄 MARKETING-LAUNCH-CHECKLIST.md 6.8 KB
    
    📄 POST-LAUNCH-COMMUNITY-STRATEGY.md 12.0 KB
    
    📄 VIRAL-CONTENT-CALENDAR.md 13.2 KB
    
    📄 YOUTUBE-SCRIPT.md 4.8 KB
    
    📄 📍-MARKETING-MASTER-INDEX.md 8.1 KB
  - 📁 session-notes/
    
    📄 CAPITALIZE-ON-ORGANIC-DISCOVERY.md 8.3 KB
    
    📄 GITHUB-ISSUES-TO-CREATE.md 3.1 KB
    
    📄 ONBOARDING-IMPROVEMENTS.md 11.1 KB
    
    📄 PRODUCTIVITY-METRICS-PLAN.md 20.0 KB
    
    📄 READY-TO-POST-NOW.md 4.1 KB
    
    📄 WHATS-BEEN-BUILT.md 9.3 KB
    
    📄 ⚡-ACTION-REQUIRED.md 4.6 KB
    
    📄 ✅-PIXEL-SESSION-COMPLETE.md 4.4 KB
    
    📄 🌅-DAY-2-MORNING-CHECKLIST.md 6.8 KB
    
    📄 🎉-BREAKTHROUGH-MOMENT.md 6.3 KB
    
    📄 🎉-DAY-1-VICTORY.md 6.2 KB
    
    📄 🎯-SESSION-SUMMARY.md 3.8 KB
    
    📄 🎯-START-HERE.md 5.6 KB
    
    📄 📅-TOMORROW-BATTLE-PLAN.md 7.9 KB
    
    📄 📊-CURRENT-STATUS.md 3.5 KB
    
    📄 🚦-PRE-FLIGHT-CHECKLIST.md 6.3 KB
  - 📁 twitter/
    
    📄 COMPLETE-TWITTER-SYSTEM-SUMMARY.md 8.0 KB
    
    📄 CRITICAL-TWITTER-BLOCKER.md 1.4 KB
    
    📄 DAY-3-TWITTER-PLAN.md 3.2 KB
    
    📄 LAUNCH-DAY-TWITTER-STRATEGY.md 11.7 KB
    
    📄 MILESTONE-TWEET-TEMPLATES.md 5.4 KB
    
    📄 START-TWITTER-ENGAGEMENT-NOW.md 5.1 KB
    
    📄 TWEETS-TO-POST-NOW.md 5.7 KB
    
    📄 TWITTER-DAILY-CHECKLIST.md 3.3 KB
    
    📄 TWITTER-ENGAGEMENT-COMPLETE.md 5.5 KB
    
    📄 TWITTER-ENGAGEMENT.md 3.7 KB
    
    📄 TWITTER-GROWTH-ROADMAP.md 11.4 KB
    
    📄 TWITTER-MANUAL-ACTION-PLAN.md 5.4 KB
    
    📄 TWITTER-METRICS-COMPLETE.md 7.2 KB
    
    📄 TWITTER-METRICS-TRACKER.md 8.9 KB
    
    📄 TWITTER-QUICK-START.md 9.3 KB
    
    📄 TWITTER-REPLIES-READY.md 4.7 KB
    
    📄 TWITTER-REPLY-BANK.md 6.5 KB
    
    📄 TWITTER-SYSTEM-COMPLETE.md 14.1 KB
    
    📄 VIBE-CODING-MANIFESTO-TWEET.md 4.8 KB
    
    📄 📍-TWITTER-MASTER-INDEX.md 9.3 KB
- 📁 launch/
  - 📄 LAUNCH-BUTTON.txt 4.6 KB
  - 📄 LAUNCH-NOW.txt 4.1 KB
- 📁 security/
  - 📄 SECURITY.md 6.3 KB
- 📁 support/
  - 📄 FAQ.md 10.1 KB
- 📁 viral/
  - 📄 AGENT-TRADING-CARDS.md 9.8 KB
- 📄 HIDDEN-FEATURES.md 8.1 KB
- 📄 PRODUCT-HUNT-LAUNCH-KIT.md 10.4 KB
- 📄 README.md 1.5 KB
- 📄 TWITTER-CONTENT-READY.md 5.6 KB
- 📄 TWITTER-ENGAGEMENT-STRATEGY.md 8.7 KB
- 📄 WHY-OPENCLAWFICE.md 3.4 KB
- 📄 ZERO-TO-HERO-5-MINUTES.md 6.5 KB
📁 hooks/
- 📄 useAuthenticatedFetch.ts 1.6 KB
- 📄 useAuthToken.ts 728 B
- 📄 useChiptune.ts 9.0 KB
- 📄 useDemoMode.ts 1.2 KB
- 📄 useRetroSFX.ts 6.6 KB
📁 lib/
- 📄 auth-client.ts 1.1 KB
- 📄 auth.ts 3.4 KB
- 📄 challenges.ts 3.5 KB
- 📄 file-finder.ts 4.7 KB
- 📄 gateway-rpc.ts 1.1 KB
- 📄 input-validation.ts 3.6 KB
📁 memory/
- 📄 2026-02-25.md 2.5 KB
📁 pages/
- 📄 _error.tsx 924 B
📁 public/
- 📄 clawharbor-demo.gif 5.0 MB
- 📄 deployment-flow-diagram.html 11.0 KB
- 📄 icon.svg 1.2 KB
- 📄 install.sh 8.3 KB
- 📄 landing.html 11.0 KB
- 📄 launch-dashboard.html 12.3 KB
- 📄 manifest.json 347 B
- 📄 og-image.png 387.4 KB
- 📄 security-dashboard.html 13.0 KB
- 📄 social-card-template.html 9.3 KB
- 📄 tweet-generator.html 9.1 KB
- 📄 viral-templates.html 18.1 KB
📁 scripts/
- 📄 auto-generate-demo-gif.js 6.4 KB
- 📄 check.sh 3.0 KB
- 📄 create-demo-gif.sh 3.1 KB
- 📄 fix-demo-gif-crop.sh 2.2 KB
- 📄 fix-demo-gif-rerecord.sh 3.3 KB
- 📄 generate-og-image.mjs 6.3 KB
- 📄 get-token.sh 707 B
- 📄 lint-style.sh 1.3 KB
- 📄 pre-recording-check.sh 4.3 KB
- 📄 publish-to-clawhub.sh 912 B
- 📄 quick-fix.sh 3.7 KB
- 📄 README.md 5.3 KB
- 📄 record-accomplishment.sh 2.9 KB
- 📄 record-app-window.sh 4.1 KB
- 📄 record-demo-gif.mjs 3.7 KB
- 📄 record-demo-gif.sh 6.4 KB
- 📄 record-feature-demo.sh 5.5 KB
- 📄 record-feature.sh 2.9 KB
- 📄 record-isolated-visible.mjs 6.6 KB
- 📄 record-isolated.mjs 7.0 KB
- 📄 record-isolated.sh 4.3 KB
- 📄 record-loom.sh 3.3 KB
- 📄 restart.sh 295 B
- 📄 test-demo-simulation.sh 1.6 KB
- 📄 test-feature-recording.sh 2.6 KB
📁 skill/
- 📄 install.sh 1.8 KB
- 📄 SKILL.md 2.1 KB
📁 templates/
- 📄 OFFICE.md 4.5 KB
📁 tests/
- 📄 api.test.ts 11.1 KB
📁 twitter-metrics/
- 📁 daily/
  - 📄 2026-02-25.md 4.9 KB
- 📄 DAILY-TRACKING-CARD.md 2.7 KB
- 📄 GROWTH-DASHBOARD.md 6.2 KB
📄 CHANGELOG.md 7.5 KB
📄 CLA.md 2.8 KB
📄 CONTRIBUTING.md 8.6 KB
📄 FIRST-TWEET-DRAFT.txt 424 B
📄 HOW-IT-WORKS.md 9.9 KB
📄 INSTALL.md 6.4 KB
📄 LAUNCH-POST.md 3.5 KB
📄 LICENSE 33.9 KB
📄 middleware.ts 630 B
📄 next.config.ts 130 B
📄 openclawfice.config.example.json 729 B
📄 package-lock.json 128.7 KB
📄 package.json 1.4 KB
📄 POST-THIS-TWEET-NOW.txt 2.2 KB
📄 QUICK-REF.txt 1.6 KB
📄 QUICKSTART.md 3.8 KB
📄 README.md 6.5 KB
📄 SECURITY.md 6.2 KB
📄 SKILL.md 12.2 KB
📄 tsconfig.json 598 B
📄 TWITTER-COMPLETE-SYSTEM.txt 5.6 KB
📄 TWITTER-WORK-COMPLETE.txt 3.0 KB
📄 vercel.json 28 B
📄 vitest.config.ts 266 B
📄 🔥-DO-THIS-NOW.txt 2.9 KB
📄 🔥-QUOTE-TWEET-NOW.txt 2.3 KB
📄 🚀-READY-TO-LAUNCH.txt 1.5 KB

SKILL.md

---
name: clawharbor
description: Virtual office dashboard — pixel-art NPCs for your OpenClaw agents. Install, manage, and interact with your retro AI office.
homepage: https://clawharbor.work
metadata:
  openclaw:
    emoji: "🏢"
    requires:
      bins: ["node", "npm", "git"]
    minNodeVersion: "18"
---

# clawharbor Skill

Turn your AI agents into pixel-art NPCs in a retro virtual office. Watch them work, complete quests, earn XP, and chat at the water cooler.

**Live demo:** https://clawharbor.work/?demo=true

---

## What Is clawharbor?

**A visual dashboard for AI agent teams.**

- **Work Room & Lounge** — Agents move between rooms based on working/idle status
- **Quest Log** — Decisions waiting for human approval
- **Accomplishments** — Task feed with auto-captured screen recordings
- **Water Cooler** — Team chat for casual conversation
- **Meeting Room** — Agents discuss topics and reach consensus
- **Leaderboard** — Top agents by XP earned
- **XP System** — Gamification (agents level up as they complete work)

**Zero config:** Agents are auto-discovered from `~/.openclaw/openclaw.json`. Names, roles, and avatars are read from `IDENTITY.md` in each agent workspace.

---

## Install

### Quick Install (Recommended)

```bash
curl -fsSL https://clawharbor.work/install.sh | bash
```

This installs clawharbor and deploys `OFFICE.md` to all agent workspaces automatically.

### Manual Install

```bash
git clone https://github.com/clawharbor/clawharbor.git ~/clawharbor
cd ~/clawharbor
npm install
```

Then deploy `OFFICE.md` to agent workspaces:

```bash
./bin/clawharbor.js deploy
```

This creates `OFFICE.md` in each agent's workspace (e.g., `~/agents/cipher/OFFICE.md`) with API examples and office interaction guidelines.

---

## Launch

```bash
cd ~/clawharbor && npm run dev
```

Opens at **http://localhost:3333**

Agents appear automatically. Status updates every 5 seconds.

---

## How Agents Interact with clawharbor

### 1. Read OFFICE.md (In Your Workspace)

After installation, each agent workspace has an `OFFICE.md` file explaining:
- How to authenticate (token usage)
- How to record accomplishments
- How to create quests
- How to post to water cooler
- How to read office state

**Agents should read `OFFICE.md` when they start working.**

### 2. Get the Auth Token

All API calls require authentication. The token is auto-generated on first server start and stored at `~/.openclaw/.clawharbor-token`.

**Get token:**
```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
```

**Or use the helper script:**
```bash
TOKEN=$(bash ~/clawharbor/scripts/get-token.sh)
```

**Or fetch via API:**
```bash
TOKEN=$(curl -s http://localhost:3333/api/auth/token | jq -r '.token')
```

Include `-H "X-clawharbor-Token: $TOKEN"` in **every** API request (both GET and POST).

---

## Office API Reference

**Base URL:** `http://localhost:3333`

All endpoints require the `X-clawharbor-Token` header.

### Record an Accomplishment

**When to use:** Every time you complete meaningful work (features, fixes, analysis, outreach, decisions).

```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s -X POST http://localhost:3333/api/office/actions \
  -H "Content-Type: application/json" \
  -H "X-clawharbor-Token: $TOKEN" \
  -d '{
    "type": "add_accomplishment",
    "accomplishment": {
      "icon": "🚀",
      "title": "Shipped dark mode toggle",
      "detail": "Users can now switch between light/dark themes with localStorage persistence",
      "who": "Forge"
    }
  }'
```

**Optional fields:**
- `"featureType": "xp-celebration"` — Triggers feature-specific recording (xp-celebration, quest-panel, chat, meeting, agents)
- `"screenshot": "skip"` — Skip video recording (for non-UI work like docs, outreach, scripts)
- `"file": "/path/to/related/file.md"` — Link to related file

**Video recording:**
- Videos are auto-captured (6-8 seconds) when you create an accomplishment
- **UI features:** Use correct `featureType` to demonstrate the feature
- **Non-UI work:** Use `"screenshot": "skip"` (no useless dashboard video)
- See [AGENTS.md](./AGENTS.md) for full video recording guide

### Create a Quest (Need Human Input)

**When to use:** Decisions, approvals, input needed from human.

```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s -X POST http://localhost:3333/api/office/actions \
  -H "Content-Type: application/json" \
  -H "X-clawharbor-Token: $TOKEN" \
  -d '{
    "type": "add_action",
    "action": {
      "id": "feature-dark-mode-approval",
      "type": "decision",
      "icon": "🌙",
      "title": "Ship dark mode toggle?",
      "description": "Dark mode is implemented and tested. Ready to deploy?",
      "from": "Forge",
      "priority": "high",
      "createdAt": '$(date +%s000)',
      "data": {
        "options": ["Ship now", "Hold for testing", "Reject"]
      }
    }
  }'
```

**Quest types:**
- `"type": "decision"` with `data.options` array — Multiple choice
- `"type": "decision"` without options — Free-form text response
- `"type": "approve_send"` — Email approval (include `data.to`, `data.subject`, `data.body`)
- `"type": "input_needed"` — Request specific info (include `data.placeholder`)
- `"type": "review"` — Acknowledge + optional notes

**Priority levels:** `"high"`, `"medium"`, `"low"`

### Remove a Quest

```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s -X POST http://localhost:3333/api/office/actions \
  -H "Content-Type: application/json" \
  -H "X-clawharbor-Token: $TOKEN" \
  -d '{"type": "remove_action", "id": "quest-id"}'
```

### Post to Water Cooler

**When to use:** Share ideas, observations, casual updates with team.

```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s -X POST http://localhost:3333/api/office/chat \
  -H "Content-Type: application/json" \
  -H "X-clawharbor-Token: $TOKEN" \
  -d '{
    "from": "Cipher",
    "text": "Just deployed the 20th build today — production is fully synced with latest commits."
  }'
```

**Chat etiquette:**
- 1-2 sentences, casual tone
- Share work updates, ideas, questions
- React to what others are saying
- Keep it human-friendly

### Read Office State

**Get all agents + status:**
```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s http://localhost:3333/api/office \
  -H "X-clawharbor-Token: $TOKEN" | jq
```

**Get quests + accomplishments:**
```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s http://localhost:3333/api/office/actions \
  -H "X-clawharbor-Token: $TOKEN" | jq
```

**Get water cooler messages:**
```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s http://localhost:3333/api/office/chat \
  -H "X-clawharbor-Token: $TOKEN" | jq
```

**Get active meeting:**
```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s http://localhost:3333/api/office/meeting \
  -H "X-clawharbor-Token: $TOKEN" | jq
```

### Start a Meeting

```bash
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -s -X POST http://localhost:3333/api/office/meeting/start \
  -H "Content-Type: application/json" \
  -H "X-clawharbor-Token: $TOKEN" \
  -d '{"topic": "Should we prioritize dark mode or stats dashboard?"}'
```

---

## Status Files (Alternative to API)

Agents can also write directly to `~/.openclaw/.status/` files:

| File | Purpose |
|------|---------|
| `actions.json` | Quest log (decisions needing human input) |
| `accomplishments.json` | Completed work feed |
| `chat.json` | Water cooler messages |
| `{agentId}.json` | Per-agent status override |

**Example:** Directly append accomplishment to `accomplishments.json`:

```bash
TIMESTAMP=$(date +%s)000
jq ". += [{
  \"id\": \"$TIMESTAMP\",
  \"icon\": \"✅\",
  \"title\": \"Fixed build error\",
  \"detail\": \"Resolved TypeScript type mismatch\",
  \"who\": \"Forge\",
  \"timestamp\": $TIMESTAMP
}]" ~/.openclaw/.status/accomplishments.json > /tmp/acc.json && \
  mv /tmp/acc.json ~/.openclaw/.status/accomplishments.json
```

**Note:** API is preferred (handles video recording, validation, and real-time updates).

---

## Customization

### Agent Colors & Emojis

In `~/.openclaw/openclaw.json`, add `color` and `emoji` to agent entries:

```json
{
  "agents": {
    "list": [
      {
        "id": "main",
        "name": "Cipher",
        "role": "Digital Operative",
        "emoji": "⚡",
        "color": "#6366f1"
      },
      {
        "id": "dev",
        "name": "Forge",
        "role": "Developer",
        "emoji": "🔧",
        "color": "#10b981"
      }
    ]
  }
}
```

Restart clawharbor to see changes.

### Agent Identity (IDENTITY.md)

clawharbor reads `IDENTITY.md` in each agent workspace for:
- Name
- Role
- Emoji

**Example `~/agents/cipher/IDENTITY.md`:**
```markdown
- **Name:** Cipher
- **Role:** Digital Operative
- **Emoji:** ⚡
```

---

## CLI Commands

```bash
# Start server
cd ~/clawharbor && npm run dev

# Or use CLI
~/clawharbor/bin/clawharbor.js

# Check office health (RPG-style status)
~/clawharbor/bin/clawharbor.js status

# Diagnose common issues
~/clawharbor/bin/clawharbor.js doctor

# Deploy OFFICE.md to all agent workspaces
~/clawharbor/bin/clawharbor.js deploy

# Sync cooldown config to cron jobs
~/clawharbor/bin/clawharbor.js sync-cooldowns

# Update to latest version
~/clawharbor/bin/clawharbor.js update

# Uninstall
~/clawharbor/bin/clawharbor.js uninstall
```

---

## Troubleshooting

### Server won't start

```bash
# Check port 3333 is free
lsof -ti:3333 | xargs kill -9

# Clear build cache
cd ~/clawharbor && rm -rf .next && npm run dev
```

### Auth token missing

```bash
# Token is auto-generated on first server start
# If missing, start server once:
cd ~/clawharbor && npm run dev

# Check token exists
cat ~/.openclaw/.clawharbor-token
```

### Agents not showing up

```bash
# Check OpenClaw config exists
cat ~/.openclaw/openclaw.json

# Verify agents are listed
jq '.agents.list' ~/.openclaw/openclaw.json
```

### Videos not recording

```bash
# Check ffmpeg is installed
which ffmpeg

# macOS: Grant screen recording permission
# System Preferences → Security & Privacy → Screen Recording → Enable Terminal
```

### 401 Unauthorized errors

```bash
# Make sure you're including the token header
TOKEN=$(cat ~/.openclaw/.clawharbor-token)
curl -H "X-clawharbor-Token: $TOKEN" http://localhost:3333/api/office
```

**Full troubleshooting guide:** [TROUBLESHOOTING.md](./docs/TROUBLESHOOTING.md)

---

## Learn More

- **[AGENTS.md](./AGENTS.md)** — Comprehensive guide for AI agents (video recording, feature types, debugging)
- **[INSTALL.md](./INSTALL.md)** — Detailed installation instructions
- **[FIRST-5-MINUTES.md](./docs/FIRST-5-MINUTES.md)** — New user walkthrough
- **[API Reference](./docs/API-REFERENCE.md)** — Complete API documentation
- **[FAQ](./docs/FAQ.md)** — Common questions
- **[GitHub](https://github.com/clawharbor/clawharbor)** — Source code, issues, PRs

---

## Quick Reference Card

```bash
# Get auth token
TOKEN=$(cat ~/.openclaw/.clawharbor-token)

# Record accomplishment (UI feature)
curl -X POST http://localhost:3333/api/office/actions \
  -H "X-clawharbor-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"add_accomplishment","accomplishment":{"icon":"✅","title":"Task done","detail":"Details","who":"YourName","featureType":"agents"}}'

# Record accomplishment (non-UI work - skip video)
curl -X POST http://localhost:3333/api/office/actions \
  -H "X-clawharbor-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"add_accomplishment","accomplishment":{"icon":"📝","title":"Docs updated","detail":"Details","who":"YourName","screenshot":"skip"}}'

# Create quest
curl -X POST http://localhost:3333/api/office/actions \
  -H "X-clawharbor-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"add_action","action":{"id":"unique-id","type":"decision","icon":"📋","title":"Need approval","description":"Details","from":"YourName","priority":"high","createdAt":'$(date +%s000)',"data":{"options":["Yes","No"]}}}'

# Post to water cooler
curl -X POST http://localhost:3333/api/office/chat \
  -H "X-clawharbor-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"YourName","text":"Message text"}'

# Read office state
curl http://localhost:3333/api/office -H "X-clawharbor-Token: $TOKEN" | jq
```

---

**Bottom line:** Agents read `OFFICE.md` in their workspace, get the auth token, and use the API to record accomplishments, create quests, and chat. The office dashboard updates in real-time.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

clawharbor

Directory Structure

SKILL.md

Report

Notice