OpenClaw 部署完全指南：一键搭建你的私人 AI 助手

前言

OpenClaw（原名 Clawdbot）是一个强大的开源 AI 助手项目，可以让你在多个平台上部署自己的私人 AI 机器人。该项目最初名为 Clawdbot，后因与 Anthropic 的 Claude AI 商标相似性问题，先后改名为 Moltbot，最终定名为 OpenClaw，寓意开源（Open）且保留了原有的”爪子”（Claw）形象。

本文将详细介绍如何使用 OpenClawInstaller 工具快速部署 OpenClaw，让你在几分钟内拥有自己的 AI 助手。

OpenClaw 核心功能特性

🤖 多 AI 模型支持

OpenClaw 支持业界主流的 AI 模型，你可以根据需求自由选择：

主流服务商

  • Anthropic Claude - claude-sonnet-4-5 / claude-opus-4-5 / claude-haiku-4-5（支持自定义 API 地址）
  • OpenAI GPT - gpt-4o / gpt-4o-mini / gpt-4-turbo（支持自定义 API 地址，需支持 v1/responses）
  • Google Gemini - gemini-2.0-flash / gemini-1.5-pro / gemini-1.5-flash

多模型网关

  • OpenRouter - 一个 Key 用遍所有模型（claude-sonnet-4 / gpt-4o / gemini-pro-1.5）

快速推理

  • Groq - 超快推理速度（llama-3.3-70b-versatile / llama-3.1-8b-instant / mixtral-8x7b）
  • Mistral AI - mistral-large-latest / mistral-small-latest / codestral-latest

本地部署

  • Ollama - 本地部署，无需 API Key（llama3 / llama3:70b / mistral）

💡 提示：Anthropic Claude 和 OpenAI GPT 都支持自定义 API 地址，可接入 OneAPI/NewAPI/API 代理等服务。

⚠️ 重要：自定义 OpenAI API 地址必须支持 v1/responses 路径（OpenAI Responses API），不仅仅是传统的 v1/chat/completions。

📱 多渠道接入

OpenClaw 支持主流即时通讯平台，真正实现”一次部署，到处使用”：

  • Telegram Bot
  • Discord Bot
  • WhatsApp
  • Slack
  • 微信 (WeChat)
  • iMessage（仅 macOS）
  • 飞书 (Feishu)

🧠 核心能力

  • 持久记忆 - 跨对话、跨平台的长期记忆能力
  • 主动推送 - 定时提醒、晨报、告警通知
  • 技能系统 - 通过 Markdown 文件定义自定义能力
  • 远程控制 - 可执行系统命令、读写文件、浏览网络

环境准备

在开始部署之前，请确保你的系统满足以下要求：

系统要求

  • 操作系统：macOS、Linux 或 Windows（WSL）
  • Node.js：版本 >= 18.0.0
  • 网络：稳定的互联网连接（用于下载依赖和访问 AI API）

必备信息

根据你要使用的服务，准备以下信息：

  1. AI 模型 API Key（至少一个）

  2. 聊天平台 Token（可选，根据需求）

    • Telegram Bot Token：通过 @BotFather 创建
    • Discord Bot Token：从 Discord Developer Portal 获取
    • 其他平台的相应凭证

部署方式

OpenClaw 提供了三种部署方式，你可以根据自己的喜好选择：

方式一：桌面版 OpenClaw Manager（推荐）

如果你喜欢图形界面，推荐使用 OpenClaw Manager 桌面应用。

特性

  • 🎨 现代化 UI - 基于 Tauri 2.0 + React + TypeScript + Rust 构建
  • 📊 实时监控 - 仪表盘查看服务状态、内存、运行时间
  • 🔧 可视化配置 - AI 模型、消息渠道一键配置
  • 💻 跨平台 - 支持 macOS、Windows、Linux

安装步骤

  1. 访问 OpenClaw Manager 下载对应平台的安装包
  2. 运行安装程序
  3. 在图形界面中完成配置
  4. 点击启动按钮即可运行

方式二：命令行一键安装（快速）

这是最简单快捷的部署方式，适合喜欢命令行操作的用户。

