open-claude-cowork README

The project's README from github.com/composio-community/open-claude-cowork. As one markdown file: README.md.

Open Claude Cowork

Secure Clawdbot Demo

Composio Claude Agent SDK Claude Code Twitter

An open-source desktop chat application powered by Claude Agent SDK and Composio Tool Router. Automate your work end-to-end across desktop and all your work apps in one place.

Get your free API key to get started →

Pst. hey, you, join our stargazers :)
GitHub stars

What's Inside

This repo includes two powerful AI tools:

Open Claude Cowork 🦑 Secure Clawdbot
What Full-featured desktop chat interface Personal AI assistant on messaging
Where macOS, Windows, Linux WhatsApp, Telegram, Signal, iMessage
Best for Work automation, multi-chat sessions On-the-go AI access, reminders, memory

Both include 500+ app integrations via Composio (Gmail, Slack, GitHub, Google Drive, and more).

Quick Start

Open Claude Cowork

git clone https://github.com/ComposioHQ/open-claude-cowork.git
cd open-claude-cowork
./setup.sh

Then run in two terminals:

# Terminal 1
cd server && npm start

# Terminal 2
npm start

🦑 Secure Clawdbot

cd clawd
npm install
node cli.js

Select "Terminal chat" to test, or "Start gateway" to connect WhatsApp/Telegram/Signal/iMessage.

See Secure Clawdbot Documentation for full setup.

Features

Open Claude Cowork

🦑 Secure Clawdbot

Tech Stack

Component Technology
Desktop Electron.js
Backend Node.js + Express
AI Claude Agent SDK + Opencode SDK
Tools Composio Tool Router + MCP
Streaming Server-Sent Events (SSE)

Configuration

API Keys

You need:

cp .env.example .env
# Edit .env with your keys

Skills

Extend Claude with custom skills by adding SKILL.md files to .claude/skills/:

---
description: Use this skill when the user asks about [topic]
---

# My Skill

Instructions for Claude...

See Agent Skills documentation for details.

Project Structure

open-claude-cowork/
├── main.js              # Electron main process
├── renderer/            # Frontend UI
├── server/              # Backend + providers
│   ├── providers/       # Claude & Opencode implementations
│   └── server.js        # Express server
├── clawd/               # Secure Clawdbot (messaging bot)
│   ├── cli.js           # Entry point
│   ├── adapters/        # WhatsApp, Telegram, Signal, iMessage
│   └── README.md        # Full documentation
└── .claude/skills/      # Custom agent skills

Troubleshooting

Issue Solution
Can't connect to backend Ensure server is running on port 3001
API key error Check .env - Anthropic keys start with sk-ant-
Session not persisting Check server logs for session ID
Streaming slow Check firewall/network for SSE connections

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Resources

Community

Join 200,000+ developers building agents in production

Get Started For Free

Built with Claude Code and Composio

open-claude-cowork (composio-community/open-claude-cowork)

Searching Database…

4.3K ·GitHub
Open-claude-cowork
What is this?Open Claude Cowork is an open-source desktop chat app powered by the Claude Agent SDK and Composio Tool Router that automates work across desktop and your work apps, with 500+ SaaS integrations like Gmail, Slack, and GitHub.
Is this one app or two separate tools?The repo actually contains two tools: Open Claude Cowork, a full desktop chat interface, and Secure Clawdbot, a personal AI assistant that runs on messaging platforms instead of the desktop.
How do I get it running?Clone the repo and run it in two terminals (backend and Electron frontend) for Open Claude Cowork; for Secure Clawdbot, choose 'Terminal chat' to test or 'Start gateway' to connect messaging apps.
Do I need an Anthropic API key before I start?Yes, you need an Anthropic API key from console.anthropic.com, a Composio API key from app.composio.dev, and optionally an Opencode API key if you want to use Opencode as the model provider.
What should I check if the app won't connect?The troubleshooting table flags that the backend server must be running on port 3001, API keys must start with sk-ant-, and slow streaming is usually a firewall/network issue blocking SSE connections.
Which messaging platforms does Secure Clawdbot support?Secure Clawdbot connects to WhatsApp, Telegram, Signal, and iMessage, giving on-the-go AI access, reminders, and persistent memory outside the desktop app.
What platforms does the desktop app run on?Open Claude Cowork runs on macOS, Windows, and Linux as an Electron desktop app.
Can I switch between different AI model providers?Yes, Open Claude Cowork supports both Claude Agent SDK and Opencode SDK as interchangeable model providers.
Can I extend Claude with custom capabilities?Yes, you can add SKILL.md files to the .claude/skills/ directory to extend Claude with custom skills.
What's the tech stack behind the desktop app?It uses Electron.js for the desktop shell, Node.js plus Express for the backend, the Claude Agent SDK and Opencode SDK for AI, Composio Tool Router plus MCP for tools, and Server-Sent Events for streaming responses.
Can Secure Clawdbot remember things about me over time?Yes, it has persistent memory that remembers facts, preferences, and daily notes across conversations, plus natural language scheduling for reminders and cron jobs.
What are similar projects?nocobase, evenfire, brigade, mindshub, rowboat, hermes-agent, nanoclaw, clawd-on-desk
Which topics is it in?aiagents, anthropic-claude, claude-cowork, whatsapp, slack, chat, telegram, opencode, workflow-automation, electron, anthropic, productivity
Creator
composio-community
Size
41.8 MB
Stars
4.3K
Updated
CommitMay 03
Age
9mo
Commits · 90 Days