学习OpenClaw完整部署和使用教程，涵盖环境配置、多平台安装（Docker/WSL2）、AI模型选择、消息平台接入（飞书/WhatsApp），及常见问题排查，轻松拥有你的24/7 AI私人助手。

第一部分：OpenClaw 是什么？为何选择它？
OpenClaw 是一个开源的AI私人助手框架，它能让你喜欢的大语言模型（LLM）连接到你的消息应用，如WhatsApp、Telegram、飞书、Discord等。它不只是一个简单的聊天机器人，更是一个具备“思考”和“行动”能力的AI智能体，可以帮你处理文件、查询信息、甚至执行复杂的自动化任务。

OpenClaw 的核心优势包括：

24/7 在线： 一旦部署成功，你的AI助手就能全天候为你服务。
高度定制化： 支持多种大语言模型，从云端API（如智谱AI的GLM-4、Anthropic的Claude、OpenAI的GPT系列）到本地部署模型（如Ollama）。
多平台接入： 轻松连接你常用的消息平台，让AI助手触手可及。
安全沙箱机制： 大部分部署方式（尤其是Docker）提供沙箱环境，即使AI执行代码也能保障宿主系统安全。
强大的自动化能力： 具备自主规划、工具调用、信息处理等能力，能够像人类一样解决问题。
我的初次部署小插曲：

记得我第一次尝试部署OpenClaw时，也是信心满满，但很快就遇到了挑战。当时我在Mac上用npm安装后，在配置消息平台时，WhatsApp的扫码功能怎么也连不上。折腾了好久才发现，原来是我开着VPN，导致网络环境复杂，手机和电脑不在同一个局域网。关掉VPN，切换到直连网络后，一切瞬间畅通。这个小经历让我明白，再详细的教程，也比不上一次亲自动手和解决问题的实践。所以，请放手去尝试吧，遇到问题很正常，我们一起来克服。

第二部分：部署前的准备工作（基础环境篇）
在开始安装OpenClaw之前，我们需要确保电脑环境已经准备就绪。这就像盖房子前要先打好地基一样。

Node.js (版本要求 ≥ 22) OpenClaw 是一个基于Node.js的项目，因此Node.js是必不可少的核心运行时。

推荐安装方式： 访问Node.js官网 (nodejs.org)，下载并安装 LTS (长期支持) 版本，务必选择 v22.x 或更高版本。安装时请勾选“Add to PATH”，这样才能在命令行中直接使用Node.js和npm。
包管理器安装（macOS/Linux 推荐）：
macOS (Homebrew): brew install node@22 (或最新稳定版)
Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

国内镜像源加速（可选但推荐）： 如果你在国内下载依赖时遇到速度慢的问题，可以配置npm淘宝镜像：

npm config set registry https://registry.npmmirror.com/

Git Git是版本控制工具，OpenClaw的安装和某些操作会依赖它。

推荐安装方式： 访问Git官网 (git-scm.com)，下载并安装对应系统版本。安装时同样确保勾选“Add Git to PATH”。
包管理器安装（macOS/Linux）：
macOS (Homebrew): brew install git
Ubuntu/Debian: sudo apt install -y git
安装后验证（重要步骤） 打开你的终端（Windows用户可以使用PowerShell或CMD，macOS/Linux用户打开终端），依次输入以下命令，确认Node.js、npm和Git都已正确安装并能显示版本号：

node -v
npm -v
git --version

如果能看到正确的版本信息，恭喜你，环境已准备就绪！

[视觉建议：一张显示 node -v, npm -v, git --version 命令及其输出的终端截图]

第三部分：OpenClaw 的安装方式选择与实践
OpenClaw提供了多种安装方式，每种都适用于不同的场景。这里我们主要介绍最常用的三种。

1. 一键安装脚本（推荐新手，快速上手）
   这是最简单、最快捷的安装方式，适合初次接触OpenClaw或希望快速在本地机器（macOS, Linux, Windows WSL2）上进行测试的用户。安装脚本会自动检测Node.js版本，如有需要还会自动安装或更新。

