如何在我的主机安装 OpenClaw

属于你自己的 AI 助手，从一行命令开始

我们相信，AI 不该活在别人的服务器上。它应该属于你的终端、你的设备、你日常使用的每一个聊天窗口。OpenClaw 就是这样一只龙虾——它住在你的机器里，替你跑腿，替你思考。

〇 · 前言：OpenClaw 是什么

OpenClaw 是一个运行在你自有设备上的个人 AI 助手。它不是 SaaS 平台，不是一个网页聊天框——而是一个本地安装、本地运行、通过你已有的聊天工具与你对话的 Gateway。

它能接入 WhatsApp、Telegram、Discord、Slack、微信、QQ 等二十多个通道，支持 macOS / iOS / Android 客户端，提供语音唤醒、实时画布、多智能体路由，以及一套完备的工具链（浏览器操控、定时任务、文件管理等）。

一句话：你的 AI，你的规则，你的机器。

一 · 安装前的准备

在开始之前，请确认你的环境满足以下最低要求：

• • Node.js：Node 24（推荐）或 Node 22.16+
• • 包管理器：npm / pnpm / bun 任选其一
• • 操作系统：macOS / Linux / Windows（强烈推荐 WSL2）

🔔 如果你在 Windows 上，请务必使用 WSL2——原生 Windows 不在推荐范围之内。

快速检查环境

打开终端，逐条确认：

node --version   # 应输出 v22.16.0 或 v24.x.xnpm --version    # 应输出 10.x 或更高

如果版本不符，建议使用 nvm 或 fnm 安装推荐版本的 Node：

# 使用 nvmnvm install 24nvm use 24

二 · 安装 OpenClaw

一条命令即可完成安装：

npm install -g openclaw@latest

如果你用的是 pnpm 或 bun：

pnpm add -g openclaw@latest

安装完成后，验证是否成功：

openclaw --version

终端应当显示类似 OpenClaw 2026.x.x 的版本信息。

三 · 初始化向导（Onboarding）

安装只是第一步。接下来，OpenClaw 的 onboard 命令会带你走完整个初始化流程——Gateway 配置、工作区创建、通道接入、技能安装，一步步交互式引导。

openclaw onboard --install-daemon

--install-daemon 参数会将 OpenClaw Gateway 安装为系统守护进程（macOS 上为 launchd，Linux 上为 systemd user service），实现开机自启、后台常驻。

⬩ Onboard 会引导你完成以下配置：

1. 1. 模型提供商选择 — OpenAI（ChatGPT）等，配置 API Key 或 OAuth 认证
2. 2. 工作区初始化 — 创建属于你个人风格的 Agent 配置
3. 3. 通道接入 — QQ、微信、Telegram、Discord 等，按需配置
4. 4. 技能安装 — 从 ClawHub 安装天气、提醒、浏览器等扩展技能

🎯 新手建议一路默认，先跑起来再说。高级配置可以后续通过 openclaw gateway 调整。

四 · 启动与验证

启动 Gateway

openclaw gateway --port 18789 --verbose

Gateway 启动后，它会开始监听来自各通道的消息，并将它们路由到对应的 Agent。

发送第一条消息

openclaw agent --message "你好，请做个自我介绍" --thinking high

如果一切正常，你会收到 AI 返回的自我介绍。恭喜——你的 OpenClaw 已上线。

通过消息通道测试

如果你已经配置了 Telegram 等通道，可以尝试从外部发送消息：

openclaw message send --target +1234567890 --message "Hello from OpenClaw"

五 · 日常使用速查

• • openclaw gateway --port 18789 --verbose — 启动 Gateway（前台调试）
• • openclaw agent --message "..." — 与 AI 对话
• • openclaw message send --target ... — 向指定通道发送消息
• • openclaw doctor — 诊断配置安全风险
• • openclaw pairing approve <channel> <code> — 批准 DM 配对请求
• • openclaw --help — 查看所有命令

六 · Docker 安装（可选）

如果你更偏好容器化部署：

docker pull ghcr.io/openclaw/openclaw:latestdocker run -d \  --name openclaw \  -v ~/.openclaw:/home/node/.openclaw \  -p 18789:18789 \  ghcr.io/openclaw/openclaw:latest

详细 Docker 配置请参考 docs.openclaw.ai/install/docker^[1]。

七 · 安全提示

OpenClaw 连接真正的消息系统。所有来自未知发件人的私信默认需要配对确认。 这是安全底线，不建议关闭。

• • 配对模式（默认）：陌生人来信会收到配对码，需你手动批准
• • 公开模式：务必搭配 allowFrom 白名单使用
• • 定期运行 openclaw doctor 检查配置安全性

更多安全指南请阅读 docs.openclaw.ai/gateway/security^[2]。

八 · 进阶玩法一览

安装完成后，OpenClaw 的能力远不止聊天：

• • 🎤 语音唤醒与对话 — macOS/iOS 的 Voice Wake + Android 的 Talk Mode
• • 🎨 Live Canvas — 实时代理驱动可视化工作区
• • 🤖 多智能体路由 — 不同通道/联系人路由到独立的 Agent 会话
• • 🌐 浏览器操控 — Agent 可以操作真实浏览器完成复杂任务
• • ⏰ 定时任务 — 原生 Cron 支持
• • 🧩 技能生态 — ClawHub 上的社区技能即装即用

九 · 遇到问题？

• • 官方文档：https://docs.openclaw.ai
• • GitHub：https://github.com/openclaw/openclaw
• • Discord 社区：https://discord.gg/clawd
• • DeepWiki：https://deepwiki.com/openclaw/openclaw
• • 升级指南：运行 openclaw doctor，然后参考 docs.openclaw.ai/install/updating^[3]

🦞 结语

从 npm install -g openclaw@latest 到 openclaw onboard --install-daemon，不过两行命令，一个属于你自己的 AI 助理就诞生了。

它不依赖云端的垂怜，不让你交出自己的数据。它沉默地运行在你的后台，等着你随时召唤。

这就是 OpenClaw 的方式——把 AI 的力量，交还给你自己。

本文首发于「辰宿观澜」转载需注明出处

📎 安装流程图解

 ┌──────────┐    ┌──────────┐    ┌──────────────────┐    ┌──────────┐ │ 环境准备  │───▶│ 全局安装  │───▶│ Onboard 初始化向导 │───▶│ 启动运行  │ │ Node 24+ │    │ npm -g   │    │ 模型/通道/技能配置  │    │ gateway  │ └──────────┘    └──────────┘    └──────────────────┘    └──────────┘

引用链接

[1] docs.openclaw.ai/install/docker: https://docs.openclaw.ai/install/docker[2] docs.openclaw.ai/gateway/security: https://docs.openclaw.ai/gateway/security[3] docs.openclaw.ai/install/updating: https://docs.openclaw.ai/install/updating