openclawfice

Category: Tools & Productivity | Uploader: openclawfice | 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/openclawfice/openclawfice

Directory Structure

Current level: Root

📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.yml 2.4 KB
  - 📄 config.yml 458 B
  - 📄 feature_request.yml 1.8 KB
  - 📄 good-first-issue.yml 1.1 KB
  - 📄 question.yml 1.1 KB
- 📁 workflows/
  - 📄 codeql.yml 907 B
  - 📄 security-scan.yml 3.5 KB
- 📄 dependabot.yml 641 B
- 📄 RELEASE_TEMPLATE.md 5.9 KB
📁 app/
- 📁 affiliate/
  - 📁 dashboard/
    
    📄 page.tsx 11.5 KB
  - 📄 page.tsx 12.1 KB
- 📁 analytics/
  - 📄 page.tsx 15.1 KB
- 📁 api/
  - 📁 affiliate/
    
    📁 dashboard/
    
    📄 route.ts 1.9 KB
    
    📁 signup/
    
    📄 route.ts 2.2 KB
    
    📁 track/
    
    📄 route.ts 2.5 KB
  - 📁 analytics/
    
    📁 cohorts/
    
    📄 route.ts 4.7 KB
    
    📁 onboarding/
    
    📄 route.ts 4.4 KB
    
    📁 templates/
    
    📄 route.ts 3.6 KB
    
    📁 track/
    
    📄 route.ts 2.2 KB
    
    📄 route.ts 2.8 KB
  - 📁 auth/
    
    📁 token/
    
    📄 route.ts 858 B
  - 📁 demo/
    
    📁 actions/
    
    📄 route.ts 375 B
    
    📁 autowork/
    
    📄 route.ts 495 B
    
    📁 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
  - 📁 export/
    
    📁 workflow/
    
    📄 route.ts 2.3 KB
  - 📁 github/
    
    📁 stars/
    
    📄 route.ts 974 B
  - 📁 office/
    
    📁 actions/
    
    📄 route.ts 19.5 KB
    
    📁 autowork/
    
    📄 route.ts 2.7 KB
    
    📁 challenges/
    
    📄 route.ts 4.0 KB
    
    📁 chat/
    
    📄 route.ts 2.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.7 KB
    
    📄 route.ts 28.8 KB
  - 📁 og/
    
    📄 route.tsx 4.4 KB
  - 📁 templates/
    
    📁 create/
    
    📄 route.ts 4.3 KB
- 📁 blog/
  - 📁 five-agents-one-office/
    
    📄 layout.tsx 1000 B
    
    📄 page.tsx 9.4 KB
  - 📁 observation-driven-debugging/
    
    📄 layout.tsx 950 B
    
    📄 page.tsx 9.8 KB
  - 📄 layout.tsx 762 B
  - 📄 page.tsx 5.0 KB
- 📁 card/
  - 📁 [name]/
    
    📄 layout.tsx 1.4 KB
    
    📄 page.tsx 12.8 KB
  - 📄 page.tsx 3.7 KB
- 📁 changelog/
  - 📄 layout.tsx 745 B
  - 📄 page.tsx 11.0 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.5 KB
- 📁 landing/
  - 📄 page.tsx 23.8 KB
- 📁 leaderboard/
  - 📄 page.tsx 8.8 KB
- 📁 quest-templates/
  - 📄 data.ts 6.1 KB
- 📁 showcase/
  - 📄 page.tsx 10.0 KB
- 📁 stats/
  - 📄 page.tsx 16.8 KB
