OpenClaw（养龙虾）部署教程：一步步教你搭自己的 AI 助手

前言

在AI助手普及的当下，很多用户希望拥有完全私有、可自主控制、多平台互通的私人AI工具，OpenClaw（开源龙虾）就是满足这一需求的开源自托管AI网关。它能打通微信、Telegram、Discord等常用聊天平台，让用户在熟悉的界面调用私有AI模型，全程数据自主掌控，社区内将部署与使用OpenClaw的行为戏称为“养龙虾”。

本文基于零基础用户视角，完整梳理OpenClaw环境准备、三种安装方式、渠道对接、配置优化、启动验证及问题排查，全程步骤清晰、指令可直接复制，帮助用户快速搭建专属AI助手，避开部署常见坑点。

一、OpenClaw核心介绍

1.1 什么是OpenClaw

OpenClaw是一款开源自托管AI网关工具，核心作用是连接主流即时通讯平台与AI大模型，实现消息接收、AI处理、自动回复的全流程打通。用户无需在多个AI平台切换，可在微信、Telegram、Discord等渠道直接与私有AI交互，兼顾便捷性与数据隐私。

1.2 OpenClaw的核心优势

• 私有部署：数据存储在本地或自有服务器，不上传第三方平台，隐私安全可控。

• 多渠道兼容：支持微信、Telegram、Discord、iMessage等主流IM工具，覆盖个人与社群使用场景。

• 操作轻量化：提供图形化、命令行、Docker三种部署方式，新手也能快速上手。

• 开源免费：代码完全开源，无强制付费门槛，可根据需求自定义修改。

1.3 为什么叫“养龙虾”

OpenClaw直译是“开源的钳子”，官方Logo为红色卡通龙虾形象，社区用户将部署、配置、维护OpenClaw的过程拟人化为“养龙虾”，让技术操作更具趣味性，也形成了独特的社群文化。

二、部署前环境准备

2.1 硬件要求（必看）

OpenClaw对硬件有基础要求，配置不足会导致启动失败、运行卡顿，具体标准如下：

关键提醒：Windows用户需先开启WSL2子系统，无法直接在原生Windows环境部署。

2.2 软件依赖安装

OpenClaw基于Node.js开发，必须安装Node.js 22及以上版本，否则安装失败。

1. 检查现有Node.js版本
   打开终端执行指令：

node --version

若版本低于22，需重新安装；若未安装，按以下方式操作。

2. 安装Node.js（跨平台通用）
   推荐使用nvm安装，方便版本切换：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

3. macOS专属快捷安装
   macOS用户可通过Homebrew一键安装：

brew install node@22

安装完成后，重新执行node --version，确认显示v22.x.x即为成功。

三、OpenClaw三种部署方式（按需选择）

OpenClaw提供三种部署方案，新手优先选macOS图形化，服务器用户选Docker，跨平台通用选命令行。

3.1 方式一：macOS图形化安装（最简单）

适合macOS用户，无需复杂指令，图形化界面操作零门槛。

1. 下载安装包
   访问GitHub发布页：https://github.com/openclaw/openclaw/releases，下载`.dmg`格式安装包。

2. 常规安装
   双击dmg文件，将OpenClaw.app拖拽到应用程序文件夹，完成安装。

3. Homebrew快捷安装
   终端执行指令，自动完成安装与配置：

brew install openclaw/tap/openclaw

4. 启动验证
   安装后打开OpenClaw.app，图标会出现在电脑菜单栏，代表运行成功。

3.2 方式二：命令行安装（跨平台通用）

适合Linux、Windows WSL2、macOS全平台，是最通用的部署方式。

1. 全局安装OpenClaw CLI
   终端执行核心安装指令：

npm install -g openclaw

2. 验证安装结果

openclaw --version

显示版本号即安装成功。
3. 初始化配置
执行交互式配置命令，按终端提示完成基础设置：

openclaw setup

注意：初始化时需预留AI模型API Key、通讯渠道Token信息，提前准备可提升效率。

3.3 方式三：Docker部署（服务器专用）

适合云服务器、本地服务器部署，环境隔离、稳定性强，无需手动配置依赖。

1. 拉取官方最新镜像

docker pull openclaw/openclaw:latest

2. 创建配置存储目录

mkdir -p ~/.openclaw

3. 后台运行容器

docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest

关键参数说明：

• -p 18789:18789：映射核心端口，不可随意修改，否则渠道无法连接。

• -v：挂载配置目录，保证配置文件持久化存储。

