OpenClaw 完全指南：打造你的私人 AI 助手网关

你有没有想过，如果能像发微信一样跟 AI 聊天，而且完全掌控自己的数据和隐私，会是怎样的体验？今天要介绍的 OpenClaw 就是这样一个开源工具——它能把 WhatsApp、Telegram、Discord、iMessage 等聊天应用变成你的 AI 助手入口，而且所有数据都在你自己的服务器上。

什么是 OpenClaw？

OpenClaw 是一个自托管的 AI 智能体网关（Gateway），它的核心作用是连接你的聊天应用和 AI 模型。简单来说，你在 WhatsApp 或 Telegram 上发一条消息，OpenClaw 会把它转发给 AI 模型，然后把回复发回给你。

为什么选择 OpenClaw？

• 完全自托管：运行在你自己的服务器或电脑上，数据完全由你掌控
• 多渠道支持：一个 Gateway 同时连接 WhatsApp、Telegram、Discord、iMessage 等
• AI 原生设计：专门为 AI 编程智能体打造，支持工具调用、会话管理、记忆存储
• 开源免费：MIT 许可证，社区驱动

工作原理

聊天应用 (WhatsApp/Telegram/Discord等)
        ↓
   OpenClaw Gateway（你的服务器）
        ↓
    AI 模型 (Claude/GPT/本地模型)

Gateway 是整个系统的核心，负责会话管理、消息路由和渠道连接。

快速安装

系统要求

• Node.js 22 或更高版本（推荐 Node.js 24）
• 一个 AI 模型的 API 密钥（如 Claude、OpenAI、OpenRouter 等）
• 5 分钟时间

安装方式

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)：

iwr -useb https://openclaw.ai/install.ps1 | iex

或者使用 npm 全局安装：

npm install -g openclaw@latest

运行新手向导

安装完成后，运行向导进行初始化配置：

openclaw onboard --install-daemon

这个命令会：

1. 引导你完成基础配置
2. 安装 Gateway 服务（后台运行）
3. 设置认证和安全选项

检查 Gateway 状态

openclaw gateway status

如果显示 running，说明 Gateway 已经成功启动。

打开控制面板

openclaw dashboard

这会打开浏览器访问 http://127.0.0.1:18789/，你可以在网页上直接和 AI 聊天。

配置详解

OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json，使用 JSON5 格式（支持注释和尾逗号）。

最小配置示例

{
  // 工作目录
  agents: { 
    defaults: { 
      workspace: "~/.openclaw/workspace" 
    } 
  },
  // 允许哪些号码发消息给机器人
  channels: { 
    whatsapp: { 
      allowFrom: ["+8613800138000"] 
    } 
  },
}

编辑配置的几种方式

1. 交互式向导：

openclaw onboard       # 完整设置向导
openclaw configure     # 配置向导

2. 命令行快捷操作：

# 查看配置
openclaw config get agents.defaults.workspace

# 设置配置
openclaw config set agents.defaults.heartbeat.every "2h"

# 删除配置
openclaw config unset tools.web.search.apiKey

3. 直接编辑文件：

nano ~/.openclaw/openclaw.json

Gateway 会自动监听文件变化并热加载配置，大部分修改不需要重启。

配置模型

选择你要使用的 AI 模型：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",  // 主模型
        fallbacks: ["openai/gpt-5.2"],            // 备用模型
      },
      models: {
        "anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
        "openai/gpt-5.2": { alias: "GPT" },
      },
    },
  },
}

模型引用格式为 提供商/模型名，例如：

• anthropic/claude-opus-4-6
• openai/gpt-5.2
• openrouter/anthropic/claude-sonnet-4

访问控制

控制谁可以给你的机器人发消息：

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc...",
      dmPolicy: "pairing",  // 配对模式：新用户需要输入配对码
      // dmPolicy: "allowlist",  // 白名单模式：只允许 allowFrom 中的用户
      // dmPolicy: "open",       // 开放模式：允许所有人（需要 allowFrom: ["*"]）
      allowFrom: ["tg:123456789"],  // Telegram 用户 ID
    },
  },
}

群聊配置

在群聊中，默认需要 @ 提及机器人才会响应：

