openclaw 实用搭建教程

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 下面是根据 openclaw/openclaw GitHub 仓库介绍 及官方文档整理的一个完整 OpenClaw 自托管搭建教程（中文），适合想从源码或者全新安装开始搭建的用户。

OpenClaw 是一个 开源的自托管 AI 个人助手，可以让你通过消息平台（如 WhatsApp、Telegram、Discord 等）与 AI 交互并自动执行任务，实现自动化工作流程。它运行在本地或者你的服务器上，你完全控制数据和权限。(维基百科)

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

✅ 操作系统：Linux / macOS / Windows（建议使用 Linux 或 WSL2）
✅ Node.js：需安装 Node.js >= 22（必须版本）
✅ pnpm：推荐用于构建和管理依赖
✅ 硬件推荐：至少 4GB 内存（运行大型模型需要更多资源）
（若选择 Docker，则不严格依赖本地安装环境）(openclawdoc.com)

下面提供 三种安装方式，你可以根据喜好选择：

✅ 方法 A — 一键安装（推荐）

适合想快速开始的用户：

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

对于 Windows（PowerShell）：

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

安装后你可以运行：

openclaw onboard

该命令会启动一个引导向导，引导你配置模型、API Key、消息通道等。(openclawdoc.com)

🛠 方法 B — 全局安装（npm / pnpm）

如果你想手动安装 CLI：

npm install -g openclaw@latest

或者

pnpm add -g openclaw@latest

安装完成后同样运行：

openclaw onboard

🐳 方法 C — Docker 部署

适合生产或服务器托管环境：

克隆仓库：

git clone https://github.com/openclaw/openclaw.git cd openclaw

启动 Docker：
```
docker-compose up -d 
```

这会以上最简方式启动 OpenClaw 的所有组件（依赖 Docker Compose）。(openclawdoc.com)

如果你想从源码构建（适合开发或贡献者）：

git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm build pnpm ui:build

然后运行引导：

openclaw onboard –install-daemon

这样会把所有服务作为守护进程安装。(docs.openclaw.ai)

🎯 基本配置

配置文件默认放在：

~/.openclaw/openclaw.json

你可以用它来设置 API Key、模型提供者（如 OpenAI/Anthropic）、消息通道白名单等：

{ “channels”: {

"telegram": { "token": "YOUR_TELEGRAM_BOT_TOKEN" }, "whatsapp": { "allowFrom": ["+"] }

}, “messages”: { … } }

🔌 启动网关与控制台

启动网关：

openclaw gateway run

之后你可以在本地访问控制面板：

http://127.0.0.1:18789/

（浏览器打开即可）(openclawdoc.com)

OpenClaw 支持以下消息通道：

平台配置方式 Telegram Bot API Token（@BotFather 获得） WhatsApp 扫描二维码连接 Discord Bot Token Mattermost Personal Token iMessage（仅 macOS）通过 imsg CLI

运行 openclaw onboard 时会一步步引导你完成这些设置。(openclawdoc.com)

❗ 没有 `openclaw` 命令

如果命令没找到，通常是：

检查：

node -v npm -v which openclaw

确保输出正常。(Reddit)

📌 安全性：OpenClaw 直接执行消息和自动化任务，如果配置不当可能会泄露隐私或执行危险代码。务必配置好访问控制。(Tom‘s Hardware)

📌 API Key：使用 OpenAI / Claude / OpenRouter 等模型时，可能需要付费 API Key。

📌 本地模型：如果不希望使用收费 API，可以搭配本地模型（如 GLM 系列通过 Ollama）运行。(Reddit)

如果你愿意，我也可以写 更详细的操作脚本（例如自动部署脚本） 或者 写入在 VPS 上运行 OpenClaw 的完整参数配置示例。需要吗？