什么是 OpenClaw
OpenClaw 是一个开源、可自托管的 AI Agent 网关。你可以通过 Telegram、Discord、飞书、钉钉、微信等聊天平台直接给 AI 分配任务——它能执行代码、检索信息、控制浏览器、运行自动化工作流。
典型使用场景
- 在 Telegram 中让 AI 帮你修项目 Bug
- 上传数据文件，自动生成分析报告
- 浏览器自动化：查询网页、截图、爬取数据
- 定时信息抓取和群通知
- 跨平台内容发布与监控
与普通聊天 AI 的区别
| 能力 | OpenClaw | 普通聊天 AI |
|---|---|---|
| 多渠道接入 | ✅ 支持主流平台 | ❌ 有限 |
| 自托管 | ✅ 数据在你手里 | ❌ 通常不行 |
| 长期运行自动化 | ✅ 后台常驻 | ❌ 弱 |
| 文件 / 代码操作 | ✅ 完整文件系统 | ❌ 有限 |
| 浏览器控制 | ✅ Playwright 驱动 | ❌ |
| 技能扩展 | ✅ 数千个 Skill 插件 | ❌ |
核心架构
OpenClaw 的架构非常简洁：
聊天平台 → Gateway（网关） → Agent（智能体） → LLM APIGateway · 网关
统一的通道连接层，负责消息路由、会话管理、任务分发。所有聊天平台的消息都先经过 Gateway。
Agent · 智能体
执行具体任务的 AI 实体。能读写文件、执行命令、调用工具、控制浏览器。由 LLM 驱动决策。
Skill · 技能
能力扩展模块。可以按业务场景自由组合，比如代码审查、数据分析、网页爬取等。
安装部署
OpenClaw 支持多种安装方式，推荐使用一键安装脚本。
一键安装脚本（推荐）
curl -fsSL https://openclaw.ai/install.sh | bashiwr -useb https://openclaw.ai/install.ps1 | iex手动 npm 安装
# 确保 Node.js 22+
node --version
# 全局安装
npm install -g openclaw@latest
# 运行初始化向导
openclaw onboard --install-daemonDocker 部署
docker pull openclaw/openclaw:latest
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
-e ANTHROPIC_API_KEY=sk-ant-xxx \
openclaw/openclaw:latest验证安装
openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboardopenclaw doctor 全部显示绿色 ✓，说明安装成功。然后执行 openclaw dashboard 打开控制面板。快速上手
安装完成后，按以下步骤配置你的第一个 AI 助手：
配置 AI 模型密钥
在控制面板 → Settings → AI Provider 中，填入你的 API Key（支持 Anthropic Claude、OpenAI、DeepSeek 等）。
接入聊天平台
在控制面板 → Channels 中添加 Telegram / Discord / 飞书等，按引导获取 Bot Token 完成连接。
安装技能插件
在控制面板 → Skills 中搜索安装你需要的技能，比如代码审查、天气查询、网页爬取等。
开始对话！
在你接入的聊天平台中给 Bot 发消息，AI 就会开始执行任务了 🎉
云服务器部署
将 OpenClaw 部署到云服务器，可以实现 24/7 在线，不依赖本地电脑。腾讯云和阿里云都提供了应用镜像一键部署。
选购指南
| 配置 | 腾讯云（月费参考） | 阿里云（月费参考） |
|---|---|---|
| 2核 2G 3M | ~30 元 | ~35 元 |
| 2核 4G 5M | ~50 元 | ~60 元 |
| 4核 8G 6M | ~100 元 | ~120 元 |
腾讯云 Lighthouse 部署
腾讯云轻量应用服务器（Lighthouse）提供了 OpenClaw 官方应用镜像，是最简单的部署方式，零代码，5 分钟完成。
购买服务器
前往腾讯云轻量应用服务器控制台，选购时注意：
· 镜像类型选择「应用镜像」→ 搜索 OpenClaw
· 规格建议 2 核 4G 或更高
· 时长按需选择 1-12 个月
放行防火墙端口
进入实例 → 左侧「防火墙」→ 添加规则：
· 协议：TCP
· 端口：18789
· 来源：0.0.0.0/0（或限制你的 IP 段）
获取访问凭证
通过 WebShell 或 SSH 连接服务器，执行命令查看 Gateway Token：
cat ~/.clawdbot/.env | grep CLAWDBOT_GATEWAY_TOKEN
# 输出示例: CLAWDBOT_GATEWAY_TOKEN=oc_xxxxxxxxxxxx访问控制面板
浏览器打开 http://你的公网IP:18789，输入 Gateway Token 认证，即可进入控制面板开始配置。
阿里云百炼部署
阿里云轻量应用服务器同样支持 OpenClaw 一键部署，并深度集成了阿里云百炼大模型服务（通义千问、Kimi、MiniMax 等国产模型）。
购买服务器
前往阿里云轻量应用服务器：
· 镜像选择「OpenClaw 镜像」
· 内存必须 ≥ 2GiB
· 如需完整联网搜索功能，建议选海外地域
配置百炼 API Key
前往阿里云百炼大模型控制台 →「系统管理」→「API Key 管理」创建密钥。然后在实例「应用详情」页点击「配置百炼 API-Key」执行命令并输入密钥。
选择计费方案
方案 A：Coding Plan 套餐（推荐）
固定月费模式，成本可控，包含月度请求额度。
支持模型：qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5 等。
方案 B：按 Token 用量计费
按实际调用量付费，适合使用量不固定的场景。
完成初始化
在「应用详情」页依次执行：
· 点击「执行命令」开放防火墙
· 配置 OpenClaw：生成访问 Token
· 点击「打开网站页面」进入控制台
Docker 手动部署
适用于已有云服务器或需要更灵活配置的场景。
环境准备
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装必要工具
sudo apt install -y curl git wget
# 安装 Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 验证
node --version # 应显示 v22.x.x安装并启动
# 官方安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 初始化向导
openclaw onboard --install-daemon
# 后台常驻（推荐 pm2）
sudo npm install -g pm2
pm2 start "openclaw gateway --host 0.0.0.0 --port 18789" --name openclaw
pm2 save
pm2 startupDocker Compose 方式
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh
# 该脚本会自动：构建镜像 → 运行初始化 → 生成 Token → 启动 Compose 服务接入消息平台
OpenClaw 支持接入多种主流聊天平台，在控制面板 → Channels 中添加。
| 平台 | 配置方式 | 备注 |
|---|---|---|
| Telegram | 与 @BotFather 创建 Bot，填入 Token | 最简单，推荐新手 |
| Discord | Discord Developer Portal 创建应用，获取 Bot Token | 社区首选 |
| 飞书 | 飞书开放平台创建应用，配置 Webhook | 企业协作 |
| 钉钉 | 钉钉开放平台创建企业自建应用 + AppFlow | 阿里云方案推荐 |
| 通过 WhatsApp Business API 接入 | 需海外服务器 |
配置 AI 模型
OpenClaw 支持多种 AI 模型，在控制面板 → Settings → AI Provider 中配置。
| 模型 | 获取方式 | 特点 |
|---|---|---|
| Anthropic Claude | console.anthropic.com 创建 API Key | 能力最强，推荐 Claude Sonnet 4 |
| OpenAI GPT-4o | platform.openai.com 创建 API Key | 生态成熟，工具兼容性好 |
| DeepSeek | platform.deepseek.com 获取 Key | 国产替代，性价比高 |
| 阿里百炼 | 百炼控制台获取 API Key | 集成通义千问/Kimi 等国产模型 |
| 本地模型 | 通过 Ollama / vLLM 本地部署 | 完全离线，数据不出服务器 |
安全加固
生产环境部署时，建议做以下安全配置：
1. 修改默认端口
nano ~/.clawdbot/.env
# 修改端口
CLAWDBOT_PORT=198762. Nginx 反向代理 + SSL
server {
listen 443 ssl http2;
server_name your-domain.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://localhost:18789;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
}3. 定期备份
· 腾讯云：控制台「快照」功能设置自动快照策略
· 阿里云：使用「快照」或「镜像」功能备份
常见问题
Q: 无法访问 18789 端口？
- 检查防火墙/安全组是否放行该端口
- 确认服务已启动：
pm2 status或docker ps - 检查服务器内部：
curl http://localhost:18789
Q: API Key 配置后无响应？
- 确认 API Key 已充值或绑定支付方式
- 检查 Key 的权限范围是否足够
- 查看日志：
pm2 logs openclaw或docker logs openclaw-gateway
Q: 连接消息平台失败？
- 确认 Bot Token 正确且 Bot 已启用
- 检查服务器是否能访问 Telegram/Discord（海外服务器更稳定）
Q: 命令找不到 openclaw？
# 找到 npm 全局目录
npm prefix -g
# 临时修复
export PATH="$(npm prefix -g)/bin:$PATH"
# 永久修复（zsh）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrcQ: Node.js 版本太低？
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 安装 Node 22
nvm install 22
nvm use 22
nvm alias default 22