open/claude-code-complete-agent
1
0
Fork 0
Code Activity Actions
claude-code-complete-agent/README.md
Kjell Tore Guttormsen 06ae605051 fix: pedagogical review - add expected output, CLAUDE.md, fix consistency 
Address findings from pedagogical review simulating a non-expert user:

- Add CLAUDE.md to project root (was referenced but missing)
- Fix README score from 12/9/1 to 13/8/1 (match feature-map.md)
- Add Expected Output sections to examples 01, 02, 05, 09, 10
- Create pipeline-output/ and briefings/ directories
- Add example ordering guidance in README
- Add plan requirements for examples 11/13 in prerequisites
- Add skill frontmatter explanation in GETTING-STARTED.md
- Explain Cowork/Dispatch with links in cowork-integration
- Expand .gitignore with node_modules and generated output files
- Add model override hints in agent frontmatter comments

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 20:25:45 +01:00

175 lines
6.7 KiB
Markdown
Raw Blame History

# Claude Code Complete Agent
A working setup that demonstrates every major OpenClaw capability
using Claude Code's ecosystem: tools, MCP servers, plugins, hooks,
agents, skills, triggers, Computer Use, and Remote Control.
Companion repo for the article
[Every OpenClaw Feature, Covered by Claude Code](https://fromaitochitta.com/openclaw-vs-claude-code-every-feature-compared).
## Why this exists
OpenClaw has 247K GitHub stars and 22 major capabilities. It is the
fastest-growing open-source project in history. This repo shows that
Claude Code's ecosystem (Code + Cowork + Dispatch) covers 21 of
those 22, with 13 full matches and 8 different approaches. One gap
remains: Canvas/A2UI.
This is not a theoretical comparison. Clone this repo, open Claude
Code, and try each example yourself.
## Prerequisites
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) v2.1.86+
- Node.js 18+ (only needed for Playwright MCP)
- A terminal (macOS or Linux)
- For Computer Use (example 11): Claude Code Desktop app + macOS + Pro or Max plan
- For Auto Mode (example 13): Team plan or higher (research preview)
- For Dispatch: Claude mobile app (iOS/Android)
No npm install. No Docker. No build step.
## Two paths
**"Show me what it can do"** - Browse `examples/`, read `feature-map.md`,
try the demo prompts. You will understand what Claude Code is capable of.
**"Help me actually use it"** - Read **[GETTING-STARTED.md](GETTING-STARTED.md)**.
Six concrete steps that take you from demo to personal daily driver:
personalize CLAUDE.md, set up phone access, write your own skills,
and build the setup into how you actually work. About one hour total.
## Quickstart (demo mode)
```bash
git clone https://git.fromaitochitta.com/ktg/claude-code-complete-agent.git
cd claude-code-complete-agent
claude
```
Then try:
```
Paste the prompt from examples/01-agent-runtime/prompt.md
```
If you see Claude start searching the web and writing a file, it works.
Each example includes an "Expected Output" section so you know what to look for.
## What is in this repo
### Working configuration
| Path | What it does |
|------|-------------|
| `CLAUDE.md` | Project memory and instructions |
| `.claude/settings.json` | Permissions, deny lists, hook config |
| `.claude/agents/` | Three agents: researcher, writer, reviewer |
| `.claude/skills/` | Three skills: daily-briefing, slack-message, web-research |
| `.mcp.json` | Playwright MCP (disabled by default) |
| `hooks/` | Security hooks (pre-tool-use blocker, post-tool-use logger) |
### Documentation
| Path | What it covers |
|------|---------------|
| `security/` | Permission modes, Auto Mode, hook patterns, NemoClaw comparison |
| `memory/` | How Claude Code memory works vs OpenClaw's vector search |
| `automation/` | Cron, launchd, /loop, /schedule |
| `messaging/` | Channels (iMessage, Telegram, Discord), Slack MCP, Dispatch/RC comparison |
| `browser/` | Playwright MCP setup and usage |
| `cowork-integration/` | How Code + Cowork + Dispatch together replicate OpenClaw |
### Examples (try these)
| # | Example | Capability | OpenClaw equivalent |
|---|---------|-----------|-------------------|
| 01 | Agent Runtime | Tool execution loop | Long-running daemon |
| 02 | Shell and Files | Bash + file I/O | exec tool + read/write |
| 03 | Web Search | WebSearch + WebFetch | Brave Search + Firecrawl |
| 04 | Browser Automation | Playwright MCP | CDP/Playwright built-in |
| 05 | Memory System | CLAUDE.md + auto-memory | Daily logs + vector search |
| 06 | Multi-Agent | Agent Teams + SendMessage | Sub-agents + mesh |
| 07 | Messaging | MCP + Telegram Channels | 15+ native channels |
| 08 | Cron/Automation | /loop, CronCreate, /schedule | HEARTBEAT.md + cron |
| 09 | Security Hooks | PreToolUse/PostToolUse | Exec approvals + Docker |
| 10 | Full Pipeline | All capabilities combined | Complete workflow |
| 11 | Computer Use | Control desktop apps | macOS/iOS/Android apps |
| 12 | Remote Access | Channels + Dispatch + /rc (3 ways) | Telegram/WhatsApp control |
| 13 | Auto Mode | AI safety classifier | Autonomous daemon mode |
Each example has a self-contained prompt you can paste directly
into Claude Code.
**Recommended path:** Examples 01-09 are independent and work in any order.
Example 10 combines all of them into a single pipeline. Examples 11-13 require
additional setup (Desktop app, specific subscription plans) and are documented
separately.
## The feature map
See [feature-map.md](feature-map.md) for the complete 22-row
comparison table with verdicts and version requirements.
**Summary:** 13 full match, 8 different approach, 1 gap.
## The broader ecosystem
Claude Code is one part of Anthropic's answer to OpenClaw:
| Product | What it does | Best for |
|---------|-------------|----------|
| **Claude Code** (CLI) | Terminal agent with hooks, plugins, MCP | Developers |
| **Claude Code Desktop** | Desktop app with Computer Use | GUI automation |
| **Cowork** | Non-technical agent with built-in connectors | Everyone |
| **Dispatch** | Mobile task assignment from phone | Remote control |
| **/schedule** | Remote triggers via claude.ai | Always-on tasks |
| **Agent SDK** | Programmatic control for CI/CD | Automation |
See [cowork-integration/README.md](cowork-integration/README.md)
for a detailed breakdown of how these combine to cover OpenClaw's
feature set.
## The biggest practical limitation
**Session persistence.** If the Claude Code session closes, all
remote access (Channels, Dispatch, Remote Control) stops. OpenClaw
runs as a daemon and stays alive indefinitely. Workarounds exist
(tmux, Mac Mini, VPS), but this is an architectural difference.
See `messaging/channels-setup.md` for always-on workarounds.
## The remaining gap
**Canvas/A2UI (the only gap):** OpenClaw's canvas is an interactive
HTML workspace. Claude Code can generate HTML and preview it via
Playwright or Computer Use, but there is no persistent interactive
surface. Artifacts in claude.ai are the closest equivalent but are
not available in Claude Code.
## Security
Four permission modes, from manual approval to full autonomy:
1. **Default:** Ask for every action (learning)
2. **Auto-edit:** Pre-approved patterns (known workflows)
3. **Auto Mode:** AI classifier reviews each action (autonomous)
4. **Bypass:** No checks (sandboxed environments only)
The repo includes working security hooks:
- `hooks/pre-tool-use.sh` blocks dangerous commands
- `hooks/post-tool-use.sh` logs all tool executions
- `.claude/settings.json` has a permission deny list
Read `security/` for the full picture, including an honest
comparison with NemoClaw's enterprise security.
## License
MIT. See [LICENSE](LICENSE).
## About
Built by [Kjell Tore Guttormsen](https://fromaitochitta.com) as
part of the From AI to Chitta project, exploring the intersection
of AI tools and inner development.
View git blame Copy permalink