OpenClaw 完整入门指南:5 分钟搭建你的个人 AI 助手

从零开始安装和配置 OpenClaw,连接 WhatsApp、Telegram、Discord 等聊天平台,快速搭建属于你自己的 AI 助手。

#OpenClaw#自托管#AI 助手#本地部署#隐私保护#多平台

whatYouLearn:

  • “什么是 OpenClaw,它和 ChatGPT、Claude 有什么区别”
  • “如何在 macOS、Linux、Windows 上快速安装 OpenClaw”
  • “如何配置 OpenAI、Anthropic、Ollama 等模型”
  • “如何连接 Telegram、Discord、飞书等聊天平台”
  • “如何发送第一条消息并完成基础自定义” keyTakeaways:
  • “OpenClaw 是自托管 AI 助手网关,数据由你自己掌控”
  • “支持 20+ 聊天平台,一个助手可以同时服务多个入口”
  • “安装和 onboarding 流程清晰,适合快速上手”
  • “可以随时切换 AI 模型,不被单一提供商绑定”

OpenClaw 中文入门封面

为什么值得了解 OpenClaw

如果你想要一个运行在自己设备或服务器上的 AI 助手,同时又希望它能接入你已经在用的聊天工具,OpenClaw 会是一个很有吸引力的选择。

OpenClaw 本质上是一个 自托管 AI 网关。它负责把 WhatsApp、Telegram、Discord、飞书、微信等聊天平台和你选择的 AI 模型连接起来。你在聊天软件里发消息,OpenClaw 收到后调用模型,再把回复发回聊天软件。

这意味着你既能保留熟悉的使用方式,也能获得更强的隐私控制、更灵活的模型选择,以及更高的可定制性。

OpenClaw 和 ChatGPT、Claude 有什么不同

对比维度OpenClawChatGPT / Claude
数据控制自己掌控部署与数据流主要依赖云端服务
平台接入可接入多个聊天平台通常只在官方 App / Web 中使用
模型选择可切换多家模型提供方通常绑定单一平台
可定制性支持插件、系统提示词、渠道配置自定义空间较有限
部署方式自托管官方托管

如果你更看重隐私、可扩展性,或者想让同一个 AI 助手同时服务多个渠道,OpenClaw 会更适合你。


第一部分:5 分钟快速安装

OpenClaw 支持主流操作系统。最简单的方式是直接使用官方安装脚本。

系统要求

  • Node.js:推荐 24.x22.14+ 也可以
  • 内存:至少 2GB
  • 磁盘:至少 1GB 可用空间
  • 网络:如果使用云端模型,需要能访问对应模型 API

macOS / Linux

打开终端运行:

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

安装脚本通常会自动完成这些步骤:

  1. 检测当前系统环境
  2. 在缺少 Node.js 时自动安装
  3. 安装 OpenClaw CLI
  4. 引导你进入初始配置

Windows

推荐优先使用 WSL2,稳定性通常更好。

WSL2 安装方式:

  1. 从 Microsoft Store 安装 Ubuntu
  2. 打开 WSL 终端
  3. 运行同样的安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

如果你想原生安装,也可以使用 PowerShell:

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

验证是否安装成功

openclaw --version

如果输出类似下面的版本号,说明 CLI 已经安装成功:

OpenClaw 2026.3.24

第二部分:完成 Onboarding 初始配置

运行:

openclaw onboard --install-daemon

整个引导流程通常只需要 2 分钟左右。

1. 选择 AI 模型提供方

OpenClaw 支持很多模型来源,例如:

  • OpenAI
  • Anthropic
  • Google Gemini
  • Azure OpenAI
  • Ollama / LocalAI / LM Studio 等本地模型

第一次上手时,建议先选 OpenAI 或 Anthropic,配置起来最直接。

2. 生成 Gateway Token

Onboarding 会帮你生成一个 Gateway Token,它相当于你的管理凭证。请妥善保存。

3. 安装为系统服务

--install-daemon 会把 OpenClaw 安装成系统服务,方便开机自动启动。

如果你更喜欢手动控制,也可以不加这个参数。

4. 检查运行状态

openclaw status

查看日志:

openclaw logs

如果日志里能看到服务启动成功的信息,就说明网关已经工作正常。


