2026年3月9日

OpenClaw 安装教程：Mac & Windows 命令行安装完整指南

OpenClaw 原版安装教程，支持 Mac 和 Windows。适合有技术基础的用户，完全控制模型和配置。

导语

这篇教程面向有技术基础的用户：你知道什么是终端，你不怕看 YAML 配置文件，你想完全掌控自己的 AI Agent——包括模型选择、数据存储位置、Skills 权限。

如果你符合这个描述，OpenClaw 原版会给你前所未有的自由度。

如果你对命令行感到陌生，或者你主要想通过微信控制 AI，请移步：QClaw 安装教程——那是专为普通用户设计的图形界面版本。

如果你想用微信，推荐用 QClaw

OpenClaw 原版的官方聊天渠道是 Telegram 和 WhatsApp。没有内置微信支持。

如果微信是你的主力通讯工具，有两个选择：

使用 QClaw（腾讯封装版，内置微信直联）
在 ClawHub 上寻找第三方微信 Gateway 插件（社区维护，稳定性不保证）

本教程使用 Telegram 作为示例渠道。

准备工作

系统要求

平台	要求
macOS	12 Monterey 或更高，支持 Intel 和 Apple Silicon
Windows	Windows 10（21H2）或 Windows 11
Linux	Ubuntu 20.04+，Debian 11+，Arch（社区支持）
内存	最低 4 GB，推荐 8 GB
硬盘	1 GB 可用空间

你需要准备的东西

AI 模型 API Key（至少一个）：

OpenAI API Key（GPT-4o）
Anthropic API Key（Claude）
DeepSeek API Key（DeepSeek-R2，对中文友好，价格实惠）
或者本地运行的 Ollama（免费，但需要足够的硬件）

聊天渠道（选其一）：

Telegram 账号 + BotFather 创建 Bot Token
WhatsApp 账号（通过 QR 码接入）

第一步：运行安装脚本

打开终端（Mac 用 Terminal 或 iTerm，Windows 用 PowerShell 或 Git Bash），运行：

Mac / Linux：

curl -fsSL https://openclaw.dev/install.sh | bash

Windows（PowerShell）：

irm https://openclaw.dev/install.ps1 | iex

这个脚本做了什么：

检测你的操作系统和架构（Intel / ARM / x64）
下载适合你系统的 OpenClaw 二进制文件（约 80 MB）
安装到 ~/.openclaw/bin/ 目录
将 openclaw 命令添加到你的 PATH
创建配置目录 ~/.openclaw/
生成默认的 config.yaml 模板
运行一次自检，确认安装成功

安装完成后，终端会显示：

OpenClaw v1.x.x installed successfully.
Config file: ~/.openclaw/config.yaml
Run 'openclaw start' to launch the gateway.

验证安装：

openclaw --version

第二步：配置 AI 模型

编辑配置文件：

# Mac / Linux
nano ~/.openclaw/config.yaml

# 或者用你喜欢的编辑器
code ~/.openclaw/config.yaml

Windows 路径是 C:\Users\你的用户名\.openclaw\config.yaml。

下面是一份完整的配置示例，覆盖了常见场景：

# ~/.openclaw/config.yaml

# ===== AI 模型配置 =====
model:
  # 选择默认模型
  default: deepseek-r2

  providers:
    # DeepSeek（推荐中文用户，价格实惠）
    deepseek:
      api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
      model: "deepseek-chat"
      base_url: "https://api.deepseek.com"

    # OpenAI
    openai:
      api_key: "sk-proj-xxxxxxxxxxxxxxxxxxxxxxxx"
      model: "gpt-4o"

    # Anthropic Claude
    anthropic:
      api_key: "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx"
      model: "claude-opus-4-6"

    # 本地 Ollama（不需要 API Key）
    ollama:
      base_url: "http://localhost:11434"
      model: "qwen2.5:14b"

# ===== 渠道配置 =====
channels:
  telegram:
    enabled: true
    bot_token: "YOUR_TELEGRAM_BOT_TOKEN"

  whatsapp:
    enabled: false

