5分钟搭建自己的AI网关OpenClaw从入门到精通完整教程

5分钟搭建自己的AI网关：OpenClaw从入门到精通完整教程

自己托管AI服务，微信、Telegram、Discord都能用，数据完全自己掌控。

写在前面

你是否遇到过这些烦恼：

  • 想在微信上用AI助手，但ChatGPT国内用不了
  • 每个平台都要单独配置AI，太麻烦
  • 担心隐私问题，不想把数据发给第三方

今天我要分享一个开源神器——OpenClaw，这些问题一次性全部解决！

我已经用了一段时间，真的太强大了，今天把完整的使用经验分享出来。

OpenClaw到底是什么

定义

OpenClaw是一个自托管的AI网关，简单说就是：

在你自己的电脑上运行一个服务，连接各种聊天软件和AI模型。

你发微信、AI在那边回复；你发Telegram、AI也能回复。所有通道统一管理，一次部署，全部搞定。

核心特点

特点 说明
自托管 运行在自己电脑上，数据不经过第三方
多通道 同时支持微信、Telegram、Discord等20+平台
开源免费 MIT协议，代码完全开放
插件丰富 支持飞书、Slack、Signal、Mattermost等
能力强大 支持浏览器控制、文件操作、代码执行

谁适合用

  • 技术人员：想自己托管AI服务
  • 开发者：需要多通道AI集成
  • 注重隐私：不想数据经过第三方
  • 效率控：想统一管理多个聊天平台

环境准备

系统要求

  • Node.js 22或更高版本
  • 至少2GB可用内存
  • 支持 macOS / Linux / Windows (推荐WSL2)

检查Node版本

node --version

如果版本低于22，需要升级：

# macOS/Linux 用nvm升级
nvm install 22
nvm use 22

# 或直接安装
# https://nodejs.org/

安装步骤（图文详解）

第一步：安装OpenClaw

macOS/Linux：

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

Windows (PowerShell)：

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

安装成功后，会显示版本信息：

✅ OpenClaw installed successfully!
Version: x.x.x

第二步：初始化配置

运行引导向导：

openclaw onboard --install-daemon

这个命令会一步步问你问题，我们来详细看看：

2.1 选择模式

QuickStart (默认配置) vs Advanced (高级配置)

新手建议选QuickStart，会自动配置以下内容：

  • 本地网关（loopback模式）
  • 默认工作区
  • 网关端口18789
  • 自动生成认证Token
  • Telegram + WhatsApp

2.2 选择AI模型

官方推荐Anthropic（Claude），也可以选：

  • OpenAI (GPT-4)
  • 自定义 provider

输入你的API Key即可。

2.3 配置工作区

工作区用来存放AI的文件和配置：

默认位置: ~/.openclaw/workspace

可以修改为其他位置。

2.4 配置网关

  • 端口：默认18789
  • 绑定地址：默认loopback（本地）
  • 认证模式：Token自动生成

2.5 选择聊天通道

可以选择要连接的通道：

  • Telegram
  • WhatsApp
  • Discord
  • Google Chat
  • Signal
  • 等等

2.6 安装服务（后台运行）

macOS: 安装LaunchAgent
Linux: 安装systemd用户服务

这样电脑重启后AI服务也会自动启动。

第三步：验证安装

3.1 检查网关状态

openclaw gateway status

显示以下信息说明成功了：

Runtime: running
RPC probe: ok

3.2 启动控制台

openclaw dashboard

然后打开浏览器访问 http://127.0.0.1:18789/

你就能看到控制界面，可以直接和AI对话了！

Telegram配置详解（手把手教学）

Telegram是最容易配置的通道，我详细说说每一步。

第一步：创建机器人

  1. 打开Telegram
  2. 搜索 @BotFather（注意确认是小蓝勾认证的）
  3. 发送 /newbot
  4. 按提示输入机器人名称（比如"我的AI助手"）
  5. 用户名必须是bot结尾（比如 myai_bot）
  6. 完成后会收到一个 Token，类似这样：
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

⚠️ 这个Token要保存好，不要告诉别人！

第二步：配置Token

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

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Token",
      "dmPolicy": "pairing"
    }
  }
 }

或者用环境变量：

