安装 OpenClaw

OpenClaw 以 npm 包的形式分发。你可以全局安装，并在 5 分钟内运行一个 AI 代理——或者跳过所有设置，直接通过 Clawly 部署。

不想折腾技术细节？

Clawly 是一个托管平台，为你部署和管理 OpenClaw 代理——无需终端、无需服务器、无需 Docker。选择一个方案，连接你的频道，几秒钟即可上线。

试试 Clawly

> 前置条件

安装 OpenClaw 之前，请确保你具备以下条件：

✓ Node.js 22 或更高版本。 OpenClaw 使用了需要 Node 22+ 的现代 JavaScript 特性。使用 node --version 检查你的版本。
✓ 一个 AI 服务商的 API 密钥。 你需要一个来自 Anthropic (Claude)、OpenAI (GPT)、Google (Gemini) 或其他支持的服务商的密钥。
✓ 一个消息平台的机器人令牌。 通过 @BotFather 创建 Telegram 机器人，或在 Discord 开发者门户创建 Discord 机器人。
✓ 一台服务器（用于 24/7 运行）。 任何 VPS、云虚拟机或常驻运行的机器都可以。一台每月 5 美元的服务器就足以运行一个代理。

> 安装

通过 npm 全局安装 OpenClaw：

npm install -g openclaw

验证安装：

openclaw --version

> 配置

OpenClaw 使用 .env 文件进行配置。创建一个工作目录并初始化：

mkdir my-agent && cd my-agent
openclaw init

这会创建一个包含所需变量的 .env 文件。至少需要设置以下内容：

# AI Provider
ANTHROPIC_API_KEY=sk-ant-...

# Telegram (optional)
TELEGRAM_BOT_TOKEN=123456:ABC-...

# Discord (optional)
DISCORD_BOT_TOKEN=MTIz...

# Agent personality
AGENT_NAME=MyAgent
AGENT_SYSTEM_PROMPT="You are a helpful assistant."

你只需配置你要使用的频道。OpenClaw 支持 Telegram、Discord、WhatsApp、Signal、Slack、iMessage 等——只需添加相应的令牌即可。

> 运行你的代理

使用 gateway 命令启动代理：

openclaw gateway

代理将连接到你配置的频道并开始监听消息。你会看到类似以下的输出：

[OpenClaw] Agent "MyAgent" starting...
[OpenClaw] Telegram connected
[OpenClaw] Discord connected
[OpenClaw] Ready — listening on 2 channels

对于生产环境部署，使用 pm2 或 Docker 等进程管理器来保持代理持续运行：

# With pm2
pm2 start "openclaw gateway" --name my-agent

# With Docker
docker run -d --env-file .env --name my-agent openclaw-agent

> 常见问题

"Error: Node.js version too old"

OpenClaw 需要 Node.js 22+。使用 nvm install 22 或从 Node.js 官网下载。

"Telegram polling conflict"

如果另一个进程正在轮询相同的机器人令牌，就会出现此错误。请停止其他实例或使用不同的机器人令牌。

"API rate limit exceeded"

你的 AI 服务商正在限制请求频率。请检查你所在方案的速率限制，并考虑升级或添加请求队列。

设置太麻烦？

Clawly 为你处理安装、托管、监控和更新。选择一个方案，连接你的频道，你的代理几秒钟即可上线。

免去繁琐，直接部署