claw-code-cheap-deepseek

Fork of upstream Claw Code with DeepSeek (OpenAI-compatible) support (deepseek-chat, deepseek-reasoner) via DEEPSEEK_API_KEY.

• Upstream: https://github.com/instructkr/claw-code
• Telegram bot (Ductor): https://github.com/nordost8/ductor-claw-code
• Ecosystem map: ECOSYSTEM.md

If you don't need DeepSeek, prefer upstream.

Quick CLI example

export DEEPSEEK_API_KEY=sk-...   # see SETUP.md
cd /path/to/your/repo
claw --model deepseek-chat --permission-mode workspace-write prompt \
  "Create a small Python script using Pillow that draws the Ukrainian flag (blue over yellow), write ua_flag.png, run it, and confirm the file exists."

For Telegram, use nordost8/ductor-claw-code.

Document	Purpose
SETUP.md	Build, environment variables, smoke test
USAGE.md	Current CLI, sessions, parity (from upstream)
docs/UPSTREAM_SYNC.md	How to merge upstream
CHANGELOG_FORK.md	Sync log

Upstream changes (overview)

After the latest merge from upstream/main: the canonical implementation lives in rust/, health checks use claw doctor, and details are in rust/README.md, PARITY.md, ROADMAP.md; the container workflow is described in docs/container.md.

Quick start from source:

Warning

cargo install claw-code installs the wrong thing. The claw-code crate on crates.io is a deprecated stub that installs claw-code-deprecated.exe — not claw. Running it only prints "claw-code has been renamed to agent-code". Do not use cargo install claw-code. Either build from source (this repo) or install the upstream binary:

cargo install agent-code   # upstream binary — installs 'agent.exe' (Windows) / 'agent' (Unix), NOT 'agent-code'

This repo (ultraworkers/claw-code) is build-from-source only — follow the steps below.

# 1. Clone and build
git clone https://github.com/ultraworkers/claw-code
cd claw-code/rust
cargo build --workspace
./target/debug/claw --help

# 2. Set your API key
export ANTHROPIC_API_KEY="sk-ant-..."
# or DeepSeek:
export DEEPSEEK_API_KEY="sk-..."

# 3. Verify everything is wired correctly
./target/debug/claw doctor

# 4. Run a prompt
./target/debug/claw prompt "say hello"

Documentation

• USAGE.md — CLI commands, auth, sessions, config, parity harness
• rust/README.md — Rust workspace layout and CLI details
• ROADMAP.md — active roadmap

License

Same as upstream (see LICENSE in the tree).