完完整整教你用OpenClaw搭建AI助手:从零到可用的完整教程
你是否想过在微信上发条消息,AI就能帮你查资料、总结文件、定时提醒事情?
这篇文章手把手教你用OpenClaw实现——一个完全开源、自托管的AI网关工具。数据存在你自己电脑上,支持微信、Telegram、Discord、WhatsApp等几十种渠道调用AI。
第一部分:环境准备
1.1 安装Node.js
如果显示版本号(比如v24.x.x或v22.x.x),说明已经装了。
去 https://nodejs.org 下载LTS版本(推荐24.x,没有就用22.x)
装好后重新打开PowerShell,执行上面的命令验证
推荐用nvm管理版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
curl -fsSL https://fnm.vercel.app/install | bash
1.2 准备AI的API Key
OpenClaw本身免费,但你需要提供自己的AI API Key(用多少付多少)。
OpenAI(ChatGPT)— https://platform.openai.com/api-keys
Anthropic(Claude)— https://console.anthropic.com
Google(Gemini)— https://aistudio.google.com/app/apikey
Moonshot(月之暗面)— https://platform.moonshot.cn
Minimax(稀宇科技)— https://platform.minimaxi.com
建议: 先去OpenAI或Anthropic官网注册账号,充值5-10美元,获取API Key(格式类似sk-xxxxx)。刚开始用不了多少钱。
第二部分:安装OpenClaw
2.1 一行命令安装
打开终端(Windows用PowerShell,Mac/Linux用终端),执行:
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
npm install -g openclaw@latest
2.2 验证安装成功
应该看到版本号,比如openclaw v1.x.x。
第三部分:初始化配置(最关键的一步)
openclaw onboard –install-daemon
选择模式 — 选QuickStart(默认)或Advanced
选一个,粘贴你的API Key(比如sk-xxx)
OpenAI选gpt-4o或gpt-4o-mini
Anthropic选claude-sonnet-4-6或claude-opus-4-6
Mac/Linux会配置systemd或launchd
第四部分:启动和使用控制界面
4.1 启动网关
Gateway is running on http://127.0.0.1:18789
4.2 打开控制界面
在浏览器打开:http://127.0.0.1:18789
第五部分:连接微信(详细步骤)
这是大家最关心的。以Windows为例,假设你已经在第三部分初始化时跳过了渠道配置,现在单独配置微信。
5.1 安装微信插件
openclaw channels add –channel wechat
它会提示安装@openclaw/wechat插件,确认安装。
5.2 配置文件位置
配置文件在:~/.openclaw/openclaw.json
~在Windows里指C:\Users\你的用户名\AppData\Roaming\
5.3 配置微信权限
编辑配置文件~/.openclaw/openclaw.json,添加或修改:
dmPolicy: “pairing” — 新人需要你批准才能对话
allowFrom: [“*”] — 允许所有人(最宽松)
想只允许特定人:把”*”改成手机号,比如”+86138xxxx1234″
openclaw config set channels.wechat.enabled true
openclaw config set channels.wechat.dmPolicy “pairing”
5.4 扫码登录微信
openclaw channels login –channel wechat
微信会踢掉其他设备的登录,扫了之后那个号只能在这个电脑登录
5.5 批准对话
openclaw pairing list wechat
openclaw pairing approve wechat <验证码>
5.6 测试
第六部分:连接Telegram(最快的方法)
如果微信登录有问题,Telegram是最快能跑起来的。
6.1 创建Bot
打开Telegram,找到**@BotFather**(注意确认是这个官方账号)
按提示给机器人起名字(比如MyAIAssistant)
起一个username(必须以bot结尾,比如my_ai_assistant_bot)
保存好Token,格式类似:123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
6.2 配置Telegram
编辑~/.openclaw/openclaw.json:
“*”: { requireMention: true }
botToken:刚才从BotFather拿到的Token
dmPolicy: “pairing” — 需要批准才能对话
requireMention: true — 群聊里必须@机器人才会回复
6.3 重启网关让配置生效
6.4 批准对话
openclaw pairing list telegram
openclaw pairing approve telegram <验证码>
6.5 使用
在Telegram搜你创建的机器人用户名,点击开始聊天,AI就会回复你了!
第七部分:设置每日自动任务
这是OpenClaw非常强大的功能。比如每天早上7点自动发天气。
7.1 创建定时任务
–message “查询武汉当天天气,用温柔的语气提醒用户注意什么” \
–message “搜索当天AI科技新闻,写成150字摘要” \
–message “提醒用户这周的重要待办事项” \
7.2 Cron表达式解释
│ │ │ │ └─ 星期几 (0-7,0和7都是周日)
7.3 管理定时任务
第八部分:手机配对(iOS/Android)
8.1 下载APP
Android:Google Play或应用商店搜”OpenClaw”
8.2 配对
8.3 手机端功能
第九部分:常见问题汇总
完全安全。 OpenClaw是自托管的,所有数据都存在你自己的电脑上(~/.openclaw/目录),不经过任何第三方服务器。你可以随时查看和删除数据。
是的。 OpenClaw需要一台电脑或服务器一直运行。电脑关机后AI就收不到消息了。
解决方案: 买一个低功耗VPS(每月几十块),把OpenClaw装在VPS上,这样随时随地都能用。
OpenClaw本身免费,但AI需要用你的API Key。每次调用AI会消耗API配额。
能。 跟着上面的步骤做就行。高级功能(自定义工作流、写插件)需要编程基础,但基本功能有手就行。
查看日志:openclaw logs –follow
看官方文档的故障排除:https://docs.openclaw.ai/channels/troubleshooting
第十部分:进阶功能(可选)
10.1 配置多个AI模型
primary: “openai/gpt-4o”,
fallbacks: [“anthropic/claude-sonnet-4-6”]
10.2 限制谁能发消息
allowFrom: [“tg:123456789”] // 你的Telegram ID
10.3 设置技能
OpenClaw有各种技能(比如天气查询、GitHub集成):
查看可用的技能
安装技能
openclaw skills install weather
10.4 更多渠道
OpenClaw支持几十种渠道,详见:https://docs.openclaw.ai/channels
第十一部分:完整配置文件示例
给你一个完整的配置文件参考,保存在~/.openclaw/openclaw.json:
primary: “openai/gpt-4o”,
fallbacks: [“anthropic/claude-sonnet-4-6”]
workspace: “~/.openclaw/workspace”
第十二部分:结语
OpenClaw的本质是:让你用自己的AI API,通过任何一个你常用的聊天工具调用AI。
它不像那些SaaS服务——你的数据是你的,规则是你定的,不用看任何人脸色。
去 https://openclaw.ai 或 https://docs.openclaw.ai 查看官方文档