手把手教你本地部署 OpenClaw：5 分钟拥有私人 AI 助理手把手教你本地部署 OpenClaw：5 分钟拥有私人

手把手教你本地部署 OpenClaw：5 分钟拥有私人 AI 助理

声明：本文基于 OpenClaw 官方文档和实际部署经验总结，引用信息已标注来源。
适用人群：开发者、技术爱好者、想拥有私人 AI 助理的用户
预计耗时：5-10 分钟

🦞 什么是 OpenClaw？

OpenClaw 是一个自托管的 AI 助理网关，可以把你的微信、Telegram、Discord、iMessage 等聊天工具连接到 AI 模型。

核心特点：

🏠 自托管：运行在你自己的设备上，数据完全可控
💬 多平台：支持 WhatsApp、Telegram、Discord、iMessage 等 15+ 平台
🤖 AI 原生：专为 AI 助理设计，支持工具调用、会话管理、多代理路由
🔓 开源：MIT 许可，社区驱动

来源：OpenClaw 官方文档

📋 部署前准备

系统要求

项目	要求
Node.js	v22 或更高版本
操作系统	Windows / macOS / Linux
内存	最低 512MB，推荐 2GB+
网络：	需要访问 npm 和 AI 模型 API

检查 Node.js 版本

node --version
# 输出示例：v24.14.0

如果版本低于 v22，请先升级：

Windows/macOS: 访问 nodejs.org
Linux: nvm install 22 或使用包管理器

🚀 快速部署（推荐新手）

步骤 1：安装 OpenClaw

npm install -g openclaw@latest

说明：

-g 表示全局安装
@latest 确保安装最新版本
如果下载慢，可切换淘宝镜像：npm config set registry https://registry.npmmirror.com

步骤 2：运行向导（自动配置）

openclaw onboard --install-daemon

向导会帮你：

配置 AI 模型 API Key（支持 OpenAI、Claude、通义千问等）
设置网关端口（默认 18789）
安装后台服务（开机自启）
初始化工作空间

步骤 3：启动网关

openclaw gateway --port 18789

看到类似输出表示成功：

🦞 Gateway started on ws://127.0.0.1:18789

步骤 4：打开控制面板

浏览器访问：http://127.0.0.1:18789

这就是你的 AI 助理控制台，可以直接在网页聊天。

🔧 进阶配置

1. 配置 AI 模型

编辑配置文件 ~/.openclaw/openclaw.json：

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

常用模型推荐：

anthropic/claude-opus-4-6 - Claude 最新旗舰
openai/gpt-4o - GPT-4o
bailian/qwen3.5-plus - 通义千问（国内推荐）

2. 连接聊天平台

Telegram（最简单）

openclaw channels login telegram

按提示输入 Bot Token（从 @BotFather 获取）

openclaw channels login whatsapp

会显示二维码，用手机 WhatsApp 扫码绑定

Discord

在 openclaw.json 中添加：

{
  "channels": {
    "discord": {
      "token": "你的 Discord Bot Token"
    }
  }
}

3. 安全设置（重要！）

限制可访问的用户：

{
  "channels": {
    "telegram": {
      "allowFrom": ["+8613800138000"]  // 只允许指定号码
    }
  }
}

群组中需要 @ 才响应：

{
  "channels": {
    "telegram": {
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

📱 移动端使用

iOS/Android 节点

OpenClaw 支持手机 App 作为节点：

手机下载 OpenClaw App（或自建）
运行配对命令：
```
openclaw devices pair
```
手机输入配对码

功能：

语音唤醒
屏幕共享
摄像头控制
Canvas 可视化工作区

🛠️ 常见问题

Q1: 安装失败，提示权限错误

解决：

# Windows：用管理员身份运行 PowerShell
# macOS/Linux：加 sudo
sudo npm install -g openclaw@latest

Q2: 网关启动失败，端口被占用

解决：

# 查看占用端口的进程
netstat -ano | findstr :18789

# 换一个端口
openclaw gateway --port 19001

Q3: API Key 配置在哪里？

位置： ~/.openclaw/openclaw.json

示例：

{
  "agent": {
    "model": "openai/gpt-4o",
    "apiKey": "sk-xxx"  // 或通过环境变量
  }
}

Q4: 如何查看日志？

openclaw logs

或查看文件：~/.openclaw/logs/gateway.log

Q5: 如何更新 OpenClaw？

npm update -g openclaw
openclaw doctor  # 检查健康状态

💡 使用技巧

1. 快捷命令

在聊天中发送：

/status - 查看会话状态
/new - 重置会话
/think high - 提高思考深度
/verbose on - 开启详细输出

2. 工作空间

你的工作空间在：~/.openclaw/workspace

重要文件：

AGENTS.md - 助理行为指南
SOUL.md - 人设和语气
MEMORY.md - 长期记忆
memory/ - 每日日志

3. 定时任务

使用 cron 设置定时提醒：

openclaw cron add --schedule "0 9 * * *" --message "早上好！今日待办：..."

🔐 安全建议

不要公开暴露网关：默认绑定本地，如需远程访问用 Tailscale
设置 allowFrom：限制可访问的用户
定期更新：npm update -g openclaw
备份配置：~/.openclaw/ 目录定期备份
使用强 API Key：定期更换

📚 参考资源

官方文档：docs.openclaw.ai
GitHub：github.com/openclaw/op…
Discord 社区：discord.gg/clawd
技能市场：clawhub.com

🎯 下一步

部署完成后，你可以：

✅ 在网页控制台测试聊天
✅ 连接 Telegram/WhatsApp 等聊天工具
✅ 配置自定义 AI 助理人设
✅ 安装扩展技能（天气、搜索、浏览器控制等）
✅ 设置定时任务和自动化

遇到问题？

先运行 openclaw doctor 自检
查看日志：openclaw logs
去 Discord 社区提问
查官方文档故障排除章节

部署愉快！有问题的话随时问我。 🦞