用 一行命令 搭起属于你的 🦞 OpenClaw

前置环境检查

需要 macOS / Linux / WSL2，Node.js >= 22.16（推荐 24）。Apple Silicon 跑本地模型最爽。

node -v       # >= v22.16.0
npm -v
sw_vers       # macOS 13+
sysctl -n hw.memsize | awk '{print $1/1024/1024/1024 " GB"}'   # macOS 内存

安装 OpenClaw CLI

全局装 npm 包，会在 /opt/homebrew/bin/openclaw（macOS Apple Silicon）或 /usr/local/bin/openclaw（Linux）落一个可执行。

npm install -g openclaw@latest
openclaw --version
# → OpenClaw 2026.x.x (commit-sha)

非交互式 onboard

官方推荐 openclaw onboard 是交互式向导。我们走非交互模式，一次性把骨架建好（workspace + Gateway daemon），但 model 和 channel 留到后面单独配。

openclaw onboard \
  --non-interactive --accept-risk \
  --install-daemon \
  --auth-choice skip \
  --skip-channels --skip-skills --skip-search --skip-ui

完成后会发生：

• 写入 ~/.openclaw/openclaw.json（含自动生成的 gateway token）
• 写入 ~/.openclaw/workspace/{AGENTS,SOUL,TOOLS}.md
• macOS 装 LaunchAgent ~/Library/LaunchAgents/ai.openclaw.gateway.plist 并启动
• Linux 装 systemd user service 并启动

验证 Gateway 在跑：

lsof -nP -iTCP:18789 -sTCP:LISTEN | head -2
curl -s http://127.0.0.1:18789/__openclaw__/health | head -c 80

配置模型 provider

挑一个分支走。下面给四种最常见的，更多 provider 看 下方表格。

# 1. 装 ollama
brew install ollama && brew services start ollama

# 2. 拉模型
ollama pull qwen3:8b

# 3. 告诉 OpenClaw 用它
openclaw models set "ollama/qwen3:8b"

# 4. 关键：注册占位 API key（即使本地不需要）
echo "export OLLAMA_API_KEY='local'" >> ~/.openclaw/service-env/ai.openclaw.gateway.env

openclaw onboard --non-interactive --accept-risk --auth-choice openai-api-key \
  --openai-api-key "$OPENAI_API_KEY" \
  --skip-channels --skip-skills --skip-search --skip-ui --skip-daemon --skip-bootstrap

openclaw models set "openai/gpt-5.2"   # 或当前 flagship

openclaw onboard --non-interactive --accept-risk --auth-choice anthropic \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --skip-channels --skip-skills --skip-search --skip-ui --skip-daemon --skip-bootstrap

openclaw models set "anthropic/claude-sonnet-4.5"

openclaw onboard --non-interactive --accept-risk --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-channels --skip-skills --skip-search --skip-ui --skip-daemon --skip-bootstrap

openclaw models set "deepseek/deepseek-chat"

重启 Gateway

环境变量写到 ~/.openclaw/service-env/...env 后，需要重启 Gateway 才生效。

# macOS
launchctl kickstart -k gui/$UID/ai.openclaw.gateway

# Linux
systemctl --user restart openclaw-gateway

sleep 3

重置粘性 session（坑！）

这一步是最容易踩的坑：onboard 时如果没指定 model，OpenClaw 会默认初始化一个 gpt-5.5 的 session。后面你切到 Ollama，旧 session 还粘着 OpenAI，会报 No API key found for provider openai。

mv ~/.openclaw/agents/main/sessions/sessions.json{,.bak} 2>/dev/null
echo '{}' > ~/.openclaw/agents/main/sessions/sessions.json

端到端验证

openclaw agent --agent main --message "用一句话简短自我介绍" --thinking off

回个像样的中文一句话就成。如果出错：

• Unknown model: → 第 4 步没做或环境变量没生效
• No API key found for provider openai → 第 5 步没做
• provider/model overrides are not authorized → 别用 --model 临时指定，靠 models set

接入聊天通道

默认安装就送你 WebChat，浏览器直接打开就能聊：

# 1. 拿 token
jq -r .gateway.auth.token ~/.openclaw/openclaw.json

# 2. 打开
open http://127.0.0.1:18789/webchat   # macOS
xdg-open http://127.0.0.1:18789/webchat # Linux

想接 Telegram / Discord / 飞书 / iMessage / 微信，往下看 通道章节。