VersperClaw: Not Only AI Assistant Code Agent

Quick Start

# script install
curl -fsSL https://raw.githubusercontent.com/versperai/VersperClaw/main/install.sh | bash

# source install
git clone https://github.com/versperai/VersperClaw.git && cd VersperClaw && bun install && bun run build:dev:full && ./VersperClaw

# make symbol link for everywhere can use VersperClaw just with a  
ln -sf "$(pwd)/VersperClaw" "$HOME/.local/bin/VersperClaw"

# overwrite
cp VersperClaw ~/.local/bin/VersperClaw

# make sure `~/.local/bin` in PATH 
# check if have in path
echo $PATH | grep -q "$HOME/.local/bin" && echo "In PATH" || echo "Out PATH"

# if not in PATH ，need add to your shell configuration

# for bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# for zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

WebSearch & WebFetch Tools - 100% local free no remote api fee

# local config search engine - searxng in archlinux
# make sure have install docker and docker-compose
sudo pacman -S docker-compose && docker
docker --version && docker compose version
sudo usermod -aG docker $USER

# make sure open pc and now start docker daemon
sudo systemctl enable --now docker

# install searxng in docker-compose
curl -fsSL \
  -O https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
  -O https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example

# add json source in formats behind html - jsonl in 87 lines
cd searxng/core-config/ && sudo nvim settings.yml

# start searxng engine
docker compose up -d

# check in every browser
firefox http://localhost:8080

Telegram - Interactive Config

# On startup, the CLI runs silently in the background, maintains a persistent Telegram connection, and listens for messages.
# start VersperClaw Cli
./cli-dev

# enter it into the cli input field and interactive configuration parameters
/telegram

Dream

nvim ~/.claude/settings.json

"autoMemoryEnabled": true,
"autoDreamEnabled": true
}

Auto Compact

echo 'export CLAUDE_CODE_AUTO_COMPACT_WINDOW=57344' >> ~/.bashrc
echo 'export CLAUDE_CODE_MAX_CONTEXT_TOKENS=61440' >> ~/.bashrc

Legacy Python Version

Demos dev/python

1. Auto Scientific Research & evolve code experiment and write AI ccf/sci draft paper also support checkpoint

2. WebToolAgent

Web Search	Deep Search	Live Chrome Control

3. Gateway - WeXin, Telegram and so on

# telegram, wechat and whatsapp
versper setup gateway

# then start listen
versper gateway

# Source install
git clone -b dev/python https://github.com/versperai/VersperClaw.git

# If you want check out the have been legacyed python version code, just switch to the dev/python branch

# make sure you have installed uv and creat .venv via uv venv
uv pip install -r requirements.txt # or uv sync
source .venv/bin/activate
uv pip install -e .

# use codex, openrouter, or claude remote model via api
versper setup

# if use vllm or llama.cpp in local model for inference 
# for example use llama.cpp
llama-server \
  --model unsloth/Qwen3.5-4B-GGUF/Qwen3.5-4B-UD-Q4_K_XL.gguf \
  --mmproj unsloth/Qwen3.5-4B-GGUF/mmproj-F16.gguf \
  --seed 3407 \
  --temp 1.0 \
  --top-p 0.95 \
  --min-p 0.01 \
  --top-k 40 \
  -c 49152 \
  --port 8001 \
  --chat-template-kwargs '{"enable_thinking":true}' \
  --host 0.0.0.0

# check model name and pass inference
curl http://localhost:8001/v1/models

curl http://localhost:8001/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen",
    "messages": [
      {"role": "user", "content": "hello"}
    ]
  }'

cd ~/.versper && nvim config.yaml
# model:
#  api_key: sk-no-key-required
#  base_url: http://localhost:8001/v1
#  default: unsloth/Qwen3.5-4B-GGUF
#  provider: custom

versper doctor # make sure all checks passed

Add-on

if ban mcp in ~/.versper/.env:
export VERSPER_BROWSER_USE_MCP=0

# live chrome control
npm install -g chrome-devtools-mcp@latest
npm install -g agent-browser@latest

# make sure you have installed chrome
google-chrome-stable

# fill it in the search bar and click the box
chrome://inspect/#remote-debugging

# check chrome connect
versper
/browser status