安装命令

1
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

安装过程

脚本会自动完成以下步骤：

  1. ✅ 检测系统环境并安装必要依赖
  2. ✅ 安装 OpenClaw 核心程序
  3. ✅ 引导完成核心配置（AI 模型、身份信息）
  4. ✅ 测试 API 连接
  5. ✅ 自动启动 OpenClaw 服务
  6. ✅ 可选打开配置菜单进行详细配置

安装后操作

安装完成后，脚本会询问是否启动服务：

1
2
3
4
5
# 推荐选择 Y 立即启动
Do you want to start OpenClaw now? (Y/n): Y

# 服务会在后台运行
OpenClaw Gateway started successfully!

你也可以稍后手动管理服务：

1
2
3
4
5
6
7
8
9
10
11
# 启动服务
source ~/.openclaw/env && openclaw gateway

# 后台启动服务
openclaw gateway start

# 运行配置菜单
bash ~/.openclaw/config-menu.sh

# 或直接从 GitHub 运行配置菜单
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/config-menu.sh | bash

方式三：手动安装（进阶）

如果你想完全掌控安装过程，可以选择手动安装。

步骤详解

1
2
3
4
5
6
7
8
9
10
11
12
13
# 1. 克隆仓库
git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller

# 2. 添加执行权限
chmod +x install.sh config-menu.sh

# 3. 运行安装脚本
./install.sh

# 如果 macOS 有权限问题，可以先手动安装 OpenClaw：
npm install -g openclaw
# 然后再运行 install.sh

手动配置

手动安装后，你需要配置环境变量：

1
2
3
4
5
# 编辑配置文件
nano ~/.openclaw/.env

# 或使用配置菜单
bash ~/.openclaw/config-menu.sh

详细配置指南

无论使用哪种部署方式，都需要配置 AI 模型和渠道信息。以下是详细的配置步骤。

配置 AI 模型

运行配置菜单：

1
bash ~/.openclaw/config-menu.sh

选择 [2] AI 模型配置，然后根据你的需求选择相应的提供商。

Anthropic Claude 配置

  1. 在配置菜单中选择 Anthropic Claude
  2. （可选） 输入自定义 API 地址（如使用 OneAPI/NewAPI 等代理，否则留空使用官方 API）
  3. 输入 API Key
  4. 选择模型（推荐 claude-sonnet-4-5-20250929）

配置示例

1
2
3
4
5
6
7
请输入 Anthropic API 地址（留空使用官方 API）: https://your-proxy.com/v1
请输入 Anthropic API Key: sk-ant-xxxxxxxxxxxxx
选择模型:
  1. claude-sonnet-4-5-20250929 (推荐)
  2. claude-opus-4-5-20250929
  3. claude-haiku-4-5-20250929
请选择 (1-3): 1

OpenAI GPT 配置

  1. 在配置菜单中选择 OpenAI GPT
  2. （可选） 输入自定义 API 地址（留空使用官方 API）
  3. 输入 API Key（从 OpenAI Platform 获取）
  4. 选择模型

⚠️ 中转服务要求：如使用自定义 API 地址，中转服务必须支持 OpenAI 的 Responses API (v1/responses 路径)，而非仅支持传统的 Chat Completions API (v1/chat/completions)。部分老旧或功能不全的中转服务可能不支持此接口，请提前确认。

配置示例

1
2
3
4
5
6
7
请输入 OpenAI API 地址（留空使用官方 API）:
请输入 OpenAI API Key: sk-xxxxxxxxxxxxx
选择模型:
  1. gpt-4o
  2. gpt-4o-mini
  3. gpt-4-turbo
请选择 (1-3): 1

其他模型配置

配置菜单还支持：

  • Google Gemini - 输入 API Key 即可
  • OpenRouter - 一个 Key 访问多个模型
  • Groq - 超快推理速度
  • Mistral AI - 欧洲开源模型
  • Ollama - 本地部署，无需 API Key

按照菜单提示操作即可完成配置。

配置 Telegram 机器人

Telegram 是最受欢迎的 OpenClaw 接入渠道之一，配置简单快捷。

