- Common Lisp 96.4%
- Shell 1.6%
- JavaScript 1.2%
- HTML 0.8%
| .beads | ||
| .openclaw | ||
| ci-pending | ||
| docs | ||
| knowledge | ||
| logs | ||
| memory | ||
| projects | ||
| reports | ||
| .gitignore | ||
| .gitmessage | ||
| AGENTS.md | ||
| clambda | ||
| clawmacs | ||
| clawmacs.service | ||
| CONTRIBUTING.md | ||
| HEARTBEAT.md | ||
| IDENTITY.md | ||
| LICENSE | ||
| MEMORY.md | ||
| migration-report.md | ||
| missing-features.md | ||
| NEXT-STEPS.md | ||
| PARITY-STATUS.md | ||
| PROJECT-BIBLE.md | ||
| README.md | ||
| ROADMAP.md | ||
| SECURITY.md | ||
| SOUL.md | ||
| TEAM.md | ||
| TOOLS.md | ||
| USER.md | ||
Clawmacs
🚧 PROJECT ON HOLD: Clawmacs development is currently on hold until KVC conducts further Lisp development bootstrapping.
Common Lisp agent platform — OpenClaw rewrite in pure CL
⚠️ Work in progress. Core platform is running; docs are being actively refreshed as naming and packaging evolve.
Clawmacs is an experimental rewrite of the OpenClaw AI agent framework entirely in Common Lisp. The goal is a libre, self-hosting, hackable agent platform with no Node.js dependency in the core runtime.
Layer Architecture
| Layer | Package/System | Description |
|---|---|---|
| 1 | cl-llm |
LLM API client — OpenAI-compatible HTTP, SSE streaming, tool-call structs |
| 2a | cl-tui |
ANSI terminal chat interface |
| 2b | clawmacs-core |
Agent platform core — sessions, memory, tool dispatch, channels, HTTP API |
| 3 | clawmacs-gui |
McCLIM GUI frontend |
Repository Layout
projects/
cl-llm/ # Layer 1: LLM HTTP client
cl-tui/ # Layer 2a: terminal chat interface
clambda-core/ # Layer 2b+: core platform source tree
clambda-gui/ # Layer 3: GUI source tree
cl-term/ # terminal emulator component (separate system)
Notes:
- The core and GUI source directories are currently
clambda-core/andclambda-gui/. - ASDF system names remain
clawmacs-coreandclawmacs-guifor compatibility.
Status Snapshot
- ✅
cl-llmrunning (OpenAI-compat, streaming, tool schema support) - ✅
clawmacs-coreloads and runs (agent loop, tools, channels, API) - ✅
cl-tuiloads and runs - ✅
clawmacs-guiavailable as optional frontend - 🔧 Ongoing refinement for docs and feature parity details
Requirements
- SBCL (recommended)
- Quicklisp
- For GUI: McCLIM + CLX
- Optional browser tooling: Node.js + Playwright (used by browser integration)
- Optional OAuth CLI backend:
claudeCLI (Codex OAuth primary runtime does not requirecodexCLI)
Codex OAuth (browser-link + bridge runtime)
Clawmacs supports OpenClaw-style browser-link OAuth for Codex. Runtime uses a non-CLI Node helper bridge (@mariozechner/pi-ai openai-codex-responses) instead of direct OpenAI Chat Completions API-key billing/quota path; if unavailable, it temporarily falls back to Claude CLI with an explicit warning.
Use Telegram commands:
/codex_login/codex_link <redirect-url|code#state>/codex_status/models(list grouped model options + current active model)/models set <model-id>(validated + persisted)
Stored credentials path: ~/.clawmacs/auth/codex-oauth.json (permission 0600).
See Codex OAuth setup for full flow and troubleshooting.
License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See LICENSE for the full text.