macOS / Linux 系统：

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

Windows 系统 (通过 PowerShell 以管理员身份运行)：

iwr -useb https://openclaw.ai/install.ps1 | iex

这条命令会下载并执行官方安装程序，完成OpenClaw核心文件的安装和PATH配置。

2. npm 全局安装（开发者友好，版本控制更灵活）
   如果你对Node.js环境比较熟悉，喜欢通过npm管理全局包，可以选择这种方式。

   npm install -g openclaw@latest

   安装完成后，openclaw命令就可以在你的终端中使用了。

3. Docker Compose 部署（推荐生产环境，实现 24/7 运行和环境隔离）
   Docker Compose是部署OpenClaw到云服务器或需要24/7稳定运行的最佳选择。它提供了环境隔离、可复现性和便捷的升级方式。

前置条件： 你的系统需要安装Docker Engine和Docker Compose。
创建项目目录和配置文件：

mkdir -p ~/openclaw-docker && cd ~/openclaw-docker
cat > docker-compose.yml <<EOF
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "127.0.0.1:18789:18789" # 仅限本地访问，更安全
    volumes:
      - ./data:/app/data # 持久化数据
      - ./.env:/app/.env # 环境变量
    environment:
      - NODE_ENV=production
EOF

创建环境变量文件 .env： 在 ~/openclaw-docker 目录下创建 .env 文件，用于存放API Key和机器人Token等敏感信息。例如：

cat > .env <<EOF
OPENAI_API_KEY=sk-your-openai-key-here
ANTHROPIC_API_KEY=sk-your-anthropic-key-here
TELEGRAM_BOT_TOKEN=your-telegram-bot-token-here
EOF

注意： 这里的API Key和Token请替换为你的真实凭证。
启动容器：

docker compose up -d

这条命令会在后台启动OpenClaw容器。你可以使用 docker compose ps 查看容器状态，docker compose logs --tail 50 查看日志。
[视觉建议：一个展示三种安装方式优缺点的简明图表/信息图]

第四部分：交互式配置与核心设置
安装完成后，OpenClaw会引导你进行首次配置。运行以下命令：

openclaw onboard --install-daemon

--install-daemon 参数会帮你安装后台服务（Linux上是systemd，macOS上是launchd），让OpenClaw可以在你关闭终端后继续运行。

配置向导的常见选项：

I understand this is powerful and inherently risky. Continue? 选择 "Yes"。AI Agent拥有操作电脑的权限，所以知晓风险很重要。

Onboarding mode 选择 "QuickStart"（快速开始）模式，适合新手。

Model/auth provider 这里是关键！选择你希望连接的大语言模型服务商。

智谱AI (ZhipuAI)： 对于国内用户，强烈推荐 GLM-4 系列模型，其在中文语境下的表现非常出色，且性价比高。
获取凭证： 登录智谱AI开放平台 (open.bigmodel.cn)，进入控制台创建并复制你的API Key。
Qwen (通义千问)： 阿里云提供的模型，也有免费额度，适合初学者。
获取凭证： 访问阿里云通义千问控制台获取API Key。
Anthropic Claude： 如果你对英文语境下的长文本处理和高质量推理有要求，Claude是非常好的选择。
OpenAI GPT： 全球领先的模型，性能强大，但可能需要解决网络访问问题。
Ollama： 如果你想在本地运行开源模型，Ollama是一个很棒的框架。
关键步骤： 在终端提示输入API Key时，将你获取到的Key粘贴进去并回车。在Windows终端中，通常需要点击鼠标右键来粘贴。

后续选项： 关于安装Skills（技能）或配置IM（消息平台）的选项，首次设置时建议全部选“No”或“Skip”，这些都可以在安装完成后的图形化界面中灵活调整。

