龙虾OpenClaw全平台部署指南

写在前面

OpenClaw（俗称“龙虾”）是一个开源的AI智能体框架，与Hermes类似但更轻量，主打多平台消息聚合和插件化扩展。你可以把它理解成一个“万能消息中转站”——接入微信、Telegram、Discord后，AI可以在这些平台间自由对话，执行任务。

本文目标：无论你用Windows、Mac还是云服务器，跟着操作就能跑起OpenClaw。

一、部署前准备

1.1 支持的系统

系统                   支持度                 说明

Ubuntu 20.04+      ✅完美            推荐服务器部署

macOS 11+           ✅完美             Intel / M1/M2均可

Windows 10/11    ⚠️ 需WSL2      不支持原生Windows

树莓派4+               ✅ 可用            ARM64架构

1.2 硬件要求

· 最低：1核CPU + 1GB内存 + 5GB硬盘

· 推荐：2核CPU + 2GB内存 + 10GB硬盘

💡 龙虾比Hermes轻量很多，1GB内存的廉价云服务器也能跑。

1.3 你需要准备

· 一台电脑或服务器

· 大模型API Key（OpenAI/Anthropic/国内模型均可）

· （可选）各平台的Bot Token（Telegram/微信/钉钉等）

二、安装部署（四选一）

方式一：一键脚本（最推荐，Mac/Linux/服务器）

打开终端，复制粘贴：

bash

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash

国内用户用镜像：

bash

curl -fsSL https://gitee.com/openclaw/openclaw/raw/main/install.sh | bash

安装完成后：

bash

source ~/.bashrc

openclaw –version

看到版本号（如 v0.5.2）即成功。

如果提示找不到命令：

bash

export PATH=“$HOME/.openclaw/bin:$PATH“

echo ‘export PATH=“$HOME/.openclaw/bin:$PATH”‘ >> ~/.bashrc

方式二：Windows WSL2（Win用户必看）

第1步：以管理员身份打开PowerShell，安装WSL2

powershell

wsl –install

重启电脑。

第2步：打开Ubuntu，设置用户名密码

第3步：执行一键脚本

在Ubuntu终端中运行上面的一键安装命令。

⚠️ 常见坑：WSL2网络慢 → 编辑 /etc/resolv.conf，添加 nameserver 114.114.114.114

方式三：Docker（环境隔离）

bash

# 拉取镜像

docker pull openclaw/openclaw:latest

# 创建配置目录

mkdir -p ~/.openclaw

# 运行容器

docker run -d \

  –name openclaw \

  –restart always \

  -v ~/.openclaw:/root/.openclaw \

  -p 8080:8080 \

  openclaw/openclaw:latest

方式四：源码安装（开发/定制用）

bash

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

cd openclaw

python -m venv venv

source venv/bin/activate  # Windows用 venv\Scripts\activate

pip install -e .

openclaw –version

三、配置大模型（核心步骤）

3.1 获取API Key（三选一）

方案A：OpenRouter（推荐）

1. 访问 https://openrouter.ai/ 注册

2. Dashboard → API Keys → Create Key

3. 复制以 sk-or-v1- 开头的密钥

方案B：OpenAI（能力最强）

1. https://platform.openai.com/api-keys

2. 创建密钥，复制 sk- 开头的内容

方案C：国内模型（阿里百炼/DeepSeek等）

阿里百炼示例：

· 访问 

https://bailian.console.aliyun.com/

· 开通服务 → 创建API Key

3.2 配置OpenClaw

运行配置向导：

bash

openclaw config init

按提示选择：

text

? 选择LLM提供商: OpenRouter

? 输入API Key: [粘贴你的密钥]

? 默认模型: openrouter/auto

? 保存配置: Yes

测试：

bash

openclaw –message “你好，请介绍自己”

看到回复即成功。

3.3 常见配置错误

错误1：Connection timeout

解决：检查网络 + 设置代理（如果需要）

bash

export HTTP_PROXY=http://127.0.0.1:7890

export HTTPS_PROXY=http://127.0.0.1:7890

错误2：Invalid API key

解决：重新复制粘贴，注意不要带多余空格或换行。

四、接入平台（让AI动起来）

4.1 接入Telegram（推荐，最简单）

第1步：创建Bot，获取Token

· Telegram搜 @BotFather

· 发 /newbot → 取名 → 取用户名（以bot结尾）

· 复制返回的Token（格式：123456:ABC-DEF）

第2步：获取你的用户ID

· Telegram搜 @userinfobot

· 发 /start → 复制数字ID

第3步：配置并启动

bash

openclaw gateway add telegram

# 粘贴Token和用户ID

openclaw gateway start

去Telegram找你的机器人发 hello，有回复即成功。

4.2 接入微信（个人号/企业微信）

⚠️ 微信个人号接入较复杂，推荐使用企业微信。

企业微信方式：

1. 注册企业微信（免费）

2. 创建应用 → 获取 CorpID、AgentID、Secret

3. 配置：

bash

openclaw gateway add wework

