OpenClaw 入门配置指南 - 从零开始搭建你的私人 AI 助手

导读：本文是一篇超详细的 OpenClaw 入门教程，从零基础开始，手把手教你搭建属于自己的私人 AI 助手。内容涵盖安装配置、模型绑定、渠道设置、技能管理、故障排除等全方位知识，包含大量实战命令和最佳实践。

---

一、什么是 OpenClaw？

OpenClaw 是一个强大的开源 AI 助手框架，让你能够拥有一个运行在自己服务器上的私人 AI 助手。与依赖云服务的 AI 不同，OpenClaw 完全运行在你的控制之下，保护你的隐私和数据安全。

1.1 核心特性

• 隐私优先：所有数据都存储在本地，不会上传到第三方服务器
• 高度可定制：可以根据自己的需求配置 AI 的行为和能力
• 多平台支持：支持 WhatsApp、Telegram、Discord、QQ 等多种通讯平台
• 技能系统：可以扩展各种技能，如文件处理、网页浏览、定时任务等
• 开源免费：完全开源，社区驱动，持续更新
• 本地部署：运行在自己的服务器上，完全掌控

1.2 适用场景

• 个人隐私保护：不希望对话数据被云服务记录
• 企业内网部署：需要在隔离网络中运行 AI 助手
• 定制化需求：需要特定功能或集成内部系统
• 成本优化：长期使用比云服务更经济
• 学习研究：深入了解 AI 助手的工作原理

---

二、系统要求

2.1 硬件要求

配置项	最低要求	推荐配置
CPU	2 核心	4 核心以上
内存	4GB RAM	8GB 以上
存储	10GB 可用空间	20GB 以上 SSD

2.2 软件要求

• 操作系统：Linux（推荐 Ubuntu 20.04+）、macOS（10.15+）、Windows（WSL2 推荐）
• Node.js：v18.0 或更高版本（推荐 v20+ LTS）
• 包管理器：npm 或 pnpm（推荐 pnpm）
• Git：用于版本控制

---

三、详细安装步骤

3.1 安装 Node.js（使用 nvm，推荐）

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载配置
source ~/.bashrc

# 安装 Node.js 20 LTS
nvm install 20
nvm use 20

# 验证安装
node -v
npm -v

3.2 安装 OpenClaw

# 使用 pnpm 安装（推荐）
npm install -g pnpm
pnpm add -g openclaw

# 验证安装
openclaw --version

3.3 初始化 OpenClaw

# 初始化配置
openclaw init

这个命令会创建配置文件目录 ~/.openclaw/，生成默认配置文件，创建 workspace 工作目录。

---

四、配置 AI 模型

4.1 编辑配置文件

编辑 ~/.openclaw/config.json：

{
  "model": {
    "provider": "openai",
    "apiKey": "sk-your-api-key-here",
    "modelName": "gpt-4"
  }
}

4.2 支持的模型提供商

• OpenAI：gpt-4, gpt-3.5-turbo
• Anthropic：claude-3-opus, claude-3-sonnet
• Google：gemini-pro, gemini-ultra
• 本地模型：ollama/llama2, lm-studio

4.3 使用本地模型（Ollama）

# 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 拉取模型
ollama pull llama2

# 配置 OpenClaw 使用 Ollama
# 编辑 config.json，设置 provider 为 ollama

---

五、配置通讯渠道

5.1 WhatsApp 配置

# 添加 WhatsApp 渠道
openclaw channel add whatsapp

运行命令后会显示 QR 码，使用 WhatsApp 手机应用扫描二维码完成绑定。

5.2 Telegram 配置

# 添加 Telegram 渠道
openclaw channel add telegram --token YOUR_BOT_TOKEN

获取 Bot Token：在 Telegram 中联系 @BotFather，发送 /newbot 创建新 Bot。

5.3 Discord 配置

# 添加 Discord 渠道
openclaw channel add discord --token YOUR_BOT_TOKEN

5.4 QQ 配置

# 添加 QQ 渠道
openclaw channel add qqbot

---

六、启动服务

6.1 基本启动命令

# 前台启动（调试用）
openclaw start

# 后台启动（生产环境推荐）
openclaw gateway start

# 查看服务状态
openclaw status

# 查看实时日志
openclaw logs -f

# 重启服务
openclaw restart

# 停止服务
openclaw stop

6.2 使用 PM2 管理（生产环境推荐）

# 安装 PM2
npm install -g pm2

# 使用 PM2 启动
pm2 start openclaw --name openclaw-bot

# 保存配置（开机自启）
pm2 save
pm2 startup

# 查看状态
pm2 status

---

七、常用命令速查

7.1 服务管理

# 启动：openclaw start
# 停止：openclaw stop
# 重启：openclaw restart
# 状态：openclaw status
# 日志：openclaw logs -f

7.2 渠道管理

# 添加渠道：openclaw channel add whatsapp
# 列出渠道：openclaw channel list
# 移除渠道：openclaw channel remove <name>

7.3 技能管理

# 列出技能：openclaw skills list
# 安装技能：openclaw skills install <name>
# 更新技能：openclaw skills update <name>
# 移除技能：openclaw skills remove <name>

7.4 配置管理

# 查看配置：openclaw config show
# 编辑配置：openclaw config edit
# 验证配置：openclaw config validate

---

八、故障排除

8.1 常见问题

问题 1：无法启动服务

# 检查端口占用
lsof -i :8080

# 查看日志
openclaw logs

# 检查 Node.js 版本
node -v  # 确保是 v18+

问题 2：模型连接失败

# 检查 API Key
cat ~/.openclaw/config.json | grep apiKey

# 测试网络连接
curl -I https://api.openai.com

问题 3：渠道连接问题

# 重新添加渠道
openclaw channel remove <channel>
openclaw channel add <channel>

---

九、安全建议

9.1 保护敏感信息

• 不要将 API Key 提交到版本控制系统
• 使用环境变量存储敏感信息
• 定期轮换 API Key

# 设置配置文件权限
chmod 600 ~/.openclaw/config.json
chmod 700 ~/.openclaw/

9.2 防火墙配置

# Ubuntu/Debian
sudo ufw allow 8080/tcp
sudo ufw enable

9.3 定期备份

# 备份配置目录
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

---

十、资源与社区

10.1 官方资源

• 官方文档：docs.openclaw.ai
• GitHub 仓库：github.com/openclaw/openclaw
• Discord 社区：discord.com/invite/clawd
• 技能市场：clawhub.ai

---

结语

OpenClaw 是一个强大而灵活的 AI 助手框架，通过本地部署让你完全掌控自己的 AI 助手。本指南涵盖了从安装到高级使用的各个方面，希望能帮助你顺利搭建和使用 OpenClaw。

记住：安全第一，定期更新，积极备份，参与社区。

祝你使用愉快！