clawbot

Installer for the cmdop CLI — an AI agent on your machine that you can talk to from anywhere.

pip install clawbot
clawbot

That's it. clawbot detects your platform, downloads the cmdop binary, verifies it against the published checksums, installs it, and hands over.

The gap in most bot frameworks is not the conversation, it is the body. You can wire a chat interface in an afternoon; giving it a real machine to act on is the part that turns into infrastructure.

cmdop ships that part as one binary. This package installs it, checksum-verified, and hands over.

How does CMDOP compare? CMDOP Skills vs OpenClaw: two approaches to AI agent skills →

A chat surface is only useful if something is listening

Once the binary is running, the machine is addressable — from a terminal, from another machine in the same fleet, or from the console the binary serves itself. There is no bot host to deploy and no webhook endpoint to expose.

You are not building a bot that calls out to a service. You are giving one machine a mouth.

What is cmdop

One executable that is the agent, the relay, the local server and the web console at once. There is no gateway, backend, database server or broker to stand up — you add one binary to a machine you already own.

• run an AI agent on your own machine, with your own tools
• reach it from anywhere: terminal, files, remote execution
• connect machines into a fleet
• works with Claude Code and other agent engines under the hood

Full documentation: docs.cmdop.com

Usage

clawbot                    # install cmdop (if needed), then run it
clawbot --install-only     # install, don't hand over
clawbot --prefix ~/bin     # choose the install directory
clawbot --force            # reinstall even if already present
clawbot --quiet            # print only the installed path
clawbot -- --help          # everything after `--` goes to cmdop

Default install directory is ~/.local/bin (%LOCALAPPDATA%\cmdop\bin on Windows). No sudo, no system directories.

What it does, precisely

1. Detects your OS and architecture.
2. Fetches SHA256SUMS from install.cmdop.com.
3. Downloads the matching binary to a temporary file.
4. Verifies the SHA-256 against the published checksum. On mismatch it aborts and installs nothing.
5. Moves the verified binary into the install directory and marks it executable.
6. Runs it.

Supported: macOS (Apple Silicon, Intel), Linux (x64, arm64), Windows (x64).

What it does not do

• No side effects at install time. pip install clawbot only unpacks files. Nothing is downloaded or executed until you run clawbot.
• No network access on import. import clawbot touches nothing.
• No telemetry. The package sends no analytics, ever.
• No dependencies. Standard library only, so there is nothing to conflict with what you already have installed.

Python API

The installer is importable if you would rather script it:

import clawbot

target = clawbot.detect()
print(target.label, target.asset)

result = clawbot.install()
print(result.path, result.sha256)

clawbot.install() raises clawbot.InstallError with a user-facing message on any failure, and clawbot.UnsupportedPlatform when there is no published binary for the current machine.

Links

• Website — https://cmdop.com
• Documentation — https://docs.cmdop.com
• Downloads — https://cmdop.com/download

License

MIT