openclaw安装小教程-适用于macos

openclaw

OpenClaw 是一款开源 AI，可在 WhatsApp、Telegram、Discord、Slack 和 iMessage 上执行任务。自托管、隐私优先，支持 50+ 集成。

近期，大家应该都被openclaw刷屏了，各种最强助手案例、安装教程等不绝于屏。今天，我自己简单的安装了一下openclaw，把教程分享出来，作为一个基础入门，后期，openclaw及其各种衍生品应该会层出不穷，未来，可能要进入人人一个助手的时代了，这个工具，我们还是要利用起来。

安装流程

openclaw的安装有多种方式，源码、软件、npm等等，我今天先用最简单的方式给大家讲一下安装。

第一步：安装node

安装 Node.js（≥22），OpenClaw 要求 Node.js 版本必须 ≥22，使用 npm 前需要先安装 Node.js。

# 使用 Homebrew 安装 Node.js 22
brew install node@22

# 链接到系统（如果提示未链接）
brew link node@22 --force

# 验证安装
node --version    # 应显示 v22.x.x
npm --version     # 应显示 10.x.x

国内用户加速（配置 npm 镜像源）：

# 配置 npm 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 或使用腾讯云镜像
npm config set registry https://mirrors.cloud.tencent.com/npm/

# 验证镜像源
npm config get registry

第二步：安装依赖

# 安装 Xcode 命令行工具（编译原生模块必需）
xcode-select --install

# 如果提示已安装，可以更新
sudo xcode-select --reset

# 安装 git（通常 macOS 自带，但建议用 Homebrew 更新）
brew install git

第三步：用npm安装

# 使用 npm 全局安装
npm install -g openclaw@latest

# 或使用 npx 直接运行（无需全局安装）
npx openclaw@latest

第四步：验证安装

# 检查版本（全局安装方式）
openclaw --version

# 或 npx 方式
npx openclaw --version

# 应输出类似：2026.3.2 或更新版本

第五步：安装配置

@MacBook-Air-2 ~ % openclaw configure

🦞 OpenClaw 2026.3.2 (85377a2)
   I'm like tmux: confusing at first, then suddenly you can't live without me.

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞 


OpenClaw configure
│
◇  Existing config detected ──╮
│                             │
│  model: anthropic/qwen-max  │
│                             │
├─────────────────────────────╯
│
◇  Where will the Gateway run?
│  Local (this machine)
│
◇  Select sections to configure
│  Model
│
◇  Model/auth provider
│  Qwen
│
◓  Starting Qwen OAuth…│
◇  Qwen OAuth ─────────────────────────────────────────────────────────────────╮
│                                                                              │
│  Open https://chat.qwen.ai/authorize?user_code=CGOTMXKJ&client=qwen-code to  │
│  approve access.                                                             │
│  If prompted, enter the code CGOTMXKJ.                                       │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────╯
◇  Qwen OAuth complete
│
◇  Model configured ─────────────────────────────╮
│                                                │
│  Default model set to qwen-portal/coder-model  │
│                                                │
├────────────────────────────────────────────────╯
│
◇  Provider notes ─────────────────────────────────────────────────────────────╮
│                                                                              │
│  Qwen OAuth tokens auto-refresh. Re-run login if refresh fails or access is  │
│  revoked.                                                                    │
│  Base URL defaults to https://portal.qwen.ai/v1. Override                    │
│  models.providers.qwen-portal.baseUrl if needed.                             │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────╯
│
◇  Models in /model picker (multi-select)
│  4 items selected
Config overwrite: /Users/sherry/.openclaw/openclaw.json (sha256 d94acf2d2df5737ebfbf4fe7c857b60ffbb8dbbe0a1ee181b6d4f49f81172281 -> 995ec64594c0656055e5af5b3438cc7d0301526de103f890f55eee58d5172d5d, backup=/Users/sherry/.openclaw/openclaw.json.bak)
Updated ~/.openclaw/openclaw.json
│
◇  Select sections to configure
│  Web tools
│
◇  Web search ────────────────────────────────────────────────────────────────────╮
│                                                                                 │
│  Web search lets your agent look things up online using the `web_search` tool.  │
│  It requires a Brave Search API key (you can store it in the config or set      │
│  BRAVE_API_KEY in the Gateway environment).                                     │
│  Docs: https://docs.openclaw.ai/tools/web                                       │
│                                                                                 │
├─────────────────────────────────────────────────────────────────────────────────╯
│
◇  Enable web_search (Brave Search)?
│  Yes
│
◇  Brave Search API key (paste it here; leave blank to use BRAVE_API_KEY)
│
│
◇  Web search ────────────────────────────────────────────────────────╮
│                                                                     │
│  No key stored yet, so web_search will stay unavailable.            │
│  Store a key here or set BRAVE_API_KEY in the Gateway environment.  │
│  Docs: https://docs.openclaw.ai/tools/web                           │
│                                                                     │
├─────────────────────────────────────────────────────────────────────╯
│
◇  Enable web_fetch (keyless HTTP fetch)?
│  Yes
Config overwrite: /Users/sherry/.openclaw/openclaw.json (sha256 995ec64594c0656055e5af5b3438cc7d0301526de103f890f55eee58d5172d5d -> 8196b618c64178638c2dc6f65e20ec449078f472240bbc5480fc443bf6a0b37f, backup=/Users/sherry/.openclaw/openclaw.json.bak)
Updated ~/.openclaw/openclaw.json
│
◇  Select sections to configure
│  Skills
│
◇  Skills status ─────────────╮
│                             │
│  Eligible: 3                │
│  Missing requirements: 48   │
│  Unsupported on this OS: 0  │
│  Blocked by allowlist: 0    │
│                             │
├─────────────────────────────╯
│
◇  Configure skills now? (recommended)
│  Yes
│
◇  Install missing skill dependencies
│  🐙 github
│
◇  Homebrew recommended ──────────────────────────────────────────────────────────╮
│                                                                                 │
│  Many skill dependencies are shipped via Homebrew.                              │
│  Without brew, you'll need to build from source or download releases manually.  │
│                                                                                 │
├─────────────────────────────────────────────────────────────────────────────────╯
│
◇  Show Homebrew install command?
│  No
│
◇  Install failed: github — brew not installed — Homebrew is not installed. Install it from https://brew.sh
Tip: run `openclaw doctor` to review skills + requirements.
Docs: https://docs.openclaw.ai/skills
│
◇  Set GOOGLE_PLACES_API_KEY for goplaces?
│  No
│
◇  Set GEMINI_API_KEY for nano-banana-pro?
│  No
│
◇  Set NOTION_API_KEY for notion?
│  No
│
◇  Set OPENAI_API_KEY for openai-image-gen?
│  No
│
◇  Set OPENAI_API_KEY for openai-whisper-api?
│  No
│
◇  Set ELEVENLABS_API_KEY for sag?
│  No
Config overwrite: /Users/sherry/.openclaw/openclaw.json (sha256 8196b618c64178638c2dc6f65e20ec449078f472240bbc5480fc443bf6a0b37f -> bf7c6111d7efeb31bca8649be452d6e5fd5ab899e65ff76fa64003b8b9ca4f91, backup=/Users/sherry/.openclaw/openclaw.json.bak)
Updated ~/.openclaw/openclaw.json
│
◇  Select sections to configure
│  Workspace
│
◇  Workspace directory
│  /Users/sherry/.openclaw/workspace
Workspace OK: ~/.openclaw/workspace
Sessions OK: ~/.openclaw/agents/main/sessions
Config overwrite: /Users/sherry/.openclaw/openclaw.json (sha256 bf7c6111d7efeb31bca8649be452d6e5fd5ab899e65ff76fa64003b8b9ca4f91 -> 0d5aaddf6378a851842033ab8722ca0adefbf22286a2a724bcdcd14ac01f2f33, backup=/Users/sherry/.openclaw/openclaw.json.bak)
Updated ~/.openclaw/openclaw.json
│
◇  Select sections to configure
│  Continue
│
◇  Control UI ────────────────────────────────────╮
│                                                 │
│  Web UI: http://127.0.0.1:18789/                │
│  Gateway WS: ws://127.0.0.1:18789               │
│  Gateway: reachable                             │
│  Docs: https://docs.openclaw.ai/web/control-ui  │
│                                                 │
├─────────────────────────────────────────────────╯
│
└  Configure complete.