访问方式： 最后一个问题请选择 “Open the Web UI”，系统将自动启动默认浏览器并进入可视化看板。

[视觉建议：一系列 openclaw onboard 交互式配置的截图，特别是模型选择和API Key输入界面]

第五部分：连接你的消息平台
OpenClaw的强大之处在于它能与你常用的消息应用无缝集成。这里以几个主流平台为例：

1. 连接 WhatsApp
   运行登录命令：

   openclaw channels login whatsapp

   手机扫描二维码： 终端会显示一个二维码。打开你的手机WhatsApp，进入“设置”->“关联设备”，扫描终端中的二维码。
   首次配对验证： 可能需要手动批准配对。首先查看配对码：

   openclaw pairing list whatsapp

   然后批准配对：

   openclaw pairing approve whatsapp <你的配对码>

2. 连接 Telegram
   创建 Bot： 在Telegram中搜索 @BotFather，创建一个新的Bot并获取到Bot Token。
   在 OpenClaw 中配置： 运行 openclaw onboard 或通过 Web UI/配置文件设置Telegram渠道，输入你的Bot Token。
   激活 Bot： 在Telegram中向你的新Bot发送 /start 消息。
3. 连接飞书 (Feishu)
   飞书作为国内企业常用的协作平台，接入OpenClaw也能大大提升工作效率。

安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu

获取飞书应用凭证： 登录飞书开放平台，创建一个自定义应用，获取 App ID 和 App Secret。
配置飞书渠道： 通过命令行设置（或在Web UI中编辑配置）：

openclaw config set channels.feishu.appId "<你的App ID>"
openclaw config set channels.feishu.appSecret "<你的App Secret>"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket # 推荐长连接
openclaw config set channels.feishu.dmPolicy pairing # 单聊策略为配对授权
openclaw config set channels.feishu.groupPolicy allowlist # 群聊策略为白名单
openclaw config set channels.feishu.requireMention true # 群聊需@机器人才响应

重启网关并配对：

openclaw gateway restart

按照终端提示，在飞书中与机器人进行交互，然后使用 openclaw pairing approve feishu <配对码> 完成配对。
[视觉建议：一张显示OpenClaw与多个消息平台连接状态的Dashboard截图]

第六部分：验证与进阶使用

1. 访问 OpenClaw 的控制台（Dashboard）
   完成配置后，OpenClaw会自动启动Web UI，如果未弹出，可以在浏览器中访问 http://127.0.0.1:18789/。这是你管理AI助手的可视化界面。

对话测试： 点击左侧导航栏的“Chat”，在对话框中输入任意问候语（例如：“你好！”）。如果AI能流畅回复，说明模型连接成功。
Agent 能力测试： 为了验证OpenClaw是否具备操作电脑的能力，你可以发送指令：
“请在我的桌面上创建一个名为‘OpenClaw测试’的文件夹。” 如果文件夹成功创建，说明OpenClaw已具备本地文件系统的读写权限。请务必注意，AI Agent具有实际操作电脑的权限。在日常使用中，建议限制其工作目录（Workspace），防止误删重要文件。

2. 常用命令速查
   在终端中，你也可以直接与OpenClaw进行交互或管理。

   openclaw status：查看OpenClaw服务的运行状态。
   openclaw health：进行健康检查，诊断潜在问题。
   openclaw gateway status：查看网关状态，确保服务正在运行。
   openclaw config set <key> <value>：设置某个配置项。
   openclaw logs：查看OpenClaw的运行日志。
   openclaw gateway restart：重启网关服务，使配置生效。
   openclaw onboard：重新运行初始化向导。
   openclaw doctor：运行诊断工具，检查环境和配置。

3. 全天候运行配置
   如果你通过安装脚本部署，并希望OpenClaw在开机时自动启动并在崩溃后自动重启，可以配置systemd服务（Linux）或launchd服务（macOS）。

Linux Systemd 服务示例：

