OpenClaw 部署与使用指南：从零搭建多通道 AI 网关
最近试用了 OpenClaw 这款开源的多通道 AI Agent 网关，它能把 Claude、GPT 等大模型接入到 Telegram、Slack、Discord 等即时通讯平台，实现 24 小时自动响应。本文记录从安装到上线的完整过程。
OpenClaw 是什么
OpenClaw 是一个基于 Node.js 的开源 AI Agent 框架，核心定位是多通道 AI 网关。它的主要能力包括：
- 即时通讯接入：支持 Telegram、Slack、Discord、WhatsApp 等 20+ 平台
- 自主执行：可执行终端命令、管理文件、控制浏览器（CDP）
- 可扩展技能：通过 Skill 机制安装浏览器自动化、GitHub 操作等插件
- 本地优先：Gateway 守护进程运行在本地，数据不经过第三方中转
相比传统的 Chatbot，OpenClaw 更像一个可以 7×24 小时运行的"数字员工"。
环境准备
官方推荐的环境配置：
| 项目 | 要求 |
|---|---|
| Node.js | ≥ 22.0（推荐 24） |
| 操作系统 | macOS / Linux / Windows WSL2 |
| 内存 | ≥ 2GB |
| 磁盘 | ≥ 20GB |
建议在国内环境下使用 pnpm 并切换镜像源，避免 npm 安装超时：
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com
安装与初始化
1. 全局安装
# 方式一：npm
npm install -g openclaw@latest
# 方式二：官方脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 方式三：pnpm（推荐国内用户）
pnpm add -g openclaw@latest
安装包约 200MB，解压后占用 400MB 左右。
2. 初始化配置
openclaw onboard
交互式向导会引导你完成：
- 选择默认 LLM 提供商（OpenAI / Anthropic / Google Gemini 等）
- 输入 API Key
- 配置通讯平台（Telegram Bot Token、Slack App Token 等）
- 设置 Gateway 访问密码
配置文件生成在 ~/.openclaw/openclaw.json，记得不要将含 API Key 的配置提交到 Git。
3. 安装系统守护进程（可选）
如果希望开机自启，可以在 onboard 时加上 --install-daemon：
openclaw onboard --install-daemon
macOS 会生成 launchd 服务，Linux 会生成 systemd 服务。
启动 Gateway
前台运行（调试）
openclaw gateway run
日志会直接输出到终端，适合排查问题。
后台守护进程
openclaw gateway start
默认监听端口 18789，可通过 WebSocket 与客户端通信。
查看状态
openclaw gateway status
openclaw doctor # 诊断配置问题
openclaw doctor --fix # 自动修复
打开可视化控制台
openclaw gateway dashboard
浏览器会自动打开本地控制台，可以查看已连接的平台、消息记录、运行日志等。
安装技能（Skills）
OpenClaw 的核心能力通过 Skill 扩展。常用技能：
# 浏览器自动化
openclaw skill install browser
# GitHub 操作
openclaw skill install github
# 文件系统增强
openclaw skill install fs-safe
安装后可用的能力会实时生效，无需重启 Gateway。
配置示例：接入 Telegram
以 Telegram 为例，最小化配置流程：
- 创建 Bot：在 Telegram 中找 @BotFather，创建新 Bot，拿到 Token
- 配置 Token：
openclaw config set telegram.bot_token "你的Token" - 重启 Gateway：
openclaw gateway restart - 验证：给 Bot 发一条消息，应该能收到 AI 回复
Slack / Discord 的配置逻辑类似，都是在对应平台创建 App，然后把 Token 填进配置即可。
安全注意事项
OpenClaw 的 Gateway 默认监听 127.0.0.1:18789，切勿直接暴露在公网。如果需要在远程服务器部署，建议：
- 使用 Nginx 反向代理，加 Basic Auth 或 IP 白名单
- 不要绑定 0.0.0.0，保持
127.0.0.1或配合防火墙规则 - 定期运行诊断：
openclaw doctor - API Key 用环境变量注入，不要写死在配置文件里：
export OPENAI_API_KEY="sk-xxx" openclaw gateway start
Docker 部署（生产推荐）
对于生产环境，建议用 Docker 隔离运行：
FROM node:24-alpine
RUN apk add --no-cache chromium ffmpeg git
RUN npm install -g openclaw@latest
EXPOSE 18789
CMD ["openclaw", "gateway", "run"]
构建并运行：
docker build -t openclaw-local .
docker run -d \
-p 127.0.0.1:18789:18789 \
-v ~/.openclaw:/root/.openclaw \
-e OPENAI_API_KEY=$OPENAI_API_KEY \
openclaw-local
总结
OpenClaw 的安装和配置整体比较顺畅，一条 npm install -g openclaw 就能跑起来。对于已经有 Telegram Bot 或 Slack App 开发经验的用户，接入成本很低。
目前我的使用场景主要是：把 Claude 接入到 Telegram，在手机上随时与 AI 对话，同时让它帮我执行一些简单的服务器巡检命令（通过 SSH Skill）。后续打算尝试浏览器自动化 Skill，让它帮我定时抓取一些数据。
如果你也在寻找一个能打通「大模型 + 即时通讯」的开源方案，OpenClaw 值得试试。
参考链接
- GitHub: https://github.com/openclaw/openclaw
- 官方文档: https://docs.openclaw.ai
- 中文社区文档: https://clawd.org.cn/
- NPM: https://www.npmjs.com/package/openclaw