四、OpenClaw核心配置详解

4.1 配置文件位置

部署完成后，所有核心配置存储在~/.openclaw/openclaw.json文件，可直接编辑或通过命令修改。

4.2 基础配置模板（直接复制使用）

{
 "gateway": {
  "port": 18789,
  "verbose": true
 },
 "channels": {
  "telegram": {
   "enabled": true,
   "botToken": "YOUR_BOT_TOKEN_HERE"
  },
  "discord": {
   "enabled": true,
   "botToken": "YOUR_DISCORD_BOT_TOKEN"
  }
 },
 "model": {
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "apiKey": "sk-ant-xxx..."
 }
}

重点配置项：

• gateway.port：默认18789，端口占用时可修改。

• channels：通讯渠道开关，按需启用Telegram、Discord。

• model：AI模型提供商、模型名称、API密钥，决定AI回复能力。

4.3 安全配置规范

禁止在配置文件中直接写入敏感信息（如API Key、Bot Token），推荐使用环境变量存储，避免配置文件泄露导致财产损失、数据被盗。

五、主流通讯渠道配置步骤

5.1 Telegram渠道配置

1. 创建Telegram Bot

• 打开Telegram，搜索@BotFather。

• 发送/newbot命令，按提示设置Bot名称与用户名（用户名必须以_bot结尾）。

• 复制@BotFather返回的Bot Token。

2. 绑定Token到OpenClaw
   终端执行指令：

openclaw config set channels.telegram.botToken "你的Token"

3. 启动测试
   启动网关后，在Telegram搜索Bot用户名，发送/start完成配对，即可发送消息测试。

5.2 Discord渠道配置

1. 创建Discord应用
   访问Discord开发者平台：https://discord.com/developers/applications，点击`New Application`创建应用。

2. 创建Bot并获取Token

• 进入Bot页面，点击Add Bot。

• 开启Message Content Intent权限，复制Bot Token。

3. 邀请Bot到服务器

• 进入OAuth2→URL Generator，勾选bot权限。

• 复制生成的URL，在浏览器打开，选择目标服务器完成邀请。

4. 绑定配置
   将Bot Token填入OpenClaw配置文件，启用Discord渠道即可。

六、启动与验证流程

6.1 启动OpenClaw网关

1. 前台启动（查看实时日志，适合调试）

openclaw gateway --verbose

2. 后台启动（适合长期运行）

openclaw gateway &

6.2 服务状态验证

1. 指令验证

openclaw health

返回healthy代表服务正常。

2. 控制台验证
   浏览器访问：http://127.0.0.1:18789，打开管理控制台，可查看连接状态、消息日志。

6.3 运行逻辑说明

用户发送消息→通讯渠道接收→OpenClaw网关转发→AI模型处理→返回结果至渠道，全程闭环运行。

七、常见问题排查（部署必看）

7.1 端口18789被占用

报错信息：Port 18789 already in use
解决方法：

1. 查看端口占用进程

lsof -i :18789

2. 关闭占用进程，或更换端口启动

openclaw gateway --port 18790

7.2 Telegram Bot无响应

1. 核对Bot Token是否正确，无多余空格。

2. 先给Bot发送/start完成配对。

3. 前台启动查看日志：openclaw gateway --verbose。

7.3 Discord提示权限不足

1. 确认Bot已加入目标服务器。

2. 开发者平台开启Message Content Intent。

3. 重新生成邀请链接，赋予完整Bot权限。

7.4 Node.js版本过低

安装失败提示版本不兼容，重新安装Node.js 22+版本，执行nvm use 22切换版本。

八、部署与使用注意事项

1. 网络安全：公网部署必须设置访问密码，防止未授权访问。

2. 费用控制：AI模型调用消耗Token，关注用量避免超额扣费。

3. 隐私保护：不向公共平台上传配置文件，不输入个人敏感信息。

4. 版本更新：关注GitHub发布页，及时更新安全补丁。

5. 数据备份：定期备份~/.openclaw目录，防止配置丢失。

结语

OpenClaw作为轻量化私有AI网关，降低了私人AI助手的部署门槛，无论是个人日常使用，还是小型社群服务，都能快速适配。按照本文步骤操作，即可完成从环境准备到渠道对接的全流程部署，拥有属于自己的“赛博龙虾”。

部署过程中遇到问题，可参考官方文档（https://docs.openclaw.ai）或GitHub社区（https://github.com/openclaw/openclaw），获取技术支持。