用 iVPSer 服务器搭建 OpenClaw：绑定微信、飞书和 QQ 的完整教程

2026-05-30 · Linux教程、建站

OpenClaw 是一个自托管的 AI 智能体网关。它的核心思路很简单：把 OpenClaw Gateway 部署在自己的服务器上，再把微信、飞书、QQ、Telegram、WhatsApp 等聊天工具接进来。之后你只需要在手机上发消息，就可以让它整理资料、运行脚本、调用工具、处理文件或接入不同的大模型。

把 OpenClaw 放在 iVPSer 服务器上运行，有几个好处：

7x24 小时在线，不依赖家里电脑是否开机；
国内访问服务器和聊天平台更稳定，适合微信、飞书、QQ 这类国内常用入口；
配置、聊天状态和工作目录都在自己的 VPS 上，便于备份和迁移；
可以通过 SSH 隧道或内网工具访问控制台，避免把管理端口直接暴露到公网。

如果你还没有服务器，可以通过 iVPSer 自助开通平台开通一台 Ubuntu 24.04 或 Debian 12 服务器。建议至少选择 2GB 内存配置；如果后续要启用 Docker 沙箱、浏览器自动化或多用户机器人，建议 4GB 内存起步。

一、准备服务器

本文以 Ubuntu 24.04 / Debian 12 为例。先用 SSH 登录服务器：

ssh root@你的服务器IP

更新系统并安装常用工具：

apt update && apt upgrade -y
apt install -y curl git jq unzip ca-certificates ufw

设置时区：

timedatectl set-timezone Asia/Shanghai

为了避免长期使用 root 运行服务，创建一个普通用户：

adduser openclaw
usermod -aG sudo openclaw

切换到新用户：

su - openclaw

后续命令建议在 openclaw 用户自己的 SSH 会话中执行。su - openclaw 适合临时测试，但 systemd 用户服务在真实登录会话中更稳定。

二、安装 OpenClaw

OpenClaw 官方推荐 Node 24，也支持 Node 22.19+。最省事的方式是使用官方安装脚本，它会自动处理 Node 环境、安装 CLI，并启动引导流程：

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

如果你想先安装命令行，不立即进入交互式引导：

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

安装完成后确认命令可用：

openclaw --version
openclaw doctor

如果提示 openclaw: command not found，检查全局 npm bin 路径是否在 PATH 中：

npm prefix -g
echo "$PATH"

必要时把下面这行加入 ~/.bashrc：

export PATH="$(npm prefix -g)/bin:$PATH"

然后重新登录 SSH。

三、完成初始化引导

运行引导程序：

openclaw onboard --install-daemon

引导过程中一般会让你选择模型供应商和认证方式。常见选择：

OpenAI API Key：适合已有 OpenAI Platform API Key 的用户；
Anthropic API Key：适合使用 Claude API 的用户；
OpenAI Codex / Claude CLI / Qwen 等订阅或本地认证方式：适合已经在本机或服务器完成对应登录的用户；
Ollama / LM Studio：适合本地模型，但 VPS 上通常要额外考虑显存、内存和模型下载。

完成后检查网关状态：

openclaw gateway status
openclaw models list

如果模型列表正常，说明 OpenClaw 已经可以调用模型。

四、让 Gateway 稳定后台运行

openclaw onboard --install-daemon 在 Linux 上会安装 systemd 用户服务。查看状态：

systemctl --user status openclaw-gateway.service

启动、重启和查看日志：

systemctl --user start openclaw-gateway.service
systemctl --user restart openclaw-gateway.service
openclaw logs --follow

如果你发现 SSH 断开后服务也停止，可以让该用户的 systemd 服务在退出登录后继续运行：

sudo loginctl enable-linger openclaw

小内存 VPS 可以加两个启动优化环境变量：

mkdir -p /var/tmp/openclaw-compile-cache
systemctl --user edit openclaw-gateway.service

填入：

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

保存后执行：

systemctl --user daemon-reload
systemctl --user restart openclaw-gateway.service

五、安全访问控制台

OpenClaw 控制台默认在本机 127.0.0.1:18789。不要直接把 18789 端口开放到公网，推荐使用 SSH 隧道访问。

在你的电脑本地执行：

ssh -L 18789:127.0.0.1:18789 openclaw@你的服务器IP

然后在浏览器打开：

http://127.0.0.1:18789/

服务器防火墙只需要放行 SSH，除非你还在服务器上部署网站或 API：

sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow OpenSSH
sudo ufw enable
sudo ufw status verbose

如果你确实需要把控制台开放给远程团队使用，请至少设置 gateway.auth.token 或 gateway.auth.password，并放在反向代理、HTTPS 和访问控制之后，不要裸奔。

六、绑定微信

OpenClaw 通过外部插件 @tencent-weixin/openclaw-weixin 接入微信。当前插件主要适合个人私聊场景，官方能力说明是支持私聊和媒体，不声明支持微信群聊。

安装微信插件：

npx -y @tencent-weixin/openclaw-weixin-cli install

或者手动安装：

openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart

在运行 Gateway 的同一台服务器上发起二维码登录：

openclaw channels login --channel openclaw-weixin

用手机微信扫码并确认。登录成功后，账号令牌会保存在服务器本地状态目录中。

第一次有人给机器人发私信时，建议使用配对流程批准，避免任何人都能调用你的 AI：

openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>

如果你要绑定多个微信账号，建议把私聊会话按账号、渠道和发送者隔离：

openclaw config set session.dmScope per-account-channel-peer
openclaw gateway restart

常用排查命令：

openclaw plugins list
openclaw channels status --probe
openclaw logs --follow

