---
title: "Cowork Chat Module"
module_id: "workspaceChat"
version: "1.1.0"
category: "communication"
autonomy: "view-required"
generated: true
generated_at: "2026-05-04"
---

# Cowork Chat

> Internal authenticated chat that blends your workspace data with the model\

Ships with an **admin UI**.

## Quick Facts

| Property | Value |
|----------|-------|
| **Module ID** | `workspaceChat` |
| **Version** | 1.1.0 |
| **Category** | communication |
| **Autonomy** | view-required |
| **Core** | No |
| **Capabilities** | `data:read` |
| **MCP-exposed skills** | — |
| **Owns tables** | — |

## Integrations

**Optional:** `openai`, `gemini`, `local_llm`, `firecrawl`

## Module API Contract

**Actions:** `get_config`

**Input fields:** `action`

**Output fields:** `success`, `error`

## File Map

| Purpose | Path |
|---------|------|
| Module definition | `src/lib/modules/workspace-chat-module.ts` |
| Hook | `src/hooks/useWorkspaceChat.ts` |
| Admin page | `src/pages/admin/WorkspaceChatPage.tsx` |

## Contributing

To enhance this module, see [Contributing Guide](../contributing/contributing.md).

Key rules:
- Follow `ModuleDefinition<I, O>` contract pattern
- All schema changes require idempotent migrations
- Skills must be self-describing ([Law 2](../concepts/openclaw-law.md))
- Blocks are interfaces, not pipelines ([Law 3](../concepts/openclaw-law.md))
- New skills must pass the [Agent Contract Integrity](../architecture/agent-contract-integrity.md) checklist (`bun run lint:skills`)

---

*This file is auto-generated by `scripts/generate-module-docs.ts`. Do not edit manually — re-run the script after changing the module definition.*