什么是 OpenClaw

OpenClaw 是一个开源、可自托管的 AI Agent 网关。你可以通过 Telegram、Discord、飞书、钉钉、微信等聊天平台直接给 AI 分配任务——它能执行代码、检索信息、控制浏览器、运行自动化工作流。

💡

一句话概括：OpenClaw = 你的专属 AI 管家，24 小时在线，能动手不动嘴。

典型使用场景

在 Telegram 中让 AI 帮你修项目 Bug
上传数据文件，自动生成分析报告
浏览器自动化：查询网页、截图、爬取数据
定时信息抓取和群通知
跨平台内容发布与监控

与普通聊天 AI 的区别

能力	OpenClaw	普通聊天 AI
多渠道接入	✅ 支持主流平台	❌ 有限
自托管	✅ 数据在你手里	❌ 通常不行
长期运行自动化	✅ 后台常驻	❌ 弱
文件 / 代码操作	✅ 完整文件系统	❌ 有限
浏览器控制	✅ Playwright 驱动	❌
技能扩展	✅ 数千个 Skill 插件	❌

核心架构

OpenClaw 的架构非常简洁：

📡 数据流

聊天平台  →  Gateway（网关）  →  Agent（智能体）  →  LLM API

G

Gateway · 网关

统一的通道连接层，负责消息路由、会话管理、任务分发。所有聊天平台的消息都先经过 Gateway。

A

Agent · 智能体

执行具体任务的 AI 实体。能读写文件、执行命令、调用工具、控制浏览器。由 LLM 驱动决策。

S

Skill · 技能

能力扩展模块。可以按业务场景自由组合，比如代码审查、数据分析、网页爬取等。

安装部署

OpenClaw 支持多种安装方式，推荐使用一键安装脚本。

一键安装脚本（推荐）

🍎 macOS / Linux

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

🪟 Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

手动 npm 安装

📦 npm

# 确保 Node.js 22+
node --version

# 全局安装
npm install -g openclaw@latest

# 运行初始化向导
openclaw onboard --install-daemon

Docker 部署

🐳 Docker

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 dashboard

ℹ️

如果 openclaw doctor 全部显示绿色 ✓，说明安装成功。然后执行 openclaw dashboard 打开控制面板。

快速上手

安装完成后，按以下步骤配置你的第一个 AI 助手：

1

配置 AI 模型密钥

在控制面板 → Settings → AI Provider 中，填入你的 API Key（支持 Anthropic Claude、OpenAI、DeepSeek 等）。

2

接入聊天平台

在控制面板 → Channels 中添加 Telegram / Discord / 飞书等，按引导获取 Bot Token 完成连接。

3

安装技能插件

在控制面板 → Skills 中搜索安装你需要的技能，比如代码审查、天气查询、网页爬取等。

4

开始对话！

在你接入的聊天平台中给 Bot 发消息，AI 就会开始执行任务了 🎉

云服务器部署

将 OpenClaw 部署到云服务器，可以实现 24/7 在线，不依赖本地电脑。腾讯云和阿里云都提供了应用镜像一键部署。

⚠️

服务器配置建议：最低 2 核 2G 内存 + 20G SSD，推荐 2 核 4G + 40G SSD。系统推荐 Ubuntu 22.04。

选购指南

配置	腾讯云（月费参考）	阿里云（月费参考）
2核 2G 3M	~30 元	~35 元
2核 4G 5M	~50 元	~60 元
4核 8G 6M	~100 元	~120 元

💡

地域选择：国内用户选广州/上海/北京节点（延迟低）；需要使用 Claude/GPT-4 等海外 API 建议选海外节点（香港/新加坡），确保服务器能访问国际网络。

腾讯云 Lighthouse 部署

腾讯云轻量应用服务器（Lighthouse）提供了 OpenClaw 官方应用镜像，是最简单的部署方式，零代码，5 分钟完成。

1

购买服务器

前往腾讯云轻量应用服务器控制台，选购时注意：
· 镜像类型选择「应用镜像」→ 搜索 OpenClaw
· 规格建议 2 核 4G 或更高
· 时长按需选择 1-12 个月

2

放行防火墙端口

进入实例 → 左侧「防火墙」→ 添加规则：
· 协议：TCP
· 端口：18789
· 来源：0.0.0.0/0（或限制你的 IP 段）

3

获取访问凭证

通过 WebShell 或 SSH 连接服务器，执行命令查看 Gateway Token：

🔑 获取 Token

cat ~/.clawdbot/.env | grep CLAWDBOT_GATEWAY_TOKEN
# 输出示例: CLAWDBOT_GATEWAY_TOKEN=oc_xxxxxxxxxxxx

4

访问控制面板

浏览器打开 http://你的公网IP:18789，输入 Gateway Token 认证，即可进入控制面板开始配置。

🔗

腾讯云 Lighthouse 控制台：console.cloud.tencent.com/lighthouse

阿里云百炼部署

阿里云轻量应用服务器同样支持 OpenClaw 一键部署，并深度集成了阿里云百炼大模型服务（通义千问、Kimi、MiniMax 等国产模型）。

1

购买服务器

前往阿里云轻量应用服务器：
· 镜像选择「OpenClaw 镜像」
· 内存必须 ≥ 2GiB
· 如需完整联网搜索功能，建议选海外地域

2

配置百炼 API Key

前往阿里云百炼大模型控制台 →「系统管理」→「API Key 管理」创建密钥。然后在实例「应用详情」页点击「配置百炼 API-Key」执行命令并输入密钥。

3

选择计费方案

方案 A：Coding Plan 套餐（推荐）
固定月费模式，成本可控，包含月度请求额度。
支持模型：qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5 等。

方案 B：按 Token 用量计费
按实际调用量付费，适合使用量不固定的场景。

4

完成初始化

在「应用详情」页依次执行：
· 点击「执行命令」开放防火墙
· 配置 OpenClaw：生成访问 Token
· 点击「打开网站页面」进入控制台

🔗

阿里云百炼控制台：bailian.console.aliyun.com

Docker 手动部署

适用于已有云服务器或需要更灵活配置的场景。

环境准备

🐧 Ubuntu 环境

# 更新系统
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

安装并启动

🚀 安装 OpenClaw

# 官方安装脚本
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 startup

Docker Compose 方式

🐳 Docker 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	通过 WhatsApp Business API 接入	需海外服务器

💡

新手推荐：先用 Telegram 测试——创建 Bot 最简单，3 分钟搞定。确认一切正常后再接入其他平台。

配置 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 本地部署	完全离线，数据不出服务器

⚠️

使用 Anthropic/OpenAI API 需要绑定支付方式并充值，否则 API Key 无法正常调用。

安全加固

生产环境部署时，建议做以下安全配置：

1. 修改默认端口

🔒 修改端口

nano ~/.clawdbot/.env

# 修改端口
CLAWDBOT_PORT=19876

2. Nginx 反向代理 + SSL

🌐 Nginx 配置

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. 定期备份

⚠️

务必定期创建服务器快照！OpenClaw 的配置和记忆数据存储在服务器本地，丢失后无法恢复。
· 腾讯云：控制台「快照」功能设置自动快照策略
· 阿里云：使用「快照」或「镜像」功能备份

常见问题

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？

🔧 修复 PATH

# 找到 npm 全局目录
npm prefix -g

# 临时修复
export PATH="$(npm prefix -g)/bin:$PATH"

# 永久修复（zsh）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Q: Node.js 版本太低？

📦 升级 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