步骤详解

  1. 创建机器人

    • 在 Telegram 中搜索 @BotFather
    • 发送 /newbot 命令
    • 按提示设置机器人名称和用户名
    • 复制获得的 Bot Token（格式如：1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）

  2. 获取你的 User ID

    • 搜索 @userinfobot
    • 点击 Start 或发送任意消息
    • 机器人会返回你的 User ID（如：123456789）

  3. 在 OpenClaw 中配置

    • 运行配置菜单：bash ~/.openclaw/config-menu.sh
    • 选择 Telegram
    • 输入 Bot Token 和 User ID

示例配置

1
2
3
4
=== Telegram 配置 ===
请输入 Telegram Bot Token: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
请输入你的 Telegram User ID: 123456789
配置已保存！

测试机器人

配置完成并启动服务后：

  1. 在 Telegram 中找到你创建的机器人
  2. 点击 Start 或发送 /start
  3. 发送任意消息测试是否收到回复

配置 Discord 机器人

Discord 配置稍复杂，但功能强大，适合团队协作。

第一步：创建 Discord 应用和机器人

  1. 访问 Discord Developer Portal
  2. 点击 “New Application” 创建新应用
  3. 输入应用名称并确认
  4. 进入应用后，点击左侧 “Bot” 菜单
  5. 点击 “Reset Token” 生成 Bot Token
  6. 复制并保存 Bot Token（只显示一次！）
  7. ⚠️ 重要：开启 **”Message Content Intent”**（否则无法读取消息内容）
    • 在 Bot 设置页面向下滚动
    • 找到 “Privileged Gateway Intents”
    • 勾选 “MESSAGE CONTENT INTENT”

第二步：邀请机器人到服务器

  1. 点击左侧 “OAuth2” → “URL Generator”
  2. Scopes 勾选：
    • ✅ bot
  3. Bot Permissions 至少勾选：
    • ✅ View Channels（查看频道）
    • ✅ Send Messages（发送消息）
    • ✅ Read Message History（读取消息历史）
  4. 复制生成的 URL，在浏览器中打开
  5. 选择要添加机器人的服务器
  6. 确认权限并完成添加

第三步：获取频道 ID

  1. 打开 Discord 客户端
  2. 进入 “用户设置” → “高级”
  3. 开启 “开发者模式”
  4. 返回你想让机器人响应的频道
  5. 右键点击频道名称
  6. 点击 **”复制频道 ID”**（如：1234567890123456789）

第四步：在 OpenClaw 中配置

1
2
3
4
5
# 运行配置菜单
bash ~/.openclaw/config-menu.sh

# 选择 Discord
# 输入 Bot Token 和 Channel ID

示例配置

1
2
3
4
=== Discord 配置 ===
请输入 Discord Bot Token: YOUR_DISCORD_BOT_TOKEN_HERE
请输入 Discord Channel ID: 1234567890123456789
配置已保存！

测试机器人

  1. 确保 OpenClaw 服务已启动
  2. 在配置的 Discord 频道中 @机器人 或直接发送消息
  3. 检查机器人是否回复

其他渠道配置

飞书机器人

  1. 在配置菜单中选择 飞书
  2. 按照提示配置飞书机器人凭证
  3. 具体步骤参考 飞书开放平台文档

WhatsApp

  1. 在配置菜单中选择 WhatsApp
  2. 需要 WhatsApp Business API 凭证
  3. 按照提示完成配置

微信

  1. 基于 Wechaty 实现
  2. 配置相对复杂，建议参考官方文档

常用命令

安装完成后，你可以使用以下命令管理 OpenClaw：

服务管理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 启动服务（前台）
source ~/.openclaw/env && openclaw gateway

# 启动服务（后台）
openclaw gateway start

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 查看服务状态
openclaw gateway status

配置管理

1
2
3
4
5
6
7
8
# 打开配置菜单
bash ~/.openclaw/config-menu.sh

# 直接编辑配置文件
nano ~/.openclaw/.env

# 查看当前配置
cat ~/.openclaw/.env

日志查看

1
2
3
4
5
# 查看实时日志
tail -f ~/.openclaw/logs/gateway.log