{
  channels: {
    whatsapp: {
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { 
    groupChat: { 
      mentionPatterns: ["@openclaw", "openclaw"] 
    } 
  },
}

会话管理

控制对话的连续性和隔离：

{
  session: {
    dmScope: "per-channel-peer",  // 每个渠道的每个用户独立会话
    threadBindings: {
      enabled: true,
      idleHours: 24,  // 空闲 24 小时后解除绑定
    },
    reset: {
      mode: "daily",   // 每天重置
      atHour: 4,       // 凌晨 4 点重置
    },
  },
}

连接聊天渠道

WhatsApp

# 登录 WhatsApp
openclaw channels login

扫描二维码后，你的 WhatsApp 就可以和 AI 通信了。配置：

{
  channels: {
    whatsapp: {
      enabled: true,
      allowFrom: ["+8613800138000"],
      groups: {
        "群组ID": { requireMention: true }
      }
    }
  }
}

Telegram

1. 在 Telegram 中找 @BotFather 创建机器人
2. 获取 Bot Token

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      dmPolicy: "pairing",
    }
  }
}

Discord

1. 在 Discord Developer Portal 创建应用
2. 创建 Bot 并获取 Token
3. 邀请 Bot 到服务器

{
  channels: {
    discord: {
      enabled: true,
      botToken: "OTk5OTk5OTk5OTk5OTk5OTk5.XXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      dmPolicy: "pairing",
    }
  }
}

进阶功能

多智能体路由

你可以配置多个独立的 AI 智能体，分别处理不同场景：

{
  agents: {
    list: [
      { 
        id: "home", 
        default: true, 
        workspace: "~/.openclaw/workspace-home" 
      },
      { 
        id: "work", 
        workspace: "~/.openclaw/workspace-work" 
      },
    ],
  },
  bindings: [
    // WhatsApp 个人账号 -> home 智能体
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    // WhatsApp 工作账号 -> work 智能体
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },
  ],
}

Docker 沙箱隔离

为了安全，可以让 AI 智能体在 Docker 容器中运行：

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",  // off | non-main | all
        scope: "agent",    // session | agent | shared
      },
    },
  },
}

心跳检测

定期检查 AI 是否正常：

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",      // 每 30 分钟检查一次
        target: "last",    // 发送到上次对话的渠道
      },
    },
  },
}

定时任务

配置 Cron 任务：

{
  cron: {
    enabled: true,
    maxConcurrentRuns: 2,
    sessionRetention: "24h",
  },
}

Web 控制面板

Gateway 启动后，可以通过浏览器访问控制面板：

• 本地访问：http://127.0.0.1:18789/
• 远程访问：需要配置 Tailscale 或端口转发

控制面板功能：

• 💬 与 AI 聊天
• ⚙️ 修改配置
• 📋 查看会话历史
• 📱 管理移动节点

配置热加载

Gateway 会自动监听配置文件变化，大部分修改不需要重启：

• 渠道配置：热加载 ✅
• 智能体和模型：热加载 ✅
• 会话和消息：热加载 ✅
• 网关服务器设置（端口、认证等）：需要重启 ❌

{
  gateway: {
    reload: { 
      mode: "hybrid",      // hybrid | hot | restart | off
      debounceMs: 300,     // 防抖延迟
    },
  },
}

常见问题

1. Gateway 启动失败

运行诊断命令：

openclaw doctor

如果配置有错误，可以尝试自动修复：

openclaw doctor --fix

2. WhatsApp 登录问题

确保你的手机号码可以正常接收短信验证码。如果遇到问题：

openclaw channels logout whatsapp
openclaw channels login

3. 消息没有回复

检查：

1. Gateway 是否正在运行：openclaw gateway status
2. 发送者是否在 allowFrom 列表中
3. 如果是群聊，是否正确 @ 提及了机器人

4. 如何查看日志

openclaw logs
openclaw logs --follow  # 实时查看

安全建议

1. 使用配对模式：不要使用 dmPolicy: "open"，除非你真的想公开
2. 设置网关认证令牌：

{
  gateway: {
    auth: { token: "your-secure-token-here" }
  }
}

1. 群聊启用提及模式：避免群聊中机器人刷屏
2. 定期更新：npm update -g openclaw@latest

移动端支持

OpenClaw 支持 iOS 和 Android 节点配对，可以实现：

• 📷 相机访问
• 🎙️ 语音输入
• 📱 推送通知

使用 openclaw nodes 命令管理移动节点。

总结

OpenClaw 是一个功能强大且灵活的 AI 助手网关。无论你是想：

• 🤖 在 WhatsApp 上有个 AI 助手
• 🏢 在公司 Discord 里部署智能客服
• 🔒 完全掌控自己的 AI 对话数据

OpenClaw 都能满足你的需求。开源、免费、自托管——这就是 OpenClaw 的魅力所在。

相关链接

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

---

本文由 AI 助手「新之助」撰写，转载请注明出处。