OpenClaw 部署指南：打造你的个人 AI 助手
OpenClaw 是一个开源的个人 AI 助手，可以运行在你自己的设备上，通过你常用的消息渠道（Telegram、Slack、Discord、微信、QQ 等）与你交互。本文分享 Linux 和 Windows 环境的部署经验。
🦞 为什么选择 OpenClaw
| 特性 | 说明 |
|---|---|
| 多渠道接入 | 支持 Telegram、Slack、Discord、Signal、微信、QQ、WhatsApp 等 20+ 平台 |
| 本地运行 | 数据在自己机器上，隐私可控 |
| 多模型支持 | OpenAI、Claude、Gemini、Qwen、本地模型等 |
| 技能系统 | 可扩展技能，实现浏览器自动化、文件操作等 |
| 跨平台 | Linux、macOS、Windows (WSL2) |
📦 环境准备
Linux 环境
系统要求：
- Node.js 18+ （推荐 20+）
- npm / pnpm / bun（任选其一）
安装 Node.js：
bash
# 使用 NodeSource（推荐）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
# 或使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20安装 pnpm（推荐）：
bash
npm install -g pnpmWindows 环境
OpenClaw 强烈推荐使用 WSL2 运行。
安装 WSL2：
powershell
# PowerShell（管理员）
wsl --install这会自动安装 Ubuntu。重启后进入 WSL：
bash
# 在 WSL 内执行
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g pnpm⚠️ 为什么推荐 WSL2？
- 更好的 Node.js 兼容性
- 文件系统性能更好
- 与 Linux 教程一致，减少踩坑
🚀 安装 OpenClaw
快速安装
bash
# 使用 pnpm（推荐）
pnpm install -g openclaw
# 或使用 npm
npm install -g openclaw
# 验证安装
openclaw --version初始化配置
bash
# 运行初始化向导
openclaw onboard向导会引导你：
- 选择模型提供商（OpenAI、Claude、Qwen 等）
- 配置认证方式（API Key 或 OAuth）
- 设置 Gateway 端口
- 选择消息渠道
🌐 启动 Gateway
Gateway 是 OpenClaw 的核心服务，负责处理消息路由。
bash
# 启动 Gateway
openclaw gateway start
# 查看状态
openclaw gateway status默认端口：11080
访问控制面板：
http://localhost:11080/<basePath>basePath 在 onboard 时生成，保证安全。
📱 配置消息渠道
QQ 频道机器人
在 ~/.openclaw/openclaw.json 中配置：
json
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "你的 AppID",
"clientSecret": "你的 ClientSecret"
}
}
}获取 AppID/Secret：QQ 开放平台
Telegram
json
{
"channels": {
"telegram": {
"enabled": true,
"token": "你的 Bot Token"
}
}
}创建 Bot：与 @BotFather 对话
Discord
json
{
"channels": {
"discord": {
"enabled": true,
"token": "你的 Bot Token",
"clientId": "你的 Client ID"
}
}
}创建 Bot：Discord Developer Portal
🔧 配置模型
使用阿里云 Qwen
json
{
"models": {
"providers": {
"dashscope": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "你的 API Key",
"api": "openai-completions",
"models": [
{ "id": "qwen-max", "name": "Qwen-Max" }
]
}
}
}
}设置默认模型
json
{
"agents": {
"defaults": {
"model": {
"primary": "dashscope/qwen-max"
}
}
}
}💡 使用经验推荐
1. 配置 Workspace
OpenClaw 有一个工作目录，用于存放记忆文件、技能等：
json
{
"agents": {
"defaults": {
"workspace": "/home/you/.openclaw/workspace"
}
}
}建议创建以下文件：
| 文件 | 作用 |
|---|---|
SOUL.md | AI 的性格和风格定义 |
USER.md | 你的基本信息 |
MEMORY.md | 长期记忆存储 |
TOOLS.md | 工具使用笔记 |
2. 使用技能系统
安装技能扩展 AI 能力：
bash
# 搜索技能
openclaw skill search weather
# 安装技能
openclaw skill install weather推荐技能：
| 技能 | 功能 |
|---|---|
| weather | 天气查询 |
| healthcheck | 系统安全检查 |
| proactive-agent | 主动提醒和检查 |
3. 心跳机制
配置心跳让 AI 定期主动检查：
json
{
"cron": {
"enabled": true
}
}在 HEARTBEAT.md 中定义检查内容，AI 会定期执行。
4. 安全建议
exec 执行审批：
json
{
"exec": {
"approvalMode": "on-miss" // 危险命令需要审批
}
}Gateway 认证：
json
{
"gateway": {
"auth": {
"mode": "token",
"token": "你的安全 Token"
}
}
}5. 远程访问配置
如果需要外网访问：
使用 Tailscale：
json
{
"gateway": {
"tailscale": {
"mode": "on"
}
}
}或使用 Nginx 反向代理：
nginx
location /openclaw/ {
proxy_pass http://127.0.0.1:11080/;
proxy_set_header Host $host;
}🔄 更新与维护
更新 OpenClaw
bash
# pnpm
pnpm update -g openclaw
# npm
npm update -g openclaw更新后重启 Gateway：
bash
openclaw gateway restart常用命令
bash
# 查看 Gateway 状态
openclaw status
# 运行诊断
openclaw doctor
# 备份数据
openclaw backup create
# 查看日志
tail -f ~/.openclaw/logs/commands.log📚 资源链接
🎯 总结
OpenClaw 的核心优势：
- 隐私可控 — 数据在本地，不经过第三方
- 渠道丰富 — 哪里聊天，哪里用 AI
- 扩展性强 — 技能系统无限扩展
- 持续进化 — 记忆系统让 AI 越用越懂你
部署不难，关键是：
- 选好模型提供商（推荐已有订阅的）
- 配好消息渠道（用你最常用的）
- 写好记忆文件（让 AI 了解你）
开始你的 OpenClaw 之旅吧！🦞
有问题欢迎到 Discord 社区交流。