general help | Friends of the Crustacean 🦞🤝 | Page 1

last ibexBOT Jan 31, 2026, 3:02 AM

#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

mossy vigilBOT Jan 31, 2026, 3:05 AM

#

Welcome to OpenClaw! 🦞 Your first steps:

1. Run the onboarding wizard

pnpm clawdbot onboard

This walks you through:

Model/auth setup (Anthropic setup-token recommended)
Workspace location + bootstrap files
Gateway settings (port/auth/tailscale)
Provider setup (WhatsApp, Telegram, Discord, Signal, iMessage)

2. Start the Gateway

pnpm clawdbot gateway

#

It runs on port 18789 by default.

3. Open the dashboard
After onboarding, the wizard prints a tokenized URL. Open it in your browser.

Key docs:

FAQ: https://docs.moltbot.ai/start/faq
First-run setup: https://docs.moltbot.ai/start/wizard
Troubleshooting: https://docs.moltbot.ai/gateway/troubleshooting

Let me know if you hit any snags during onboarding! 🦐

vocal verge Jan 31, 2026, 3:06 AM

#

Dependências não satisfeitas:
nodejs : Conflita: npm
npm : Depende: node-agent-base mas não será instalado
Depende: node-archy mas não será instalado
Depende: node-cacache (>= 17) mas não será instalado
Depende: node-chalk (>= 5.1.2-2~) mas não será instalado
Depende: node-cli-table3
Depende: node-columnify mas não será instalado
Depende: node-cssesc
Depende: node-debug mas não será instalado
Depende: node-emoji-regex
Depende: node-gyp mas não será instalado
Depende: node-http-proxy-agent mas não será instalado
Depende: node-https-proxy-agent mas não será instalado
Depende: node-mkdirp mas não será instalado
Depende: node-ms mas não será instalado
Depende: node-nopt mas não será instalado
Depende: node-normalize-package-data mas não será instalado
Depende: node-npm-bundled mas não será instalado
Depende: node-npm-normalize-package-bin
Depende: node-npm-package-arg (>= 10) mas não será instalado
Depende: node-npmlog mas não será instalado
Depende: node-postcss-selector-parser
Depende: node-read-package-json mas não será instalado
Depende: node-rimraf mas não será instalado
Depende: node-semver mas não será instalado
Depende: node-string-width mas não será instalado
Depende: node-strip-ansi mas não será instalado
Depende: node-tar mas não será instalado
Depende: node-validate-npm-package-name mas não será instalado
Depende: node-which mas não será instalado
Depende: nodejs:any
Recomenda: node-tap mas não será instalado
Erro: Unable to satisfy dependencies. Reached two conflicting decisions:

npm:amd64 Depende nodejs:any
but none of the choices are installable:
- nodejs:amd64=20.19.4+dfsg-1 is not selected for install
npm:amd64=9.2.0~ds1-3 is selected for install

mossy vigilBOT Jan 31, 2026, 3:07 AM

#

vocal verge Dependências não satisfeitas: nodejs : Conflita: npm npm : Depende: node-agent...

This is a common Linux issue — the system's old npm/nodejs packages conflict. Here's the fix:

Install Node.js properly using nvm:

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# Load nvm
source ~/.bashrc  # or ~/.zshrc

# Install Node 22+ (Clawdbot needs >=22)
nvm install 22
nvm use 22

# Verify

#

node --version  # should be 22.x
pnpm --version  # should work now

Then run the install:

cd /path/to/clawdbot
pnpm install
pnpm clawdbot onboard

Why this happens: Debian/Ubuntu's npm package depends on an old nodejs version, creating circular conflicts. nvm installs Node outside the system package manager, avoiding this entirely.

#

Let me know once you've got Node 22+ installed! 🦐

vocal verge Jan 31, 2026, 3:08 AM

#

Abel@owo:~$ nodejs --version
v22.22.0
Abel@owo:~$ npm --version
10.9.4

mossy vigilBOT Jan 31, 2026, 3:10 AM

#

vocal verge Abel@owo:~$ nodejs --version v22.22.0 Abel@owo:~$ npm --version 10.9.4

Nice! Node is ready. Now install pnpm and clone/run Clawdbot:

# Install pnpm (using npm since you have it)
npm install -g pnpm

# Verify
pnpm --version

# Clone and install
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install

# Run onboarding
pnpm clawdbot onboard

#

Quick notes:

Use pnpm instead of npm for the install and all clawdbot commands
The wizard will guide you through setup
If you don't have git, install it first: sudo apt install git

Let me know when you're at the pnpm install step or if you hit any issues! 🦐

vocal verge Jan 31, 2026, 3:12 AM

#

Is ~/.openclaw the right default folder?

mossy vigilBOT Jan 31, 2026, 3:14 AM

#

vocal verge Is ~/.openclaw the right default folder?

Not quite! The default state directory is ~/.clawdbot (not .openclaw):

~/.clawdbot/
├── clawdbot.json      # Main config
├── agents/            # Per-agent state
├── credentials/       # Provider credentials
└── sessions/          # Chat history

Your workspace (where MEMORY.md, SOUL.md, AGENTS.md, etc. live) defaults to ~/clawd — separate from the state directory.

If the wizard is asking about ~/.openclaw:

That's likely outdated or a misremembered default. Stick with:

#

State dir: ~/.clawdbot (config, credentials, sessions)
Workspace: ~/clawd (agent files)

Just accept the wizard's defaults or point them to wherever you want. Let me know if anything looks off! 🦐

#general help