# 按提示输入上述三个值

个人微信方式（需谨慎）：

使用 openclaw gateway add wechat，需要扫码登录，但微信官方禁止机器人，账号有风险。

4.3 接入Discord

1. 登录 

https://discord.com/developers/applications

2. New Application → Bot → Reset Token

3. 复制Token，配置：

bash

openclaw gateway add discord

五、后台运行（7×24小时）

5.1 Systemd服务（Linux服务器）

自动安装服务：

bash

openclaw service install

sudo systemctl enable openclaw –now

查看状态：

bash

sudo systemctl status openclaw

查看日志：

bash

sudo journalctl -u openclaw -f

5.2 Docker运行（已自动后台）

Docker方式本身就支持 –restart always，重启服务器会自动启动。

5.3 前台运行（临时测试）

bash

openclaw gateway start

按 Ctrl+C 停止。

六、常用命令速查

操作                         命令

进入对话              openclaw chat

发一条消息          openclaw –message “xxx”

列出已接入平台   openclaw gateway list

添加平台             openclaw gateway add <platform>

移除平台         openclaw gateway remove <platform>

查看配置             openclaw config show

修改配置             openclaw config set <key> <value>

安装插件             openclaw plugin install <name>

列出插件             openclaw plugin list

七、踩坑大全

🔴 安装问题

问题1：curl: command not found

解决：

bash

# Ubuntu/Debian

sudo apt install curl -y

# macOS

brew install curl

# 然后重新运行安装命令

问题2：Python版本过低（需要3.10+）

检查版本：

bash

python3 –version

如果低于3.10：

bash

# Ubuntu 20.04

sudo add-apt-repository ppa:deadsnakes/ppa

sudo apt update

sudo apt install python3.10 python3.10-venv

# macOS

brew install python@3.10

问题3：WSL2里安装后无法运行

解决：确保WSL2用的是Ubuntu 22.04或更新版本。

bash

wsl –list –verbose

# 如果版本是1，升级到2

wsl —set-version Ubuntu 2

🔴 配置问题

问题4：openclaw config init 提示权限被拒

解决：

bash

chmod 755 ~/.openclaw

openclaw config init

问题5：API调用返回429错误

原因：请求太频繁，触发限流。

解决：等待30秒重试，或升级付费套餐。

问题6：本地测试正常，但网关启动后没反应

检查端口冲突：

bash

# 查看8080端口是否被占用

lsof -i :8080   # Mac/Linux

netstat -ano | findstr :8080   # Windows

# 更换端口

openclaw config set gateway.port 8081

🔴 平台接入问题

问题7：Telegram机器人收不到消息

排查步骤：

bash

# 1. 检查Token

curl “https://api.telegram.org/bot你的Token/getMe”

# 2. 检查网关日志

openclaw gateway logs —tail 50

# 3. 检查防火墙

sudo ufw allow 8080   # 如果用了webhook

问题8：企业微信收不到消息

原因：需要配置可信任IP。

解决：

· 登录企业微信管理后台

· 应用管理 → 自建应用 → 企业可信IP

· 添加你服务器的公网IP

问题9：Docker容器内无法连接宿主机服务

解决：使用 host.docker.internal 代替 localhost：

bash

openclaw config set model.base_url http://host.docker.internal:11434

🔴 性能问题

问题10：内存占用过高被杀

1GB内存小机器解决方法：

bash

# 限制并发数

openclaw config set worker.max_concurrent 2

# 限制历史消息长度

openclaw config set chat.max_history 10

# 启用swap（如果还没开）

sudo fallocate -l 2G /swapfile

sudo chmod 600 /swapfile

sudo mkswap /swapfile

sudo swapon /swapfile

八、进阶玩法

8.1 安装插件

查看可用插件：

bash

openclaw plugin search

安装天气插件：

bash

openclaw plugin install weather

8.2 多平台联动

配置后，Telegram上发消息，微信能收到回复（需两个平台都接入）：

bash

openclaw config set bridge.enabled true

openclaw config set bridge.source telegram

openclaw config set bridge.target wework

8.3 自定义指令

编辑 

~/.openclaw/custom_commands.yaml：

yaml

commands:

  – name: “天气”

    pattern: “.*天气.*”

    action: “weather”

  – name: “日报”

    pattern: “.*今天日报.*”

    action: “report daily”

重启网关生效。

九、总结

恭喜！你现在拥有了自己的“龙虾”OpenClaw：

✅ 全平台安装成功

（Win/Mac/Linux/Docker）

✅ 大模型API已配置，能对话

✅ 接入了Telegram/微信，手机可控制

✅ 后台服务7×24小时运行

日常维护：

· 每周运行 openclaw update 更新到最新版

· 日志太大时清理：openclaw logs –clear

· 遇到问题先跑 openclaw doctor 自检

更多资源：

· 官方文档：https://docs.openclaw.ai

· GitHub：https://github.com/openclaw/openclaw

· 社区讨论：Telegram群 @openclaw_cn

祝你玩得开心！