如果启用微信后 Gateway 反复重启，先升级 OpenClaw 和插件：

openclaw update
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart

七、绑定飞书

飞书是国内团队场景里更推荐的 OpenClaw 入口。它支持机器人私信和群聊，默认使用 WebSocket 长连接，不一定需要你额外配置公网回调地址。官方当前要求 OpenClaw 2026.5.29 或更高版本：

openclaw --version
openclaw update

运行飞书频道设置向导：

openclaw channels login --channel feishu

向导一般会提供两种方式：

二维码方式：适合快速创建机器人；
手动方式：在飞书开放平台创建自建应用，复制 App ID 和 App Secret 到向导中。

如果国内版飞书 App 扫二维码没有反应，重新运行向导并选择手动方式。

完成后重启 Gateway：

openclaw gateway restart

1. 私聊访问控制

飞书私聊可以使用 dmPolicy 控制访问：

openclaw config set channels.feishu.dmPolicy pairing
openclaw gateway restart

用户第一次私信机器人后，在服务器上查看并批准：

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

如果只允许指定用户，可以使用 allowlist。先让用户给机器人发一条私信，然后查看日志里的 open_id：

openclaw logs --follow

再配置允许名单：

openclaw config set channels.feishu.dmPolicy allowlist
openclaw config set channels.feishu.allowFrom '["ou_xxx"]' --strict-json
openclaw gateway restart

2. 飞书群聊配置

飞书群聊默认更稳妥的方式是只响应被允许的群，并且需要 @ 机器人。

获取群 ID：在飞书群里点击右上角菜单，进入设置页面，找到 chat_id，格式通常类似 oc_xxx。

只允许一个群，并要求 @ 机器人：

openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.groupAllowFrom '["oc_xxx"]' --strict-json
openclaw config set channels.feishu.requireMention true
openclaw gateway restart

如果是内部测试群，想让机器人不需要 @ 就回复：

openclaw config set channels.feishu.groups.oc_xxx.requireMention false
openclaw gateway restart

不建议一上来就设置 groupPolicy: open，否则机器人可能在所有加入的群里响应消息，容易造成误触发和费用浪费。

3. 飞书常用命令

在飞书里直接发送纯文本命令：

/status
/reset
/model

飞书没有原生斜杠菜单，这些命令按普通消息发送即可。

如果机器人收不到消息，重点检查：

飞书自建应用是否已发布并通过审批；
事件订阅是否包含 im.message.receive_v1；
连接方式是否选择长连接 WebSocket；
应用权限是否完整授权；
Gateway 是否正在运行。

排查命令：

openclaw gateway status
openclaw logs --follow

八、可选：绑定 QQ Bot

如果你的用户更习惯 QQ，可以使用 OpenClaw 的 QQ Bot 插件。它通过 QQ 官方 Bot API 连接，支持私聊、群聊、频道和富媒体。

安装插件：

openclaw plugins install @openclaw/qqbot

到 QQ 开放平台创建机器人，复制 AppID 和 AppSecret，然后添加频道：

openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart

群聊里建议仍然开启 @ 触发，并限制允许的群：

openclaw config set channels.qqbot.groupPolicy allowlist
openclaw config set channels.qqbot.groups.GROUP_OPENID.requireMention true
openclaw gateway restart

QQ Bot 的用户 ID、群 OpenID 与普通 QQ 号不同，需要通过平台或机器人命令获取，不要直接把 QQ 号写进 allowlist。

九、日常维护

升级 OpenClaw：

openclaw update
openclaw gateway restart

查看渠道状态：

openclaw channels status --probe

查看日志：

openclaw logs --follow

备份配置和状态：

tar -czf openclaw-backup-$(date +%F).tar.gz ~/.openclaw ~/.config/openclaw 2>/dev/null

建议把备份下载到本地或另一台服务器，不要只放在同一块系统盘上。

十、常见问题

1. 控制台打不开

先确认 Gateway 是否运行：

openclaw gateway status

再确认 SSH 隧道是否保持连接。本地浏览器访问的是 http://127.0.0.1:18789/，不是服务器公网 IP。

2. 微信扫码后没有响应

检查插件是否安装、启用并重启：

openclaw plugins list
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart

再查看渠道状态：

openclaw channels status --probe

3. 飞书群里机器人不回复

依次检查：机器人是否已加入群、是否 @ 了机器人、groupPolicy 是否允许该群、requireMention 是否符合预期。

openclaw config get channels.feishu --json
openclaw logs --follow

4. 担心聊天入口被滥用

不要把私聊和群聊都设成完全开放。个人使用建议：

openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true
openclaw gateway restart

微信也使用配对批准：

openclaw pairing list openclaw-weixin

5. 小内存服务器响应慢

优先关闭不需要的频道，避免同时运行太多插件；再考虑升级到 4GB 内存。OpenClaw 本身只是网关，真正消耗资源的通常是浏览器自动化、媒体处理、Docker 沙箱和本地模型。

总结

如果只是个人使用，推荐配置是：

iVPSer Ubuntu 24.04 / Debian 12，2GB 内存起步；
OpenClaw Gateway 作为 systemd 用户服务常驻运行；
控制台只走 SSH 隧道，不开放公网端口；
微信用于个人私聊；
飞书用于团队群聊，开启 allowlist 和 @ 触发；
QQ Bot 作为可选入口；
定期备份 ~/.openclaw 和 ~/.config/openclaw。

这样搭建完成后，你就拥有了一个常驻在线的私人 AI 助手：手机发一条消息，OpenClaw 在你的 iVPSer 服务器上接收、路由、调用模型和工具，再把结果发回微信、飞书或 QQ。