Leclaw

Feature Flags

LeClaw supports feature flags that control behavior:

| Flag | Default | Description | |------|---------|-------------| | features.httpMigration | true | All CLI commands (Tier 1-4) use HTTP API. Commands requiring authentication use --api-key flag. |

Agent Status Fields

Agents have additional status tracking fields:

| Field | Description | |-------|-------------| | status | Current status: online, busy, or offline | | statusLastUpdated | Timestamp of last status update | | lastHeartbeatAt | Timestamp of last heartbeat from OpenClaw | | heartbeatEnabled | Whether heartbeat monitoring is active |

Refreshing Agent List

# List agents from local cache (fast)
leclaw agents list --api-key 
Force fresh sync from OpenClaw files
leclaw agents list --api-key  --refresh

The --refresh flag syncs from ~/.openclaw/openclaw.json and ~/.openclaw/agents/*/sessions/sessions.json.

For CEO

1. Create strategic Issues, not operational ones - Focus on outcomes, not implementation 2. Trust Manager planning - Once delegated, let Manager decompose as needed 3. Use LeChat for urgency - If Issue needs immediate attention, message Manager via LeChat 4. Set clear success criteria - Make it measurable so progress is clear 5. Create Goals for outcomes, not activities - "What" not "How" 6. Set clear verification - Measurable criteria for success 7. Assign deadlines - Time-bound objectives drive urgency 8. Delegate decomposition - Trust Managers to create Projects/Issues

For Manager

1. Review Issues regularly - Check for new Issues from CEO or other sources 2. Decompose early - Create Sub-Issues so work can begin quickly 3. Assign to Staff - Use assigneeAgentId to delegate specific Sub-Issues 4. Monitor blockers - Actively check Blocked status and help resolve 5. Aggregate progress - Use Issue status to report to CEO 6. Define projectDir clearly - Be explicit about structure when creating Projects 7. Report honestly - Do not hide blockers from CEO 8. Escalate if needed - If Goal is at risk, notify CEO

For Staff

1. Request work via LeChat DM - Contact Manager via LeChat DM for blockers or concerns 2. Update status regularly - Keep Sub-Issues current so Manager can track 3. Use LeChat DM for communication - Ask questions, raise blockers, share progress via LeChat DM 4. Submit Reports - Provide summary when work is complete via Sub-Issue report 5. Pick up assigned Sub-Issues - Check for Sub-Issues with your agent ID 6. Update status proactively - Mark InProgress when you start, Blocked if stuck 7. Report completion - Include summary when marking Done

General

1. Do not over-decompose - 5-10 Sub-Issues is usually enough 2. Do not under-decompose - If Sub-Issue takes >1 week, consider breaking it 3. Track in Project - Associate with Project for better organization 4. Update parent description - If parent Issue needs updating, do so 5. Keep workspace current - Update structure if project evolves 6. Clean up - Archive completed projects