Appearance
10分钟快速部署OpenClaw：环境准备、一键安装、配置向导、连接消息平台——保姆级教程，手把手带你跑起来。
开始之前
OpenClaw 是一个本地运行的 AI Agent，它能读你的文件、发你的邮件、执行你的命令。这意味着它的权限比一般 App 大得多。
在你按照教程操作之前，请先建立这个认知：OpenClaw 不是一个玩具，它是一个数字员工，你需要认真配置它的权限边界。
1. 环境准备
系统要求
| 要求 | 说明 |
|---|---|
| 操作系统 | macOS、Linux、Windows（均支持） |
| Node.js | ≥ 22.12.0（非常重要，低版本会报错） |
| npm | 建议升级到最新版 |
| 内存 | 建议 8GB 以上 |
检查 Node.js 版本
bash
node -v如果版本低于 22，使用 nvm 安装：
bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装并切换到 Node 22
nvm install 22
nvm use 222. 安装 OpenClaw
方法一：一键安装（推荐）
bash
npm install -g openclaw@latest或使用 pnpm（更快）：
bash
pnpm add -g openclaw@latest确认安装成功：
bash
openclaw --version
# 应该显示类似 openclaw/2026.x.x方法二：Docker 安装（服务器部署）
bash
# 拉取镜像
docker pull openclaw/openclaw:latest
# 启动容器
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest3. 配置向导
运行配置向导：
bash
openclaw onboard --install-daemon--install-daemon 参数会把 OpenClaw 安装为后台服务，开机自启。
① 选择 AI 模型提供商
| 提供商 | 推荐模型 | 特点 |
|---|---|---|
| Anthropic | claude-sonnet-4-6 | 推理能力强，工具调用稳定，官方推荐 |
| OpenAI | gpt-4o | 生态成熟，响应快 |
| DeepSeek | deepseek-chat | 价格极低，中文理解好，国内访问友好 |
② 输入 API Key
以 Anthropic 为例：
- 访问 console.anthropic.com
- 进入 API Keys 页面，创建新 Key
- 粘贴到向导提示处
③ 设置 Canvas Host 绑定（安全关键）
bash
# 修改配置文件，找到 canvas_host 配置项
canvas_host: 127.0.0.1改成 127.0.0.1 后，只有本机可以访问控制面板。
④ 连接消息平台
Telegram：
- 找到 @BotFather
- 发送
/newbot创建 Bot - 获取 Bot Token
- 粘贴到向导提示处
WhatsApp：扫描二维码即可。
4. 打开控制面板
浏览器访问：
http://127.0.0.1:18789/首次访问需要 Token，终端运行：
bash
openclaw gateway --verbose会打印出 Token，粘贴到浏览器认证框。
5. 第一次对话
在 Telegram 或 WhatsApp 里找到你的 Bot，发送：
你好！请做一个自我介绍，告诉我你现在能做什么。如果一切正常，Agent 会在几秒内回复。
6. 费用估算
OpenClaw 本身免费，但调用 AI 模型需要付费。
| 用户类型 | 使用频率 | 估计月费 |
|---|---|---|
| 轻度用户 | 偶尔查询 | $5 - $15 |
| 中度用户 | 每日使用 | $20 - $50 |
| 重度用户 | 持续运行 | $80 - $200+ |
省钱技巧：
- 定期开启新会话（避免上下文堆积）
- 简单任务切换到 DeepSeek（价格约为 Claude 的 1/10）
- 设置月消费上限
7. 常见报错速查
| 报错信息 | 原因 | 解决方法 |
|---|---|---|
| command not found: openclaw | npm 全局路径未加入 PATH | 重启终端或配置 PATH |
| Error: Node.js version < 22 | Node 版本太低 | 升级 Node.js |
| Port 18789 already in use | 端口被占用 | lsof -i :18789 找到并结束进程 |
| API Key invalid | Key 输入有误 | 重新生成并复制 |
| Channel linking failed | 消息平台 Token 过期 | 重跑 openclaw onboard |
小结
到这里，你已经完成了：
- ✅ 安装 OpenClaw CLI
- ✅ 配置 AI 模型
- ✅ 连接消息平台
- ✅ 打开控制面板
- ✅ 完成健康检查
接下来，装上 Skills，给它配上真正的超能力。
