Skip to main content

​
OpenClaw详细安装流程：

curl -fsSL https://openclaw.ai/install.sh | bash
╭────────────────────────────────────────────────────────────────────────────────╮
│                                                                                │
│  🦞 OpenClaw Installer                                                         │
│  I can grep it, git blame it, and gently roast it—pick your coping mechanism.  │
│  modern installer mode                                                         │
│                                                                                │
╰────────────────────────────────────────────────────────────────────────────────╯

✓ gum bootstrapped (temp, verified, v0.17.0)
✓ Detected: macos
            
Install plan
            
OS                  macos
Install method      npm
Requested version   latest
INFO Existing OpenClaw installation detected, upgrading
                           
[1/3] Preparing environment
                           
✓ Homebrew already installed
✓ Node.js v23.11.0 found
                         
[2/3] Installing OpenClaw
                         
✓ Git already installed
INFO Installing OpenClaw v2026.2.19-2
✓ OpenClaw npm package installed
✓ OpenClaw installed
                      
[3/3] Finalizing setup
                      
INFO Running doctor to migrate settings
✓ Doctor complete

🦞 OpenClaw installed successfully (2026.2.19-2)!
Upgraded! Peter fixed stuff. Blame him if it breaks.

INFO Upgrade complete
INFO Running openclaw doctor

🦞 OpenClaw 2026.2.19-2 (45d9b20) — If you're lost, run doctor; if you're brave, run prod; if you're wise, run tests.

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞                    
 
┌  OpenClaw doctor
│
◇  Gateway ──────────────────────────────────────────────────────────╮
│                                                                    │
│  gateway.mode is unset; gateway start will be blocked.             │
│  Fix: run openclaw configure and set Gateway mode (local/remote).  │
│  Or set directly: openclaw config set gateway.mode local           │
│  Missing config: run openclaw setup first.                         │
│                                                                    │
├────────────────────────────────────────────────────────────────────╯
│
◇  Gateway auth ──────────────────────────────────────────────────────────────────────╮
│                                                                                     │
│  Gateway auth is off or missing a token. Token auth is now the recommended default  │
│  (including loopback).                                                              │
│                                                                                     │
├─────────────────────────────────────────────────────────────────────────────────────╯
│
◇  Generate and configure a gateway token now?
│  Yes
│
◇  Gateway auth ──────────────╮
│                             │
│  Gateway token configured.  │
│                             │
├─────────────────────────────╯
│
◇  Create Session store dir at ~/.openclaw/agents/main/sessions?
│  Yes
│
◇  Create OAuth dir at ~/.openclaw/credentials?
│  Yes
│
◇  State integrity ───────────────────────────────────────────────────────────╮
│                                                                             │
│  - CRITICAL: Session store dir missing (~/.openclaw/agents/main/sessions).  │
│  - CRITICAL: OAuth dir missing (~/.openclaw/credentials).                   │
│                                                                             │
├─────────────────────────────────────────────────────────────────────────────╯
│
◇  Doctor changes ────────────────────────────────────────────────╮
│                                                                 │
│  - Created Session store dir: ~/.openclaw/agents/main/sessions  │
│  - Created OAuth dir: ~/.openclaw/credentials                   │
│                                                                 │
├─────────────────────────────────────────────────────────────────╯
│
◇  Security ─────────────────────────────────╮
│                                            │
│  - No channel security warnings detected.  │
│  - Run: openclaw security audit --deep     │
│                                            │
├────────────────────────────────────────────╯
│
◇  Skills status ────────────╮
│                            │
│  Eligible: 32              │
│  Missing requirements: 18  │
│  Blocked by allowlist: 0   │
│                            │
├────────────────────────────╯
│
◇  Plugins ──────╮
│                │
│  Loaded: 4     │
│  Disabled: 32  │
│  Errors: 0     │
│                │
├────────────────╯
│
◇  Memory search ───────────────────────────────────────────────────────────────────────────╮
│                                                                                           │
│  Memory search is enabled but no embedding provider is configured.                        │
│  Semantic recall will not work without an embedding provider.                             │
│                                                                                           │
│  Fix (pick one):                                                                          │
│  - Set OPENAI_API_KEY or GEMINI_API_KEY in your environment                               │
│  - Add credentials: openclaw auth add --provider openai                                   │
│  - For local embeddings: configure agents.defaults.memorySearch.provider and local model  │
│    path                                                                                   │
│  - To disable: openclaw config set agents.defaults.memorySearch.enabled false             │
│                                                                                           │
│  Verify: openclaw memory status --deep                                                    │
│                                                                                           │
├───────────────────────────────────────────────────────────────────────────────────────────╯
│
◇  
│
◇  Gateway ──────────────╮
│                        │
│  Gateway not running.  │
│                        │
├────────────────────────╯
│
◇  Gateway connection ───────────────────────────╮
│                                                │
│  Gateway target: ws://127.0.0.1:18789          │
│  Source: local loopback                        │
│  Config: /Users/linxi/.openclaw/openclaw.json  │
│  Bind: loopback                                │
│                                                │
├────────────────────────────────────────────────╯
│
◇  Gateway ────────────────────────╮
│                                  │
│  Gateway service not installed.  │
│                                  │
├──────────────────────────────────╯
│
◇  Install gateway service now?
│  Yes
│
◇  Gateway service runtime
│  Node (recommended)