注意：这里的安装需要注意的是，在选择Gateway的models时候，可以选择Qwen，这个模型时国内大模型，比较稳定，另外，我们也可以自己买，其他模型效果更好可是要收费并且不一定稳定，整个过程只需要按照步骤一步步往下走就可以。

第六步：启动尝试

# 启动命令
@MacBook-Air-2 ~ % openclaw dashboard

跟他说，雇佣他当助手。

我们可以设定角色和名字。

让他帮我整理文件，中间需要授权。

第七步：换大模型

默认的大模型是qwen-portal/coder-model，这个有限制，它是免费的调用多了就不能用了，我们需要换成我们自己的大模型。

首先，打开配置文件：

@MacBook-Air-2 cd ~/.openclaw

@MacBook-Air-2 vim openclaw.json

接着，增加模型：

{
"meta": {
"lastTouchedVersion": "2026.3.2",
"lastTouchedAt": "2026-03-06T14:58:50.074Z"
  },
"wizard": {
"lastRunAt": "2026-03-06T14:58:50.048Z",
"lastRunVersion": "2026.3.2",
"lastRunCommand": "configure",
"lastRunMode": "local"
  },
"auth": {
"profiles": {
"qwen-portal:default": {
"provider": "qwen-portal",
"mode": "oauth"
      }
    }
  },
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "xxx",
"api": "openai-completions",
"models": [
          {
"id": "qwen3.5-plus",
"name": "通义千问3.5 Plus",
"reasoning": false,
"input": ["text"],
"contextWindow": 131072,
"maxTokens": 8192
          },
          {
"id": "qwen-max",
"name": "通义千问Max",
"reasoning": false,
"input": ["text"],
"contextWindow": 32768,
"maxTokens": 8192
          }
        ]
      },
"qwen-portal": {
"baseUrl": "https://portal.qwen.ai/v1",
"apiKey": "qwen-oauth",
"api": "openai-completions",
"models": [
          {
"id": "coder-model",
"name": "Qwen Coder",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
            },
"contextWindow": 128000,
"maxTokens": 8192
          },
          {
"id": "vision-model",
"name": "Qwen Vision",
"reasoning": false,
"input": ["text", "image"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
            },
"contextWindow": 128000,
"maxTokens": 8192
          }
        ]
      }
    }
  },
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3.5-plus",
"fallbacks": [
"bailian/qwen-max"
        ]
      },
"models": {
"bailian/qwen3.5-plus": {
"alias": "qwen"
        },
"bailian/qwen-max": {}
      },
"workspace": "/Users/sherry/.openclaw/workspace"
    }
  },
"tools": {
"web": {
"search": {
"enabled": true
      },
"fetch": {
"enabled": true
      }
    }
  },
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true,
"ownerDisplay": "raw"
  },
"gateway": {
"mode": "local",
"auth": {
"mode": "token",
"token": ""
    }
  },
"plugins": {
"entries": {
"qwen-portal-auth": {
"enabled": true
      }
    }
  }
}