OpenClaw（小龙虾）搭建教程（Windows / Linux 通用）

OpenClaw（俗称“小龙虾”）是一款开源 AI 智能体平台，可以接入：

QQ
微信
Telegram
飞书
钉钉
Discord

还能：

自动浏览网页
调用 AI 模型
执行脚本
文件管理
长期记忆
多 AI Agent 协作

一、最低配置要求

二、Linux 一键安装（推荐）

Ubuntu/Debian 直接执行：

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

或者：

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

安装脚本会自动：

安装 Node.js
安装 OpenClaw
初始化环境
创建运行服务

三、Windows 安装教程

方法 1：Node.js 安装（推荐）

第一步：安装 Node.js

下载：

Node.js 官网

建议：

Node.js 22+
LTS 版本

安装后测试：

node -v
npm -v

第二步：安装 OpenClaw

打开 PowerShell：

npm install -g openclaw@latest

安装完成后：

openclaw

即可启动。

四、初始化配置

首次运行：

openclaw onboard

它会自动引导你：

配置模型
配置 API
配置频道
配置权限

官方推荐使用 onboard 初始化。

五、配置 AI 模型

OpenClaw 本身不提供模型。

需要你接入：

OpenAI
Claude
Gemini
DeepSeek
Qwen
OpenRouter

OpenAI 示例

填写：

OPENAI_API_KEY=你的key
OPENAI_BASE_URL=https://api.openai.com/v1

如果是第三方中转：

OPENAI_BASE_URL=https://你的中转地址/v1

六、后台启动

Linux 推荐：

pm2 start openclaw
pm2 save
pm2 startup

安装 PM2：

npm install -g pm2

七、Docker 部署（服务器推荐）

安装 Docker

curl -fsSL https://get.docker.com | bash

拉取镜像

docker pull openclaw/openclaw:latest

运行容器

docker run -d \
--name openclaw \
-p 3000:3000 \
-v /root/openclaw:/data \
openclaw/openclaw

八、常见问题

1. 启动失败

通常是：

Node 版本太低
npm 权限问题
API Key 错误

检查：

node -v

2. 无法连接模型

检查：

API 是否可用
BaseURL 是否正确
服务器是否能访问模型接口

3. QQ / 微信无法接入

部分平台需要：

Bot 协议
Webhook
第三方桥接

OpenClaw 本体并不直接破解平台。

九、推荐搭配

很多人会搭配：

功能推荐

API 中转

OneAPI / NewAPI

反代

Nginx

面板

1Panel

守护

PM2

Docker 管理

Portainer

十、适合什么人？

OpenClaw 更适合：

AI 自动化
多平台机器人
本地 AI 助手
AI 工作流
自建 Agent
API 中转用户

尤其适合：

VPS 用户
Linux 用户
AI 开发者

十一、总结

OpenClaw（小龙虾）本质上是：

“可自托管的 AI 智能体平台”

相比普通聊天机器人，它更偏向：

自动执行任务
多平台消息接入
AI Agent
自动化工作流

目前最推荐的部署方式：