- 📄 error.tsx 5.5 KB
- 📄 icon.tsx 612 B
- 📄 layout.tsx 2.7 KB
- 📄 not-found.tsx 7.5 KB
- 📄 page.tsx 123.7 KB
- 📄 robots.ts 274 B
- 📄 sitemap.ts 1.5 KB
📁 bin/
- 📄 first-time-setup.sh 4.3 KB
- 📄 openclawfice.js 32.2 KB
- 📄 sync-cooldowns.ts 7.8 KB
📁 components/
- 📄 AccomplishmentDetailModal.tsx 5.6 KB
- 📄 AchievementToast.tsx 4.0 KB
- 📄 ActivityHeatmap.tsx 7.9 KB
- 📄 AgentCard.tsx 12.4 KB
- 📄 AgentPanel.tsx 27.0 KB
- 📄 AgentSearchFilter.tsx 8.3 KB
- 📄 AutoworkBanner.tsx 3.0 KB
- 📄 BootSequence.tsx 7.6 KB
- 📄 CallMeetingModal.tsx 6.7 KB
- 📄 Celebration.tsx 5.8 KB
- 📄 ChatBubble.tsx 1.8 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
- 📄 DemoInstallCTA.tsx 4.9 KB
- 📄 DemoTour.tsx 8.5 KB
- 📄 DiscoveryAnimation.tsx 6.5 KB
- 📄 index.ts 868 B
- 📄 MeetingRoom.tsx 10.4 KB
- 📄 NPC.tsx 21.6 KB
- 📄 NPCParticles.tsx 5.5 KB
- 📄 OfficeEvents.tsx 12.7 KB
- 📄 OfficeHeader.tsx 11.1 KB
- 📄 OnboardingModal.tsx 8.5 KB
- 📄 Room.tsx 4.4 KB
- 📄 SettingsPanel.tsx 9.6 KB
- 📄 ShareCard.tsx 17.3 KB
- 📄 ShareModal.tsx 6.7 KB
- 📄 ShareWorkflowModal.tsx 10.6 KB
- 📄 TemplateGallery.tsx 7.1 KB
- 📄 types.ts 1.4 KB
- 📄 utils.ts 5.0 KB
📁 docs/
- 📁 blog/
  - 📄 building-virtual-office-for-ai-agents.md 5.3 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
- 📁 security/
  - 📄 SECURITY.md 6.4 KB
- 📁 support/
  - 📄 FAQ.md 10.1 KB
- 📄 COMPARISON.md 9.0 KB
- 📄 HIDDEN-FEATURES.md 8.1 KB
- 📄 README.md 968 B
- 📄 USE-CASES.md 9.5 KB
- 📄 WHY-OPENCLAWFICE.md 3.4 KB
- 📄 YOUR-FIRST-CONTRIBUTION.md 9.9 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.4 KB
- 📄 useReferralTracking.ts 2.7 KB
- 📄 useRetroSFX.ts 6.6 KB
- 📄 useUTMTracking.ts 935 B
📁 lib/
- 📄 affiliates.ts 3.5 KB
- 📄 auth-client.ts 1.1 KB
- 📄 auth.ts 3.4 KB
- 📄 autowork-ticker.ts 15.7 KB
- 📄 challenges.ts 3.5 KB
- 📄 file-finder.ts 4.7 KB
- 📄 gateway-rpc.ts 1.1 KB
- 📄 input-validation.ts 3.6 KB
- 📄 templateSanitizer.ts 3.9 KB
- 📄 track.ts 3.3 KB
- 📄 watercooler-ticker.ts 24.9 KB
📁 pages/
- 📄 _error.tsx 924 B
📁 public/
- 📄 deployment-flow-diagram.html 11.1 KB
- 📄 icon.svg 1.2 KB
- 📄 install.sh 11.6 KB
- 📄 landing.html 11.0 KB
- 📄 launch-dashboard.html 12.3 KB
- 📄 manifest.json 351 B
- 📄 og-image.png 388.9 KB
- 📄 openclawfice-demo.gif 1.1 MB
- 📄 screenshot-demo.png 602.3 KB
- 📄 screenshot.png 604.3 KB
- 📄 security-dashboard.html 13.1 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 717 B
- 📄 lint-style.sh 1.3 KB
- 📄 postinstall.js 1.3 KB
- 📄 pre-recording-check.sh 4.3 KB
- 📄 publish-to-clawhub.sh 924 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.5 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
- 📄 test-fresh-install.sh 4.1 KB
- 📄 validate-fresh-install.sh 6.6 KB
📁 skill/
- 📄 install.sh 3.3 KB
- 📄 SKILL.md 2.1 KB
📁 templates/
- 📄 OFFICE.md 4.5 KB
📁 tests/
- 📄 api.test.ts 11.1 KB
📄 .gitignore 717 B
📄 .npmignore 230 B
📄 AGENT-SEARCH-SPEC.md 4.2 KB
📄 analytics.json 1.5 KB
📄 CHANGELOG.md 3.8 KB
📄 CLA.md 2.8 KB
📄 CONTRIBUTING.md 8.7 KB
📄 DESIGN-CONSTRAINTS.md 11.2 KB
📄 FAQ.md 12.2 KB
📄 FIRST-5-MINUTES.md 7.4 KB
📄 FORGE-DAY-COMPLETE-FEB27.md 4.5 KB
📄 FORGE-STATUS-2026-02-27-2115.md 3.8 KB
📄 FORGE-VALIDATION-COMPLETE.md 7.9 KB
📄 HOW-IT-WORKS.md 9.9 KB
📄 INSTALL-READINESS-CHECK.md 3.0 KB
📄 INSTALL.md 9.4 KB
📄 instrumentation.ts 303 B
📄 LICENSE 33.9 KB
📄 middleware.ts 630 B
📄 MONDAY-MORNING-BRIEF.md 7.3 KB
📄 NEXT-IMPROVEMENTS.md 5.4 KB
📄 next.config.ts 130 B
📄 openclawfice.config.example.json 729 B
📄 P0-COMPLETE-2026-02-27.md 9.7 KB
📄 P0-COMPLETION-SUMMARY.md 6.4 KB
📄 package-lock.json 130.7 KB
📄 package.json 1.5 KB
📄 PHASE-2-USER-FEEDBACK-PROTOCOL.md 10.0 KB
📄 QUICK-START.md 8.3 KB
📄 QUICKSTART.md 3.8 KB
📄 README.md 6.8 KB
📄 SCOUT-TEST-PREP.md 4.1 KB
📄 SECURITY.md 6.2 KB
📄 SKILL.md 12.4 KB
📄 TASK-SOUND-FALLBACK.md 5.8 KB
📄 TECHNICAL-ROADMAP.md 9.6 KB
📄 TROUBLESHOOTING.md 8.6 KB
📄 tsconfig.json 598 B
📄 TYLER-NEXT-STEPS.md 3.3 KB
📄 VALIDATION-GATE.md 9.2 KB
📄 vercel.json 28 B
📄 VIDEO-WALKTHROUGH-GUIDE.md 10.8 KB
📄 vitest.config.ts 266 B
📄 WHATS-NEW-FEB-27.md 7.4 KB
📄 YOUTUBE-DEMO-SCRIPT.md 8.6 KB
📄 YOUTUBE-SHOT-LIST.md 10.6 KB