sudo tee /etc/systemd/system/openclaw.service > /dev/null <<EOF
[Unit]
Description=OpenClaw AI Assistant
After=network.target

[Service]
Type=simple
User=$USER
ExecStart=/usr/local/bin/openclaw start
Restart=on-failure
RestartSec=10
Environment=HOME=/home/$USER

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable openclaw
sudo systemctl start openclaw

然后使用 systemctl status openclaw 验证其运行状态。

第七部分：常见问题与避坑指南
在部署OpenClaw的过程中，你可能会遇到一些常见问题。别慌，这里有一些解决方案。

API Key 粘贴问题

现象： 在Windows终端中按 Ctrl+V 无法粘贴API Key。
解决： 复制Key后，在终端窗口内点击鼠标右键，通常即可完成粘贴。请务必检查Key是否完整，避免多余空格。
服务重启与连接丢失

现象： 关闭终端后网页无法连接。
解决： 若OpenClaw服务意外终止，不要直接刷新网页。你需要重新打开终端，使用 openclaw gateway restart 命令重启服务，然后 openclaw dashboard 命令来唤醒控制台。
配置文件修改与 API KEY 找不到

现象： 直接修改主配置文件 openclaw.json 中的API Key后，启动报错“Config invalid”或“No API key found”。新版本OpenClaw对配置结构有更严格的要求。
解决： 避免直接在 openclaw.json 中嵌入敏感信息。正确的做法是：
创建一个独立的 auth-profiles.json 文件。
关键路径： 文件必须放在 C:\Users\你的用户名.openclaw\agents\main\agent\ (Windows) 或 ~/.openclaw/agents/main/agent/ (macOS/Linux) 下。
内容格式示例：

{
  "zai:default": {
    "secret": "sk-你的智谱Key"
  },
  "openai:default": {
    "secret": "sk-你的OpenAI Key"
  }
}

修改后，使用 openclaw config validate 验证配置，然后 openclaw gateway restart 重启服务。
端口占用问题 (例如 18789 端口)

现象： OpenClaw启动失败，提示端口被占用。
解决：
查找占用进程：

macOS/Linux: lsof -i:18789
Windows: netstat -ano | findstr "18789"

杀死占用进程： 根据查到的PID（进程ID），使用相应命令杀死进程。

macOS/Linux: kill -9 PID
Windows: taskkill /F /PID PID

修改 OpenClaw 网关端口： 如果不想杀死进程，可以修改OpenClaw的网关端口。

openclaw config set agents.gateway.port 18788
openclaw gateway restart

Node.js 版本过低

现象： 安装或运行时提示Node.js版本不兼容，要求22或更高。
解决： 确保你安装的是Node.js LTS v22.x 或更高版本。如果已经安装了旧版本，使用nvm（Node Version Manager）或直接卸载旧版并安装新版。
网络防火墙问题

现象： 云服务器部署后，无法通过公网IP访问OpenClaw Dashboard，或AI模型无法连接。
解决：
云服务器防火墙/安全组： 登录你的云服务商控制台（如腾讯云、阿里云），在防火墙或安全组设置中，确保 TCP 18789 端口 已放行，授权对象设置为 0.0.0.0/0（表示所有IP可访问，但出于安全考虑，生产环境应限制为特定IP）。
本地防火墙： 如果是本地部署，检查系统防火墙（如Linux的ufw或Windows防火墙）是否阻止了OpenClaw的出站连接。
第八部分：安全注意事项
OpenClaw 作为一个能操作电脑的AI Agent，安全性不容忽视。

使用 Docker 沙箱： 强烈建议使用Docker部署，它能将OpenClaw及其执行的代码隔离在一个容器内，即使AI“幻觉”或出现意外，也不会影响宿主系统。
权限审查与工作目录限制： OpenClaw默认的工作目录通常在 ~/.openclaw/workspace。你可以通过配置将其限制在一个安全、不包含重要文件的路径，防止AI误操作或删除关键数据。
定期更新： 关注OpenClaw的官方GitHub仓库或社区，及时更新到最新版本，以获取安全补丁和新功能。