# 查看最近 100 行日志
tail -n 100 ~/.openclaw/logs/gateway.log

数据管理

1
2
3
4
5
6
7
8
9
# 备份配置和数据
cp -r ~/.openclaw ~/.openclaw.backup

# 清理日志文件
rm ~/.openclaw/logs/*.log

# 完全卸载
rm -rf ~/.openclaw
npm uninstall -g openclaw

常见问题

Q: 安装时提示 Node.js 版本过低？

解决方案

1
2
3
4
5
6
7
8
# 使用 nvm 安装最新 LTS 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc  # 或 ~/.zshrc
nvm install --lts
nvm use --lts

# 验证版本
node --version  # 应显示 >= v18.0.0

Q: 启动后无法连接？

排查步骤

  1. 检查服务是否正常运行：

    1
    openclaw gateway status

  2. 查看日志排查错误：

    1
    tail -f ~/.openclaw/logs/gateway.log

  3. 检查网络连接和防火墙设置

  4. 验证 API Key 是否正确：

    1
    cat ~/.openclaw/.env

Q: Telegram 机器人没有响应？

常见原因

  1. Bot Token 错误 - 重新从 @BotFather 获取
  2. User ID 错误 - 重新从 @userinfobot 确认
  3. 服务未启动 - 确保 openclaw gateway status 显示运行中
  4. 网络问题 - 检查是否能访问 Telegram API

解决步骤

1
2
3
4
5
6
7
8
9
10
11
12
# 1. 停止服务
openclaw gateway stop

# 2. 重新配置
bash ~/.openclaw/config-menu.sh
# 选择 Telegram，重新输入正确的 Token 和 ID

# 3. 重启服务
openclaw gateway start

# 4. 查看日志
tail -f ~/.openclaw/logs/gateway.log

Q: 如何更新到最新版本？

1
2
3
4
5
6
7
8
9
# 更新全局安装的 OpenClaw
npm update -g openclaw

# 如果需要强制重新安装
npm uninstall -g openclaw
npm install -g openclaw

# 重启服务
openclaw gateway restart

Q: 如何备份数据？

1
2
3
4
5
6
7
8
# 完整备份（包含配置、日志、数据）
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw

# 仅备份配置
cp ~/.openclaw/.env ~/openclaw-env-backup.env

# 恢复备份
tar -xzf openclaw-backup-20260204.tar.gz -C ~/

Q: 如何完全卸载？

1
2
3
4
5
6
7
8
9
10
11
# 1. 停止服务
openclaw gateway stop

# 2. 删除全局包
npm uninstall -g openclaw

# 3. 删除配置和数据
rm -rf ~/.openclaw

# 4. （可选）删除安装脚本
rm -rf ~/OpenClawInstaller

安全建议

部署建议

  1. 生产环境

    • 使用 systemd 或 PM2 管理服务进程
    • 配置日志轮转，防止日志文件过大
    • 定期备份配置和数据

  2. 网络安全

    • 不要在公网暴露 OpenClaw 端口
    • 使用防火墙限制访问
    • 启用 HTTPS（如需对外服务）

权限控制

  1. Telegram

    • 仅允许特定 User ID 访问
    • 定期检查授权列表

  2. Discord

    • 仅授予必要的 Bot 权限
    • 限制机器人响应的频道

API Key 安全

  1. 不要将 API Key 提交到版本控制系统
  2. 定期轮换 API Key
  3. 使用环境变量或密钥管理服务
  4. 设置 API 使用配额和告警

总结

OpenClaw 是一个功能强大、易于部署的 AI 助手解决方案。通过本教程，你应该已经成功：

  • ✅ 了解 OpenClaw 的功能特性和应用场景
  • ✅ 掌握三种部署方式（桌面版、命令行、手动）
  • ✅ 配置 AI 模型（Anthropic、OpenAI、Gemini 等）
  • ✅ 接入即时通讯平台（Telegram、Discord 等）
  • ✅ 学会日常维护和故障排查

现在，你可以开始享受属于自己的私人 AI 助手了！

参考资源

Happy AI-ing! 🦞✨