SKILL.md

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

# OpenClawfice 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://openclawfice.com/?demo=true

---

## What Is OpenClawfice?

**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://openclawfice.com/install.sh | bash
```

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

### Manual Install

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

Then deploy `OFFICE.md` to agent workspaces:

```bash
./bin/openclawfice.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 ~/openclawfice && npm run dev
```

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

Agents appear automatically. Status updates every 5 seconds.

---

## How Agents Interact with OpenClawfice

### 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/.openclawfice-token`.

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

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

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

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

---

## Office API Reference

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

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

### Record an Accomplishment

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

```bash
TOKEN=$(cat ~/.openclaw/.openclawfice-token)
curl -s -X POST http://localhost:3333/api/office/actions \
  -H "Content-Type: application/json" \
  -H "X-OpenClawfice-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/.openclawfice-token)
curl -s -X POST http://localhost:3333/api/office/actions \
  -H "Content-Type: application/json" \
  -H "X-OpenClawfice-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/.openclawfice-token)
curl -s -X POST http://localhost:3333/api/office/actions \
  -H "Content-Type: application/json" \
  -H "X-OpenClawfice-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/.openclawfice-token)
curl -s -X POST http://localhost:3333/api/office/chat \
  -H "Content-Type: application/json" \
  -H "X-OpenClawfice-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/.openclawfice-token)
curl -s http://localhost:3333/api/office \
  -H "X-OpenClawfice-Token: $TOKEN" | jq
```

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

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

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

### Start a Meeting

```bash
TOKEN=$(cat ~/.openclaw/.openclawfice-token)
curl -s -X POST http://localhost:3333/api/office/meeting/start \
  -H "Content-Type: application/json" \
  -H "X-OpenClawfice-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 OpenClawfice to see changes.

### Agent Identity (IDENTITY.md)

OpenClawfice 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 ~/openclawfice && npm run dev

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

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

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

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

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

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

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

---

## Troubleshooting

### Server won't start

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

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

### Auth token missing

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

# Check token exists
cat ~/.openclaw/.openclawfice-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/.openclawfice-token)
curl -H "X-OpenClawfice-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/openclawfice/openclawfice)** — Source code, issues, PRs

---

## Quick Reference Card

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

# Record accomplishment (UI feature)
curl -X POST http://localhost:3333/api/office/actions \
  -H "X-OpenClawfice-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-OpenClawfice-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-OpenClawfice-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-OpenClawfice-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"YourName","text":"Message text"}'

# Read office state
curl http://localhost:3333/api/office -H "X-OpenClawfice-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!

openclawfice

Directory Structure

SKILL.md

Report

Notice