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

为什么值得了解 OpenClaw
如果你想要一个运行在自己设备或服务器上的 AI 助手,同时又希望它能接入你已经在用的聊天工具,OpenClaw 会是一个很有吸引力的选择。
OpenClaw 本质上是一个 自托管 AI 网关。它负责把 WhatsApp、Telegram、Discord、飞书、微信等聊天平台和你选择的 AI 模型连接起来。你在聊天软件里发消息,OpenClaw 收到后调用模型,再把回复发回聊天软件。
这意味着你既能保留熟悉的使用方式,也能获得更强的隐私控制、更灵活的模型选择,以及更高的可定制性。
OpenClaw 和 ChatGPT、Claude 有什么不同
| 对比维度 | OpenClaw | ChatGPT / Claude |
|---|---|---|
| 数据控制 | 自己掌控部署与数据流 | 主要依赖云端服务 |
| 平台接入 | 可接入多个聊天平台 | 通常只在官方 App / Web 中使用 |
| 模型选择 | 可切换多家模型提供方 | 通常绑定单一平台 |
| 可定制性 | 支持插件、系统提示词、渠道配置 | 自定义空间较有限 |
| 部署方式 | 自托管 | 官方托管 |
如果你更看重隐私、可扩展性,或者想让同一个 AI 助手同时服务多个渠道,OpenClaw 会更适合你。
第一部分:5 分钟快速安装
OpenClaw 支持主流操作系统。最简单的方式是直接使用官方安装脚本。
系统要求
Node.js:推荐24.x,22.14+也可以- 内存:至少
2GB - 磁盘:至少
1GB可用空间 - 网络:如果使用云端模型,需要能访问对应模型 API
macOS / Linux
打开终端运行:
curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本通常会自动完成这些步骤:
- 检测当前系统环境
- 在缺少 Node.js 时自动安装
- 安装 OpenClaw CLI
- 引导你进入初始配置
Windows
推荐优先使用 WSL2,稳定性通常更好。
WSL2 安装方式:
- 从 Microsoft Store 安装 Ubuntu
- 打开 WSL 终端
- 运行同样的安装脚本
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 机器人配置
- 打开 Telegram,搜索
@BotFather - 发送
/newbot - 按提示输入机器人名称和用户名
- 获取返回的
Bot Token
在 OpenClaw 中启用 Telegram
先打开配置文件:
openclaw config edit
加入 Telegram 插件配置:
{
plugins: {
telegram: {
botToken: "YOUR_BOT_TOKEN"
}
}
}
保存后重启:
openclaw restart
然后回到 Telegram 给机器人发送一条消息,例如:
hello
如果能收到 AI 回复,说明你的第一条对话已经打通。
其他常见平台
Discord
- 打开 Discord Developer Portal
- 创建 Application
- 添加 Bot 并复制 Token
- 在 OpenClaw 里写入
token和clientId
飞书
先安装插件:
openclaw plugins install feishu
然后补充 appId、appSecret 等配置即可。
WhatsApp / iMessage
这类平台通常需要额外桥接方案,比如 BlueBubbles。更适合在基础安装完成后再继续扩展。
第四部分:发送第一条消息
一旦平台配置完成,你就可以像平时聊天一样直接和机器人对话。
OpenClaw 背后会自动完成以下流程:
- 接收来自聊天平台的消息
- 选择当前配置的模型
- 调用模型生成回复
- 把回复发回原聊天平台
可以试试这些消息:
你是谁?
请用英文做个自我介绍
写一个 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 工具、教程和行业洞见,直达你的邮箱。
支付宝扫码赞赏
感谢支持 ❤️