OpenClaw 部署教程：从零跑起你的"龙虾"助手 🦞

OpenClaw 是一个开源、运行在你自己机器上的个人 AI 助手，通过本地 Gateway 把大模型、工具、聊天渠道（WhatsApp / Telegram / Discord 等）串起来。本文覆盖本地原生部署和 Docker 部署两条路径，以及 Telegram 渠道接入和常见坑。

💡 部署完之后，Gateway 默认监听 18789 端口，Control UI 在此基础上提供网页聊天入口。

一、环境准备

验证 Node 版本：

node --version

版本不够的话，用 nvm 装一下：

nvm install 24
nvm use 24

二、本地原生部署（推荐新手）

1. 一键安装

macOS / Linux：

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

Windows（PowerShell 管理员）：

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

脚本会自动装好 Node.js 运行时和 openclaw 命令。

如果你已经自己管 Node.js，也可以直接用 npm 装：

npm install -g openclaw@latest --allow-scripts=openclaw

2. 运行新手引导

openclaw onboard --install-daemon

向导会带你走完：

• 🔐 选择模型提供商、填入 API Key
• 🌐 配置 Gateway（默认端口 18789）
• 📱 可选：连接 Telegram / WhatsApp 等渠道
• 🔧 可选：安装 Skills 和插件

⚠️ 完整引导可能因"提供商登录、渠道配对、守护进程安装、网络下载、Skills 或可选插件"步骤而耗时较久。可先跳过可选步骤，后面用 openclaw configure 回来补。

3. 验证部署

openclaw gateway status

应输出 Gateway 正在监听 18789。然后打开仪表板：

openclaw dashboard

浏览器会自动打开 Control UI，发一条消息，能收到 AI 回复就说明成了 ✅。

三、Docker 部署（推荐服务器 / NAS / VPS）

1. 用 Docker Compose 起服务

docker-compose.yml：

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ~/.openclaw:/root/.openclaw
      - ./workspace:/root/workspace
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_KEY}
      - TZ=Asia/Shanghai
    healthcheck:
      test: ["CMD", "openclaw", "status"]
      interval: 30s
      timeout: 10s
      retries: 3

同目录下创建 .env 文件：

ANTHROPIC_API_KEY=sk-ant-xxxxx
OPENAI_API_KEY=sk-xxxxx

启动：

docker-compose up -d
docker-compose logs -f

2. 在容器内跑引导

docker compose exec openclaw openclaw onboard --flow quickstart

3. 常用运维命令

docker-compose restart   # 重启
docker-compose down      # 停止
docker-compose pull && docker-compose up -d   # 升级到最新版

📌 数据持久化：~/.openclaw 存配置、凭证、会话；./workspace 存工作文件。这两个卷挂上，重启就不会丢数据。

四、接入 Telegram 渠道（最快让手机能用）

1. 在 Telegram 找 @BotFather，发 /newbot，拿到 Bot Token
2. 找 @getidsbot​ 拿到你的 Telegram ID
3. 编辑 ~/.openclaw/openclaw.yaml（或 openclaw.json）：

channels:
  telegram:
    enabled: true
    token: "YOUR_TELEGRAM_BOT_TOKEN"
    allowedUsers:
      - "YOUR_TELEGRAM_ID"

1. 重启 Gateway：

openclaw gateway restart
# 或 Docker 环境：
docker-compose restart

给机器人发 /start，能对话就说明渠道通了 ✅。

五、VPS 部署的安全建议

如果你把 OpenClaw 跑在云服务器上：

⚠️ 不要把 Gateway 裸奔到公网。默认配置下 Gateway 监听 127.0.0.1:18789，如需远程访问请用 SSH 隧道：

ssh -N -L 18789:127.0.0.1:18789 user@your-vps-ip

然后在本地浏览器打开 http://localhost:18789。

或者用反向代理（Nginx + HTTPS + 访问令牌）兜底。DM 渠道默认会把未知发送者配对，需用 openclaw pairing approve 显式批准。

六、常见故障排查

Gateway 起不来 / 容器不断重启

docker-compose logs openclaw

绝大多数情况是 API Key 没配或 openclaw.yaml 格式错。

本地装完 openclaw 命令找不到

可能是 npm 全局路径没进 PATH。重开终端，或：

npm i -g openclaw
which openclaw

Windows 报执行策略错误

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

再跑安装脚本。

Telegram 机器人没反应

openclaw doctor

如果提示 Gateway 没装，执行：

openclaw gateway install
openclaw gateway start

端口被占用

改 docker-compose.yml 里的 18789:18789 为 18000:18789 等，或停掉占用端口的服务。

七、从源码跑（开发者向）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
corepack enable
pnpm install
pnpm build
pnpm ui:build
pnpm openclaw onboard --install-daemon

📌 仓库是 pnpm workspace，不能在根目录用 plain npm install。

结语

部署到这里，你已经拥有一只跑在自己机器上的龙虾了 🦞。下一步可以玩 Skills 市场（ClawHub）、配置飞书/Discord 渠道、或者给它接本地模型（Ollama 等）。官方文档入口：https://documentation.openclaw.ai。