OctClaw - Shell is all. Everything can be clawed.

Philosophy

"Shell is already there. On your Mac, Linux server, Raspberry Pi, Android phone, IoT device. No install, no package managers, no compatibility issues.

Shell is the universal runtime. OctClaw makes it a universal AI agent."

OctClaw is built on a simple premise: if it runs shell, it can run an AI agent. From your laptop to a Raspberry Pi, from Android Termux to embedded systems — OctClaw brings AI assistance to every environment.

Quick Start

Install with one command
Set API key (DeepSeek, OpenAI, or local models)
Start using in interactive or one-shot mode
Add skills to extend capabilities

# Set your API key
export DEEPSEEK_API_KEY="sk-xxx"

# Start interactive mode
oct

# Or use one-shot commands
oct "list files in current directory"
oct -s project "check system status"
            

Universal Compatibility

OctClaw runs on shell 3.2+, which means it works everywhere:

macOS

2007+ versions

Linux

Any distribution

Android

Termux, no root

Windows

WSL2, Git Bash

Raspberry Pi

IoT & embedded

Containers

Alpine, Docker

Messaging Integration

Connect OctClaw to your favorite platforms:

Telegram — Personal and group chats
飞书/钉钉 — Enterprise collaboration
Discord/Slack — Community and teams
微信 — Daily communication
Email — Automated processing

Connect once, access everywhere.

Skills System

Extend OctClaw's capabilities with skills:

File Operations — Read, write, edit files
Shell Execution — Run any command
System Monitoring — Check status, resources
IoT Control — GPIO, sensors, automation
Web & APIs — HTTP requests, integration

# Create a new skill
oct "create a skill to monitor website uptime"

# Use existing skills
oct "what skills are available?"
            

Minimal & Efficient

Single file — ~1200 lines of shell script
Zero dependencies — Just shell, jq, and curl
< 10MB RAM — Lightweight operation
< 50ms cold start — Instant response
Self-modifying — Can update itself
Session persistence — Remembers conversations