Installed LaunchAgent: /Users/linxi/Library/LaunchAgents/ai.openclaw.gateway.plist
Logs: /Users/linxi/.openclaw/logs/gateway.log
Updated ~/.openclaw/openclaw.json
│
└  Doctor complete.

INFO Updating plugins
No npm-installed plugins to update.
INFO Gateway daemon detected; restarting
✓ Gateway restarted

🦞 OpenClaw 2026.2.19-2 (45d9b20) — WhatsApp automation without the "please accept our new privacy policy".

Dashboard URL: http://127.0.0.1:18789/#token=2ce604795458c2b93ceed75562ae150036641645a44afb8d
Copied to clipboard.
Opened in your browser. Keep that tab to control OpenClaw.
╭─────────────────────────────────────────╮
│ Need help?                              │
│ FAQ: https://docs.openclaw.ai/start/faq │
╰─────────────────────────────────────────╯

​
OpenClaw 常用命令：

# 1. 安装 openclaw：
curl -fsSL https://openclaw.ai/install.sh | bash

# 2. 查看版本（是否安装成功）
openclaw --version

# 3. 运行初始化向导，很多初始配置的修改也可以通过这行命令
openclaw onboard --install-daemon

# 4. 启动网关
# 前台启动网关
openclaw gateway
# 
# 5. 关闭网关
openclaw gateway stop

重启网关服务：
openclaw gateway restart

查看状态（是否有重复进程）：
openclaw gateway status
lsof -nP -iTCP:18789 -sTCP:LISTEN

怀疑有“僵尸/重复”进程，先彻底清场再启动：
openclaw gateway stop
pkill -f "openclaw-gateway|dist/index.js gateway" || true
openclaw gateway start

# 6. 打开终端页面
openclaw tui

# 7. 查看 gateway 状态
openclaw gateway status

# 8. 查看所有支持的模型
openclaw models list --all

​
Openclaw IOS应用连接OpenClaw教程：

OpenClaw iOS（模拟器）从安装到手动连接 Mac mini 全流程（不使用配对码）
  1. 安装依赖（Mac mini）
cd /Volumes/Project/Agent/openclaw
pnpm install
brew install xcodegen
  1. 生成 iOS 工程
cd /Volumes/Project/Agent/openclaw/apps/ios
xcodegen generate
open OpenClaw.xcodeproj
  1. 在 Xcode 安装到模拟器
  • Scheme: OpenClaw
  • Destination: 任选 iPhone Simulator（如 iPhone 16）
  • Configuration: Debug
  • 点击 Run（⌘R）
  1. 启动并确认网关
openclaw gateway start
openclaw gateway status
lsof -nP -iTCP:18789 -sTCP:LISTEN
应看到监听 127.0.0.1:18789。
  1. 确认网关认证方式
openclaw config get gateway.auth.mode
你当前是 token 模式。
  1. 取手动连接所需凭证
jq -r '.gateway.auth.token' ~/.openclaw/openclaw.json
拿到 token（password 在 token 模式下不用填）。
  1. iOS App 手动连接（不走 setup code） 在模拟器 App 中：
  • Settings -> Gateway -> Advanced
  • 打开 Use Manual Gateway
  • Host: 127.0.0.1（或 localhost）
  • Port: 18789
  • Use TLS: off
  • Gateway OAuth Token: 第 6 步 token
  • Gateway OAuth Password: 留空
  • 点击 Connect (Manual)
  1. 如果出现 pairing required（常见） 这不是 setup code，而是设备审批，执行：
openclaw devices list
openclaw devices approve <requestId>
或 Telegram /pair approve。
  1. 验证连接
openclaw logs --follow --plain
并在 App 的 Settings -> Gateway 看：
  • Status 已连接
  • Server/Address 有值
一键排障命令（连接失败时按顺序跑） 
openclaw gateway status
openclaw doctor
openclaw gateway restart
openclaw devices list
openclaw logs --follow --plain

​
Bug 解决：

​
Bug1： gateway connect failed: Error: pairing required

Manual Fix

Edit ~/.openclaw/devices/paired.json — find the openclaw-probe device and update both scopes arrays (top-level and inside tokens.operator):
"scopes": ["operator.read", "operator.admin", "operator.approvals", "operator.pairing"]
Edit ~/.openclaw/identity/device-auth.json — same change to tokens.operator.scopes.

Restart the gateway:

openclaw gateway restart

​
Bug2：disconnected (1008): unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)

This gateway requires auth. Add a token or password, then click Connect.openclaw dashboard —no-open → tokenized URL openclaw doctor —generate-gateway-token → set token Docs: Control UI auth Token 不匹配问题： 
在终端中运行以下命令来强制生成一个新的网关 Token：

Bash
openclaw doctor --generate-gateway-token
(注：如果你想查找现有的 Token，也可以查看本地配置文件：grep -A1 '"token"' ~/.openclaw/openclaw.json)

将终端输出的那串 Token 字符复制下来。

回到你目前报错的 Control UI 网页界面。

找到网关访问配置区域（通常在左侧菜单的 Control -> Overview -> Gateway Access Panel 中）。

将复制好的 Token 粘贴到输入框中，然后点击 Connect（连接）。
Last modified on February 24, 2026