npm update -g openclaw # 如果是npm全局安装
docker compose pull && docker compose up -d # 如果是Docker Compose部署
openclaw update # 一键安装脚本的更新方式

API Key 管理： 妥善保管你的大语言模型API Key，不要将其公开。定期检查API使用量，防止被盗刷。对于生产环境，应考虑使用环境变量或更安全的密钥管理服务。
总结
通过本篇 OpenClaw 完整部署和使用教程，相信你已经掌握了从环境准备到多种安装方式、再到核心配置和常见问题解决的全流程。OpenClaw不仅是一个技术工具，更是你探索AI Agent世界、提升个人生产力的强大伙伴。它将复杂的AI能力变得触手可及，让你有机会亲手打造一个专属于自己的智能助手。

从现在开始，你的AI助手将不再只是一个概念，而是实实在在为你服务的效率利器。勇敢地迈出第一步，去探索OpenClaw带来的无限可能吧！

行动起来！
部署成功了吗？在评论区分享你的OpenClaw使用体验或遇到的有趣挑战吧！如果你在部署过程中有任何疑问，也欢迎留言提问，我将尽力为你解答。别忘了订阅我的博客，获取更多AI工具教程和前沿洞察！

常见问题 (FAQs)
Q1: OpenClaw 对电脑硬件有什么要求？我的旧电脑能运行吗？ A1: OpenClaw本身非常轻量，Node.js进程空闲时通常只占用150-300MB RAM和极少CPU。主要瓶颈在于你选择的大语言模型。建议至少4GB内存，处理器方面现代双核或四核CPU即可。如果需要24/7全天候运行且连接大型AI模型，推荐2vCPU、4GB RAM以上的云服务器配置。对于本地测试，大多数近年来的电脑都能胜任。

Q2: 我可以使用国内的大语言模型，比如百度文心一言或讯飞星火吗？ A2: OpenClaw支持通过插件形式接入各种大语言模型。目前社区已有针对智谱AI GLM、通义千问等国内模型的集成。对于文心一言和星火，如果它们提供了兼容OpenAI接口标准的API，理论上也可以通过配置或开发插件进行接入。建议查阅OpenClaw官方文档或社区插件列表获取最新信息。

Q3: 部署 OpenClaw 需要联网吗？可以完全离线运行吗？ A3: 部署OpenClaw的安装和初始化过程需要联网下载依赖包。安装完成后，如果你选择使用本地部署的大语言模型（如通过Ollama安装的Llama系列模型），且不连接任何云端消息平台，那么OpenClaw可以实现完全离线运行。但若需连接云端LLM或消息平台，则需要稳定的互联网连接。

Q4: OpenClaw 的“Agent能力测试”中，让AI创建文件夹安全吗？它会不会乱改我的文件？ A4: AI Agent拥有操作本地文件系统的能力，这既是它的强大之处，也是需要注意安全的地方。在测试阶段，让AI创建文件夹通常是安全的，因为这是受控且无害的操作。为防止AI误操作重要文件，强烈建议你： 将OpenClaw的工作目录（Workspace）限制在一个专门用于测试、不包含重要数据的路径。 在Docker等沙箱环境中运行OpenClaw，这样AI的操作仅限于容器内部。 * 定期审查OpenClaw的日志，了解它的行为。

Q5: 如果我想让 OpenClaw 24/7 全天候在线，除了Docker还有其他方法吗？ A5: 除了Docker Compose，你也可以在Linux服务器上使用 systemd 服务或在macOS上使用 launchd 服务来管理OpenClaw进程。这些工具可以确保OpenClaw在服务器启动时自动运行，并在程序崩溃时自动重启，从而实现全天候在线。具体配置方法在“第六部分：验证与进阶使用”中有所提及。