export TELEGRAM_BOT_TOKEN="你的Token"

第三步：启动网关

openclaw gateway

第四步：配对（重要！）

当有人第一次给你机器人发消息时，需要批准。

  1. 查看配对请求：
openclaw pairing list telegram

会显示一个配对码，比如 EQ6N675F

  1. 批准配对：
openclaw pairing approve telegram EQ6N675F

配对码1小时内有效。

第五步：开始使用

现在去Telegram给你的机器人发消息，AI就会回复了！

进阶配置

配置多个通道

可以同时配置Telegram和WhatsApp：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Token"
    },
    "whatsapp": {
      "enabled": true
    },
    "discord": {
      "enabled": true,
      "botToken": "Discord机器人Token"
    }
  }
}

浏览器控制

如果你想让AI能操作浏览器，需要开启：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw"
  }
}

然后可以使用以下命令：

# 启动浏览器
openclaw browser --browser-profile openclaw start

# 打开网页
openclaw browser --browser-profile openclaw open https://example.com

# 截图
openclaw browser --browser-profile openclaw screenshot

技能（Skills）

Skills让AI能使用各种工具：

# 查看已安装的技能
openclaw skills list

# 安装新技能（需要先安装clawhub）
clawhub install 技能名称

常用命令大全

网关命令

命令 作用
openclaw gateway 启动网关
openclaw gateway --port 18789 指定端口启动
openclaw gateway --verbose 显示详细日志
openclaw gateway --force 强制占用端口启动
openclaw gateway status 查看状态
openclaw gateway stop 停止网关
openclaw gateway restart 重启网关

通道命令

命令 作用
openclaw channels status 查看通道状态
openclaw channels login 登录通道

配对命令

命令 作用
openclaw pairing list 查看配对请求
openclaw pairing approve <通道> <代码> 批准配对
openclaw pairing reject <通道> <代码> 拒绝配对

日志命令

命令 作用
openclaw logs 查看日志
openclaw logs --follow 实时跟踪日志

远程访问

方法一：Tailscale（推荐）

  1. 安装Tailscale
  2. 连接到你的网络
  3. 用Tailscale IP访问

方法二：SSH隧道

ssh -N -L 18789:127.0.0.1:18789 user@你的服务器

然后本地访问 ws://127.0.0.1:18789

方法三：修改绑定地址

如果想从外网访问，可以修改配置：

{
  "gateway": {
    "bind": "0.0.0.0"
  }
}

⚠️ 危险提醒：外网访问一定要设置认证！

故障排除

问题1：网关启动失败

# 强制杀死占用端口的进程
openclaw gateway --force

问题2：Token无效

重新获取Token，确保配置正确。

问题3：收不到消息

  1. 检查网关是否运行
  2. 检查通道是否启用
  3. 查看日志：openclaw logs

问题4：权限问题

运行诊断：

openclaw doctor

会自动检测并修复常见问题。

我的完整配置参考

这是我的生产配置文件，供大家参考：

{
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "auth": {
      "token": "env:OPENCLAW_TOKEN"
    },
    "reload": {
      "mode": "hybrid"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "env:TELEGRAM_BOT_TOKEN",
      "dmPolicy": "pairing"
    }
  },
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "headless": false
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-3-5-sonnet-20241022"
    }
  }
}

使用感受

用了一段时间OpenClaw，我的感受是：

  1. 配置简单：5分钟就能跑起来
  2. 功能强大：多通道+浏览器+技能
  3. 数据安全：完全自托管，隐私无忧
  4. 扩展性强：社区有很多插件

唯一缺点是：

  • 需要自己维护服务器
  • 一些高级功能需要技术基础

但对于技术人员来说，这简直是神器！

总结

OpenClaw让每个人都能自己托管AI服务：

  1. 安装简单：一行命令搞定
  2. 配置灵活：想要什么功能自己选
  3. 多通道统一：微信Telegram Discord一次搞定
  4. 数据自主：完全掌控在自己手里

如果你也想摆脱对第三方AI服务的依赖，强烈建议试试OpenClaw！

作者：棒棒金

posted @ 2026-02-27 06:43  macdwww  阅读(549)  评论(0)    收藏  举报