第三部分:连接第一个聊天平台

OpenClaw 支持很多聊天平台。最适合入门演示的通常是 Telegram。

Telegram 机器人配置

  1. 打开 Telegram,搜索 @BotFather
  2. 发送 /newbot
  3. 按提示输入机器人名称和用户名
  4. 获取返回的 Bot Token

在 OpenClaw 中启用 Telegram

先打开配置文件:

openclaw config edit

加入 Telegram 插件配置:

{
  plugins: {
    telegram: {
      botToken: "YOUR_BOT_TOKEN"
    }
  }
}

保存后重启:

openclaw restart

然后回到 Telegram 给机器人发送一条消息,例如:

hello

如果能收到 AI 回复,说明你的第一条对话已经打通。

其他常见平台

Discord

  1. 打开 Discord Developer Portal
  2. 创建 Application
  3. 添加 Bot 并复制 Token
  4. 在 OpenClaw 里写入 tokenclientId

飞书

先安装插件:

openclaw plugins install feishu

然后补充 appIdappSecret 等配置即可。

WhatsApp / iMessage

这类平台通常需要额外桥接方案,比如 BlueBubbles。更适合在基础安装完成后再继续扩展。


第四部分:发送第一条消息

一旦平台配置完成,你就可以像平时聊天一样直接和机器人对话。

OpenClaw 背后会自动完成以下流程:

  1. 接收来自聊天平台的消息
  2. 选择当前配置的模型
  3. 调用模型生成回复
  4. 把回复发回原聊天平台

可以试试这些消息:

你是谁?
请用英文做个自我介绍
写一个 Python 快速排序
北京今天什么天气?

第五部分:基础自定义

OpenClaw 的很多行为都可以通过配置文件调整。

修改助手名称和头像

openclaw config edit

例如:

{
  agent: {
    name: "XiaoKun",
    avatar: "https://example.com/avatar.png",
    systemPrompt: "You are a helpful AI assistant. Be concise."
  }
}

设置系统提示词

系统提示词会直接影响助手的风格和行为。

示例:

{
  agent: {
    systemPrompt: `
你是鲲鹏 AI 的技术助手,帮助开发者解决 AI / ML 相关问题。

你的风格:
- 回答简洁
- 尽量提供可执行示例
- 不确定时明确说明
- 技术问题保持专业
    `.trim()
  }
}

为不同渠道设置不同人格

{
  channels: {
    telegram: {
      agent: {
        name: "Telegram Assistant",
        systemPrompt: "在 Telegram 中回复更短,适合手机阅读。"
      }
    },
    discord: {
      agent: {
        name: "Discord Bot",
        systemPrompt: "在 Discord 中可以更活泼一些。"
      }
    }
  }
}

第六部分:常用命令

openclaw status
openclaw logs
openclaw restart
openclaw config edit
openclaw plugins list
openclaw plugins install <plugin-name>
openclaw plugins uninstall <plugin-name>
openclaw agent --message "your message"
openclaw update
openclaw doctor

FAQ

OpenClaw 和普通聊天机器人有什么区别?

OpenClaw 不只是一个 bot,更像是一个 AI 助手网关。它负责渠道接入、模型调度、插件管理和自动化流程编排。

可以接本地模型吗?比如 Ollama?

可以。你可以在 onboarding 阶段直接选择 Ollama,也可以手动配置:

{
  models: {
    default: {
      provider: "ollama",
      model: "qwen2.5:7b",
      baseURL: "http://127.0.0.1:11434"
    }
  }
}

OpenClaw 适合谁?

如果你属于下面几类人,这个项目会很值得试:

  • 想把 AI 助手运行在自己的设备或服务器上
  • 想同时接入多个聊天平台
  • 想对模型、提示词、权限和插件有更高控制权
  • 想基于现有聊天入口快速做个人 AI 工作流

总结

OpenClaw 的价值不在于“再做一个聊天机器人”,而在于它把聊天平台、模型、插件和自动化连接成了一套可以自己掌控的系统。

如果你想要一个真正属于自己的 AI 助手,而不是只能依赖某个官方 App,OpenClaw 是一个非常值得动手尝试的起点。

订阅 AI 前沿速递

每周精选 AI 工具、教程和行业洞见,直达你的邮箱。