sbusso/claudeclaw

"author": {     "name": "sbusso",     "url": "https://github.com/sbusso"

"name": "sbusso",     "url": "https://github.com/sbusso"   },

"url": "https://github.com/sbusso"

},   "repository": "https://github.com/sbusso/claudeclaw",   "license": "MIT",

"repository": "https://github.com/sbusso/claudeclaw",

# Login once agent-browser open https://app.example.com/login

agent-browser open https://app.example.com/login

# Later: load saved state agent-browser state load auth.json agent-browser open https://app.example.com/dashboard

agent-browser open https://app.example.com/dashboard

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

agent-browser eval "document.title"   # Run JavaScript

agent-browser open https://example.com/form

agent-browser open https://example.com/products

git remote add discord https://github.com/qwibitai/claudeclaw-discord.git

> I need you to create a Discord bot: > > 1. Go to the [Discord Developer Portal](https://discord.com/developers/applications)

> > 1. Go to the [Discord Developer Portal](https://discord.com/developers/applications) > 2. Click **New Application** and give it a name (e.g., "Andy Assistant")

> 1. Go to the [Discord Developer Portal](https://discord.com/developers/applications)

[Credential-related source omitted]

If the bot connects but can't read messages, ensure: 1. Go to [Discord Developer Portal](https://discord.com/developers/applications)

1. Go to [Discord Developer Portal](https://discord.com/developers/applications)

git remote add gmail https://github.com/qwibitai/claudeclaw-gmail.git

> I need you to set up Google Cloud OAuth credentials: > > 1. Open https://console.cloud.google.com — create a new project or select existing

> > 1. Open https://console.cloud.google.com — create a new project or select existing > 2. Go to **APIs & Services > Library**, search "Gmail API", click **Enable**

> 1. Open https://console.cloud.google.com — create a new project or select existing

rm -r data/sessions/*/agent-runner-src 2>/dev/null || true

rm ~/.gmail-mcp/credentials.json

4. Clear stale agent-runner copies: `rm -r data/sessions/*/agent-runner-src 2>/dev/null || true`

7. Clear stale agent-runner copies: `rm -r data/sessions/*/agent-runner-src 2>/dev/null || true`

git remote add whatsapp https://github.com/qwibitai/claudeclaw-whatsapp.git

If Ollama is not installed, direct the user to https://ollama.com/download.

git remote add upstream https://github.com/sbusso/claudeclaw.git

By default, the MCP server connects to `http://host.docker.internal:11434` (Docker Desktop) with a fallback to `localhost`. To use a custom Ollama host, add to `.env`:

OLLAMA_HOST=http://your-ollama-host:11434

1. Verify Ollama is running: `ollama list` 2. Check Docker can reach the host: `docker run --rm curlimages/curl curl -s http://host.docker.internal:11434/api/tags`

2. Check Docker can reach the host: `docker run --rm curlimages/curl curl -s http://host.docker.internal:11434/api/tags`

User must have: 1. Parallel AI API key from https://platform.parallel.ai

1. Parallel AI API key from https://platform.parallel.ai

**If they need one:** Tell them: > 1. Go to https://platform.parallel.ai

Tell them: > 1. Go to https://platform.parallel.ai > 2. Sign up or log in

> 1. Go to https://platform.parallel.ai

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

mcpServers['parallel-search'] = {     type: 'http',  // REQUIRED: Must specify type for HTTP MCP servers     url: 'https://search-mcp.parallel.ai/mcp',

type: 'http',  // REQUIRED: Must specify type for HTTP MCP servers     url: 'https://search-mcp.parallel.ai/mcp',     headers: {

url: 'https://search-mcp.parallel.ai/mcp',

mcpServers['parallel-task'] = {     type: 'http',  // REQUIRED: Must specify type for HTTP MCP servers       url: 'https://task-mcp.parallel.ai/mcp',

type: 'http',  // REQUIRED: Must specify type for HTTP MCP servers       url: 'https://task-mcp.parallel.ai/mcp',     headers: {

url: 'https://task-mcp.parallel.ai/mcp',

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

git remote add whatsapp https://github.com/qwibitai/claudeclaw-whatsapp.git

QMD (https://github.com/tobi/qmd) is a local search engine for markdown files. It combines BM25 keyword search, vector semantic search, and LLM re-ranking — all running on-device via node-llama-cpp with GGUF models.

git remote add whatsapp https://github.com/qwibitai/claudeclaw-whatsapp.git

[Credential-related source omitted]

1. Verify tokens: `curl -s "https://api.telegram.org/botTOKEN/getMe"`

git remote add telegram https://github.com/qwibitai/claudeclaw-telegram.git

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

If yes, collect it now. If no, direct them to create one at https://platform.openai.com/api-keys.

git remote add whatsapp https://github.com/qwibitai/claudeclaw-whatsapp.git

[Credential-related source omitted]

> I need you to create an OpenAI API key: > > 1. Go to https://platform.openai.com/api-keys

> > 1. Go to https://platform.openai.com/api-keys > 2. Click "Create new secret key"

> 1. Go to https://platform.openai.com/api-keys

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

Check logs for the specific error. Common causes: - Network timeout — transient, will work on next message - Invalid API key — regenerate at https://platform.openai.com/api-keys

- Network timeout — transient, will work on next message - Invalid API key — regenerate at https://platform.openai.com/api-keys - Rate limiting — wait and retry

- Invalid API key — regenerate at https://platform.openai.com/api-keys

git remote add whatsapp https://github.com/qwibitai/claudeclaw-whatsapp.git

rm -rf store/auth/

rm -f store/pairing-code.txt && npx tsx setup/index.ts --step whatsapp-auth -- --method pairing-code --phone <their-phone-number> > /tmp/wa-auth.log 2>&1 &

[Credential-related source omitted]

rm -rf store/auth/ && npx tsx src/channels/whatsapp-auth.ts

rm -rf store/auth/ && npx tsx src/channels/whatsapp-auth.ts --pairing-code --phone <phone>

rm -rf store/auth/ && npx tsx setup/index.ts --step whatsapp-auth -- --method qr-browser

1. Delete auth credentials: `rm -rf store/auth/`

[Credential-related source omitted]

If not installed: - Download from https://github.com/apple/container/releases

- Download from https://github.com/apple/container/releases

git remote add upstream https://github.com/sbusso/claudeclaw.git

[Credential-related source omitted]

[Credential-related source omitted]

rm -rf /tmp/test-ro

cat /tmp/test-rw/new.txt && rm -rf /tmp/test-rw

**Apple Container not found:** - Download from https://github.com/apple/container/releases

- Download from https://github.com/apple/container/releases

[Credential-related source omitted]

[Credential-related source omitted]

- macOS: `launchctl unload ~/Library/LaunchAgents/com.claudeclaw.<dirname>.plist`    - Linux: `systemctl --user stop claudeclaw-<dirname>` 4. Clone: `git clone https://github.com/<username>/claudeclaw.git <clone-path>`

- Linux: `systemctl --user stop claudeclaw-<dirname>` 4. Clone: `git clone https://github.com/<username>/claudeclaw.git <clone-path>` 5. Copy state from current data directory: `cp -r store groups .env <clone-path>/`

4. Clone: `git clone https://github.com/<username>/claudeclaw.git <clone-path>`

[Credential-related source omitted]

7. Clear stale sessions: `sqlite3 <clone-path>/store/messages.db "DELETE FROM sessions"` 8. Install and build: `cd <clone-path> && npm install && npm run build` 9. Set up upstream: `cd <clone-path> && git remote add upstream https://github.

8. Install and build: `cd <clone-path> && npm install && npm run build` 9. Set up upstream: `cd <clone-path> && git remote add upstream https://github.com/sbusso/claudeclaw.git` 10. Run service setup: `cd <clone-path> && npx tsx setup/index

9. Set up upstream: `cd <clone-path> && git remote add upstream https://github.com/sbusso/claudeclaw.git`

[Credential-related source omitted]

[Credential-related source omitted]

--dangerously-skip-permissions cannot be used with root/sudo privileges

--dangerously-skip-permissions cannot be used with root/sudo privileges

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

claudeclaw-agent:latest -c '   export $(cat /workspace/env-dir/env | xargs)   claude -p "Say hello" --dangerously-skip-permissions --allowedTools ""

export $(cat /workspace/env-dir/env | xargs)   claude -p "Say hello" --dangerously-skip-permissions --allowedTools "" '

claude -p "Say hello" --dangerously-skip-permissions --allowedTools ""

allowedTools: ['Bash', 'Read', 'Write', ...],     permissionMode: 'bypassPermissions',     allowDangerouslySkipPermissions: true,  // Required with bypassPermissions

permissionMode: 'bypassPermissions',     allowDangerouslySkipPermissions: true,  // Required with bypassPermissions     settingSources: ['project'],

allowDangerouslySkipPermissions: true,  // Required with bypassPermissions

**Important:** `allowDangerouslySkipPermissions: true` is required when using `permissionMode: 'bypassPermissions'`. Without it, Claude Code exits with code 1.

rm -rf data/sessions/

rm -rf data/sessions/{groupFolder}/.claude/

[Credential-related source omitted]

[Credential-related source omitted]

docker info &>/dev/null && echo "OK" || echo "NOT RUNNING - start Docker Desktop (macOS) or sudo systemctl start docker (Linux)"

Bash

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

| `ENVIRONMENT_NAME` | `{API_URL}` | |---|---| | set (e.g. `staging`) | `https://qodo-platform.staging.qodo.ai/rules/v1` |

| set (e.g. `staging`) | `https://qodo-platform.staging.qodo.ai/rules/v1` |

- SSH: `git@github.com:org/repo.git` → `/org/repo/` - HTTPS: `https://github.com/org/repo.git` → `/org/repo/`

- HTTPS: `https://github.com/org/repo.git` → `/org/repo/`

EXTENSION_NAME="${1}" REPO="https://github.com/sbusso/claudeclaw-${EXTENSION_NAME}.git"

REPO="https://github.com/sbusso/claudeclaw-${EXTENSION_NAME}.git"

**CLI:** `gh` - **Install:** `brew install gh` or [cli.github.com](https://cli.github.com/)

- **Install:** `brew install gh` or [cli.github.com](https://cli.github.com/)

**CLI:** `glab` - **Install:** `brew install glab` or [glab.readthedocs.io](https://glab.readthedocs.io/)

- **Install:** `brew install glab` or [glab.readthedocs.io](https://glab.readthedocs.io/)

**CLI:** `bb` or API access - **Install:** See [bitbucket.org/product/cli](https://bitbucket.org/product/cli)

- **Install:** See [bitbucket.org/product/cli](https://bitbucket.org/product/cli)

**CLI:** `az` with DevOps extension - **Install:** `brew install azure-cli` or [docs.microsoft.com/cli/azure](https://docs.microsoft.com/cli/azure)

- **Install:** `brew install azure-cli` or [docs.microsoft.com/cli/azure](https://docs.microsoft.com/cli/azure)

- **Install extension:** `az extension add --name azure-devops` - **Authenticate:** `az login` then `az devops configure --defaults organization=https://dev.azure.com/yourorg project=yourproject` - **Verify:**

- **Authenticate:** `az login` then `az devops configure --defaults organization=https://dev.azure.com/yourorg project=yourproject`

[Credential-related source omitted]

[Credential-related source omitted]

git remote rename origin upstream git remote add origin https://github.com/<their-username>/claudeclaw.git

git remote add origin https://github.com/<their-username>/claudeclaw.git

git remote add upstream https://github.com/sbusso/claudeclaw.git

git remote add upstream https://github.com/sbusso/claudeclaw.git

- If NODE_OK=false → Node.js is missing or too old. Use `AskUserQuestion: Would you like me to install Node.js 22?` If confirmed:   - macOS: `brew install node@22` (if brew available) or install nvm then `nvm install 22`   - Linux: `curl -f

- macOS: `brew install node@22` (if brew available) or install nvm then `nvm install 22`   - Linux: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs`, or nvm   - After installing Node, re-

- Linux: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs`, or nvm

- Linux: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs`, or nvm

- DOCKER=installed_not_running → start Docker: `open -a Docker` (macOS) or `sudo systemctl start docker` (Linux). Wait 15s, re-check with `docker info`.

- DOCKER=installed_not_running → start Docker: `open -a Docker` (macOS) or `sudo systemctl start docker` (Linux). Wait 15s, re-check with `docker info`. - DOCKER=not_found → Use `AskUserQuestion: Docker is required for running agents. Would

- DOCKER=not_found → Use `AskUserQuestion: Docker is required for running agents. Would you like me to install it?` If confirmed:   - macOS: install via `brew install --cask docker`, then `open -a Docker` and wait for it to start. If brew n

- macOS: install via `brew install --cask docker`, then `open -a Docker` and wait for it to start. If brew not available, direct to Docker Desktop download at https://docker.com/products/docker-desktop

- Linux: install with `curl -fsSL https://get.docker.com | sh && sudo usermod -aG docker $USER`. Note: user may need to log out/in for group membership.

- Linux: install with `curl -fsSL https://get.docker.com | sh && sudo usermod -aG docker $USER`. Note: user may need to log out/in for group membership.

[Credential-related source omitted]

[Credential-related source omitted]

**If FALLBACK=wsl_no_systemd:** WSL without systemd detected. Tell user they can either enable systemd in WSL (`echo -e "[boot]\nsystemd=true" | sudo tee /etc/wsl.conf` then restart WSL) or use the generated `start-claudeclaw.sh` wrapper.

1. Immediate fix: `sudo setfacl -m u:$(whoami):rw /var/run/docker.sock`

sudo mkdir -p /etc/systemd/system/docker.service.d

sudo tee /etc/systemd/system/docker.service.d/socket-acl.conf << 'EOF'

sudo systemctl daemon-reload

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

**Container agent fails ("Claude Code process exited with code 1"):** Ensure the container runtime is running — `open -a Docker` (macOS Docker), `container system start` (Apple Container), or `sudo systemctl start docker` (Linux). Check con

rm -rf "$EXT_DIR"

rm -f "$PLIST_PATH"

rm -f "$SERVICE_PATH"

[Credential-related source omitted]

**Preflight**: checks for clean working tree (`git status --porcelain`). If `upstream` remote is missing, asks you for the URL (defaults to `https://github.com/sbusso/claudeclaw.git`) and adds it. Detects the upstream branch name (`main` or

- `git remote -v` If `upstream` is missing: - Ask the user for the upstream repo URL (default: `https://github.com/sbusso/claudeclaw.git`).

If `upstream` is missing: - Ask the user for the upstream repo URL (default: `https://github.com/sbusso/claudeclaw.git`). - Add it: `git remote add upstream <user-provided-url>`

- Ask the user for the upstream repo URL (default: `https://github.com/sbusso/claudeclaw.git`). - Add it: `git remote add upstream <user-provided-url>` - Then: `git fetch upstream --prune`

If `upstream` is missing: - Ask the user for the upstream repo URL (default: `https://github.com/sbusso/claudeclaw.git`).

- Ask the user for the upstream repo URL (default: `https://github.com/sbusso/claudeclaw.git`).

mkdir -p data/models curl -L -o data/models/ggml-base.bin "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin"

curl -L -o data/models/ggml-base.bin "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin"

git remote add whatsapp https://github.com/qwibitai/claudeclaw-whatsapp.git

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

@Assistant like this tweet https://x.com/user/status/123

@Assistant reply to https://x.com/user/status/123 with: Great post!

@Assistant retweet https://x.com/user/status/123

@Assistant quote https://x.com/user/status/123 with comment: Interesting

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

rm -f data/x-browser-profile/SingletonLock

rm -f data/x-browser-profile/SingletonSocket

[Credential-related source omitted]

[Credential-related source omitted]

Executable file

Provide the tweet URL or tweet ID to like.`,       {         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID')

{         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID')       },

tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID')

Provide the tweet URL and your reply content.`,       {         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID'),

{         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID'),         content: z.string().max(280).describe('The reply content (max 280 characters)')

tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID'),

Provide the tweet URL to retweet.`,       {         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID')

{         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID')       },

tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID')

Retweet with your own comment added.`,       {         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID'),

{         tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID'),         comment: z.string().max(280).describe('Your comment for the quote tweet (max 280 characters)')

tweet_url: z.string().describe('The tweet URL (e.g., https://x.com/user/status/123) or tweet ID'),

Executable file

Executable file

const tweetId = extractTweetId(tweetUrl);   if (tweetId && !tweetUrl.startsWith('http')) {     url = `https://x.com/i/status/${tweetId}`;

if (tweetId && !tweetUrl.startsWith('http')) {     url = `https://x.com/i/status/${tweetId}`;   }

url = `https://x.com/i/status/${tweetId}`;

Executable file

#!/usr/bin/env npx tsx

/**  * X Integration - Like Tweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx tsx like.ts

* X Integration - Like Tweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx tsx like.ts  */

* Usage: echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx tsx like.ts

#!/usr/bin/env npx tsx

await page.goto('https://x.com/home', { timeout: config.timeouts.navigation, waitUntil: 'domcontentloaded' });

#!/usr/bin/env npx tsx

/**  * X Integration - Quote Tweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123","comment":"My thoughts"}' | npx tsx quote.ts

* X Integration - Quote Tweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123","comment":"My thoughts"}' | npx tsx quote.ts  */

* Usage: echo '{"tweetUrl":"https://x.com/user/status/123","comment":"My thoughts"}' | npx tsx quote.ts

#!/usr/bin/env npx tsx

/**  * X Integration - Reply to Tweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123","content":"Great post!"}' | npx tsx reply.ts

* X Integration - Reply to Tweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123","content":"Great post!"}' | npx tsx reply.ts  */

* Usage: echo '{"tweetUrl":"https://x.com/user/status/123","content":"Great post!"}' | npx tsx reply.ts

#!/usr/bin/env npx tsx

/**  * X Integration - Retweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx tsx retweet.ts

* X Integration - Retweet  * Usage: echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx tsx retweet.ts  */

* Usage: echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx tsx retweet.ts

#!/usr/bin/env npx tsx

await page.goto('https://x.com/login');

console.log('\nVerifying login status...');   await page.goto('https://x.com/home');

await page.goto('https://x.com/home');