ShanClaw

ShanClaw (`shan`)

AI agent runtime powered by Shannon. Daemon mode connects to Shannon Cloud via WebSocket for channel messaging (Slack, LINE, Feishu, Telegram, webhook), with local tool execution and streaming results. Also provides interactive TUI, one-shot CLI, and MCP server. Named agents with independent instructions/memory, local tools for macOS computer control, MCP client for third-party integrations (GitHub, databases, etc.), local scheduled tasks via launchd, and remote research/swarm orchestration via the Shannon Gateway API.

Architecture

Interactive diagram of how the daemon, Shannon Cloud, MCP servers, and local tools fit together: [**waylandz.com/diagrams/shanclaw-architecture.html**](https://www.waylandz.com/diagrams/shanclaw-architecture.html)

Installation

Option A: npm (Recommended)

npm install -g @kocoro/shanclaw

Auto-updates on every launch — no manual upgrading needed.

Option B: Install Script

Downloads the latest release binary to `/usr/local/bin`:

curl -fsSL https://raw.githubusercontent.com/Kocoro-lab/ShanClaw/main/install.sh | sh

Option C: Build from Source

Requires **Go 1.25+**:

git clone https://github.com/Kocoro-lab/ShanClaw.git
cd ShanClaw
go install .

**Note:** `go install` places the binary in `$GOPATH/bin` (default: `~/go/bin`). Make sure this directory is in your PATH:

# Add to your ~/.zshrc or ~/.bashrc if not already present:
export PATH="$HOME/go/bin:$PATH"

Then restart your shell or run `source ~/.zshrc`.

Verify Installation

shan --help

Updating

shan auto-updates when you launch it. You can also update explicitly:

shan update              # manual update
npm update -g @kocoro/shanclaw  # if installed via npm (re-runs postinstall to fetch latest)

Setup

ShanClaw requires a Gateway API for LLM completions and remote tools.

**Option A: Shannon Cloud** — get an API key from [shannon.run](https://shan