# ===== 数据存储 =====
storage:
  # 数据目录（默认在用户主目录下）
  data_dir: "~/.openclaw/data"

  # 是否启用对话历史
  history: true
  history_days: 30

# ===== 安全设置 =====
security:
  # 只允许特定用户发送指令（填入 Telegram 用户 ID）
  allowed_users:
    - 123456789  # 你的 Telegram 用户 ID

# ===== 日志设置 =====
logging:
  level: info  # debug / info / warn / error
  file: "~/.openclaw/logs/openclaw.log"

获取 Telegram 用户 ID：

在 Telegram 搜索 @userinfobot，发送任意消息，它会告诉你你的数字 ID。

第三步：接入聊天渠道

方式 A：Telegram

在 Telegram 搜索 @BotFather
发送 /newbot
按提示设置机器人名称（如 My OpenClaw Bot）和用户名（需以 bot 结尾，如 myopenclaw_bot）
BotFather 会给你一个 Token，格式类似：1234567890:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
把这个 Token 填入 config.yaml 的 channels.telegram.bot_token 字段

方式 B：WhatsApp

在 config.yaml 中将 channels.whatsapp.enabled 设为 true
启动 OpenClaw：

openclaw start

终端会显示一个二维码
打开 WhatsApp，进入「已关联的设备」→「关联设备」
扫描终端中的二维码

第四步：测试

启动 OpenClaw：

openclaw start

看到以下输出说明启动成功：

[INFO] OpenClaw gateway starting...
[INFO] Model provider: deepseek-r2 ✓
[INFO] Telegram channel: connected ✓
[INFO] Skills loaded: 3 (web-search, file-manager, calculator)
[INFO] Gateway ready. Listening for messages...

现在打开 Telegram，找到你创建的机器人，发送：

/start

机器人应该回复一条欢迎消息。再发送：

你好，你现在能做什么？

如果 AI 正常回复，安装完成。

后台运行（可选）：

# 后台启动
openclaw start --daemon

# 查看状态
openclaw status

# 停止
openclaw stop

第五步：安装第一个 Skill

OpenClaw 默认只包含少量内置工具。要扩展能力，安装 Skills：

# 浏览 ClawHub
openclaw skills search web

# 安装 web-search Skill
openclaw skills install web-search

# 查看已安装的 Skills
openclaw skills list

也可以通过 Web 界面管理（需要先启动 OpenClaw）：

openclaw start --web-ui

然后在浏览器打开 http://localhost:3721，进入 Skills 管理页面。

推荐新手安装的 Skills：

openclaw skills install web-search
openclaw skills install file-manager
openclaw skills install calendar
openclaw skills install github
openclaw skills install weather

安装完成后，重启 OpenClaw：

openclaw restart

常见问题

`curl: command not found`（Mac）

macOS 通常自带 curl。如果没有，安装 Homebrew 后运行：

brew install curl

`openclaw: command not found`

安装脚本可能没有正确修改 PATH。手动添加：

# 在 ~/.zshrc 或 ~/.bashrc 末尾添加
export PATH="$HOME/.openclaw/bin:$PATH"

# 重新加载配置
source ~/.zshrc

Telegram Bot 没有回应

确认 bot_token 填写正确，没有多余的空格
确认你的 Telegram 用户 ID 在 allowed_users 列表中
检查日志：openclaw logs --tail 50
确认 OpenClaw 进程正在运行：openclaw status

API Key 报错（401 Unauthorized）

确认 API Key 没有过期或被撤销
确认账号有足够的余额（DeepSeek、OpenAI 等都是按用量付费）
检查 base_url 是否正确（特别是使用代理或国内镜像时）

Windows 上 PowerShell 执行策略报错

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新运行安装命令。

遇到其他问题，查阅 OpenClaw 官方文档：openclaw.dev/docs，或在 GitHub Issues 搜索是否有人遇到过相同问题。

导语