乐于分享
好东西不私藏

完完整整教你用OpenClaw搭建AI助手:从零到可用的完整教程

完完整整教你用OpenClaw搭建AI助手:从零到可用的完整教程

你是否想过在微信上发条消息,AI就能帮你查资料、总结文件、定时提醒事情?

这篇文章手把手教你用OpenClaw实现——一个完全开源、自托管的AI网关工具。数据存在你自己电脑上,支持微信、Telegram、Discord、WhatsApp等几十种渠道调用AI。
全文5000字+,跟着做一定能跑通。

第一部分:环境准备

在安装OpenClaw之前,你需要准备两样东西。

1.1 安装Node.js

OpenClaw需要Node.js运行环境。
检查是否已安装:
Copy
node –version
如果显示版本号(比如v24.x.x或v22.x.x),说明已经装了。
如果没装,Windows用户:
去 https://nodejs.org 下载LTS版本(推荐24.x,没有就用22.x)
安装时一路点”Next”就行
装好后重新打开PowerShell,执行上面的命令验证
Mac用户:
Copy

推荐用nvm管理版本

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc
nvm install 24
Linux/WSL用户:
Copy
curl -fsSL https://fnm.vercel.app/install | bash
fnm install 24

1.2 准备AI的API Key

OpenClaw本身免费,但你需要提供自己的AI API Key(用多少付多少)。
目前支持的AI提供商:
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用终端),执行:
Mac/Linux:
Copy
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell):
Copy
iwr -useb https://openclaw.ai/install.ps1 | iex
或者用npm(上面都失败时用):
Copy
npm install -g openclaw@latest

2.2 验证安装成功

Copy
openclaw –version
应该看到版本号,比如openclaw v1.x.x。

第三部分:初始化配置(最关键的一步)

执行初始化向导,它会帮你配置AI模型和渠道:
Copy
openclaw onboard –install-daemon
向导会依次问你:
选择模式 — 选QuickStart(默认)或Advanced
QuickStart:默认配置,快速上手
Advanced:自己选每个选项
选择AI提供商 — 输入你的API Key
它会列出支持的提供商
选一个,粘贴你的API Key(比如sk-xxx)
选择默认模型
OpenAI选gpt-4o或gpt-4o-mini
Anthropic选claude-sonnet-4-6或claude-opus-4-6
模型后面标注了价格,选个够用便宜的就行
配置网关
端口:默认18789,直接回车
认证:默认生成token,直接回车
选择渠道(这步可以跳过,后续再配)
可以选微信、Telegram、Discord等
先选Skip跳过,后续单独配置
安装系统服务
Windows选是,让OpenClaw开机自启
Mac/Linux会配置systemd或launchd
启动并验证
向导会自动启动网关
然后验证是否正常运行

第四部分:启动和使用控制界面

4.1 启动网关

方式一:前台运行(调试用)
Copy
openclaw gateway
会看到一堆日志,表明网关正在运行。
方式二:后台运行(长期运行)
Copy
openclaw gateway start
检查状态:
Copy
openclaw gateway status
成功的话显示类似:
Copy
Gateway is running on http://127.0.0.1:18789

4.2 打开控制界面

在浏览器打开:http://127.0.0.1:18789
这就是OpenClaw的控制面板,你可以:
在网页上直接和AI聊天
配置各种设置
查看历史会话
管理已连接的渠道
或者用命令打开:
Copy
openclaw dashboard

第五部分:连接微信(详细步骤)

这是大家最关心的。以Windows为例,假设你已经在第三部分初始化时跳过了渠道配置,现在单独配置微信。

5.1 安装微信插件

执行:
Copy
openclaw channels add –channel wechat
它会提示安装@openclaw/wechat插件,确认安装。

5.2 配置文件位置

配置文件在:~/.openclaw/openclaw.json
~在Windows里指C:\Users\你的用户名\AppData\Roaming\
查看现有配置:
Copy
openclaw config get

5.3 配置微信权限

编辑配置文件~/.openclaw/openclaw.json,添加或修改:
Copy
{
channels: {
wechat: {
enabled: true,
dmPolicy: “pairing”,
allowFrom: [“*”]
}
}
}
配置解释:
dmPolicy: “pairing” — 新人需要你批准才能对话
allowFrom: [“*”] — 允许所有人(最宽松)
想只允许特定人:把”*”改成手机号,比如”+86138xxxx1234″
另一种方式:用命令配置
Copy
openclaw config set channels.wechat.enabled true
openclaw config set channels.wechat.dmPolicy “pairing”

5.4 扫码登录微信

Copy
openclaw channels login –channel wechat
会显示:
一个二维码图片(会弹窗显示,或者在控制界面显示)
用你要绑定的微信扫码
重要提醒:
建议用专门的微信号,别用生活号
微信会踢掉其他设备的登录,扫了之后那个号只能在这个电脑登录

5.5 批准对话

有人给你发微信时,你需要批准。
你的微信会收到一个验证码
或者在控制界面可以看到待审批列表
查看待审批:
Copy
openclaw pairing list wechat
批准对方:
Copy
openclaw pairing approve wechat <验证码>

5.6 测试

现在在微信上给这个号发消息:
“你好”
AI应该会自动回复你!

第六部分:连接Telegram(最快的方法)

如果微信登录有问题,Telegram是最快能跑起来的。

6.1 创建Bot

打开Telegram,找到**@BotFather**(注意确认是这个官方账号)
发送/newbot
按提示给机器人起名字(比如MyAIAssistant)
起一个username(必须以bot结尾,比如my_ai_assistant_bot)
保存好Token,格式类似:123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

6.2 配置Telegram

编辑~/.openclaw/openclaw.json:
Copy
{
channels: {
telegram: {
enabled: true,
botToken: “你的Token”,
dmPolicy: “pairing”,
groups: {
“*”: { requireMention: true }
}
}
}
}
配置解释:
botToken:刚才从BotFather拿到的Token
dmPolicy: “pairing” — 需要批准才能对话
requireMention: true — 群聊里必须@机器人才会回复

6.3 重启网关让配置生效

Copy
openclaw gateway restart

6.4 批准对话

Copy
openclaw pairing list telegram
openclaw pairing approve telegram <验证码>

6.5 使用

在Telegram搜你创建的机器人用户名,点击开始聊天,AI就会回复你了!

第七部分:设置每日自动任务

这是OpenClaw非常强大的功能。比如每天早上7点自动发天气。

7.1 创建定时任务

命令格式:
Copy
openclaw cron add \
–name “任务名字” \
–cron “0 7 * * *” \
–message “让AI做什么” \
–channel wechat
例子:每天早上7点天气提醒
Copy
openclaw cron add \
–name “武汉天气提醒” \
–cron “0 7 * * *” \
–message “查询武汉当天天气,用温柔的语气提醒用户注意什么” \
–channel wechat
例子:每天早上9点新闻摘要
Copy
openclaw cron add \
–name “每日AI资讯” \
–cron “0 9 * * *” \
–message “搜索当天AI科技新闻,写成150字摘要” \
–channel wechat
例子:每周一早上9点
Copy
openclaw cron add \
–name “周一计划提醒” \
–cron “0 9 * * 1” \
–message “提醒用户这周的重要待办事项” \
–channel wechat

7.2 Cron表达式解释

0 7 * * *是什么意思?
Copy
┬ ┬ ┬ ┬ ┬
│ │ │ │ │
│ │ │ │ └─ 星期几 (0-7,0和7都是周日)
│ │ │ └─── 月份 (1-12)
│ │ └───── 日期 (1-31)
│ └────── 小时 (0-23)
└──────── 分钟 (0-59)
常用例子:
0 7 * * * = 每天早上7:00
0 9 * * 1-5 = 工作日早上9:00
0 7 * * 0 = 每周日早上7:00
*/30 * * * * = 每30分钟

7.3 管理定时任务

查看所有任务:
Copy
openclaw cron list
立即运行某个任务(测试用):
Copy
openclaw cron run
删除任务:
Copy
openclaw cron remove
查看任务运行历史:
Copy
openclaw cron runs

第八部分:手机配对(iOS/Android)

配对后手机可以远程使用AI,还能拍照给AI看。

8.1 下载APP

iOS:App Store搜”OpenClaw”
Android:Google Play或应用商店搜”OpenClaw”

8.2 配对

打开手机APP
选择”配对设备”,会显示一个二维码
在电脑上执行配对命令:
Copy
openclaw nodes pair
用手机扫电脑上的二维码
按提示授权

8.3 手机端功能

配对成功后,你可以:
在手机上发消息给AI
拍照让AI识别(AI会看图说话)
语音输入(AI会转成文字处理)
远程截屏(需要电脑端授权)
查看设备位置

第九部分:常见问题汇总

Q1:安全吗?数据会不会泄露?
完全安全。 OpenClaw是自托管的,所有数据都存在你自己的电脑上(~/.openclaw/目录),不经过任何第三方服务器。你可以随时查看和删除数据。
Q2:需要一直开着电脑吗?
是的。 OpenClaw需要一台电脑或服务器一直运行。电脑关机后AI就收不到消息了。
解决方案: 买一个低功耗VPS(每月几十块),把OpenClaw装在VPS上,这样随时随地都能用。
Q3:AI回答要花钱吗?
OpenClaw本身免费,但AI需要用你的API Key。每次调用AI会消耗API配额。
大概成本:
GPT-4o:几美元/月(普通用量)
GPT-4o mini:几毛美元/月
Claude:差不多
Q4:完全不会编程能用吗?
能。 跟着上面的步骤做就行。高级功能(自定义工作流、写插件)需要编程基础,但基本功能有手就行。
Q5:微信登录不上怎么办?
确保用专门的微信号,别用老号
尝试多扫几次
查看日志:openclaw logs –follow
看官方文档的故障排除:https://docs.openclaw.ai/channels/troubleshooting
Q6:配置改了不生效?
重启网关:
Copy
openclaw gateway restart

第十部分:进阶功能(可选)

10.1 配置多个AI模型

Copy
{
agents: {
defaults: {
model: {
primary: “openai/gpt-4o”,
fallbacks: [“anthropic/claude-sonnet-4-6”]
}
}
}
}
这样如果GPT不可用,会自动用Claude。

10.2 限制谁能发消息

Copy
{
channels: {
telegram: {
dmPolicy: “allowlist”,
allowFrom: [“tg:123456789”] // 你的Telegram ID
}
}
}

10.3 设置技能

OpenClaw有各种技能(比如天气查询、GitHub集成):
Copy

查看可用的技能

openclaw skills list

安装技能

openclaw skills install weather

10.4 更多渠道

OpenClaw支持几十种渠道,详见:https://docs.openclaw.ai/channels
WhatsApp:和微信类似,扫码登录
Discord:适合开发者
Slack:适合办公
飞书:国内企业用得多
Signal:注重隐私

第十一部分:完整配置文件示例

给你一个完整的配置文件参考,保存在~/.openclaw/openclaw.json:
Copy
{
// 网关配置
gateway: {
port: 18789,
auth: {
mode: “token”,
token: “你的token”
}
},
// AI模型配置
agents: {
defaults: {
model: {
primary: “openai/gpt-4o”,
fallbacks: [“anthropic/claude-sonnet-4-6”]
},
workspace: “~/.openclaw/workspace”
}
},
// 渠道配置
channels: {
telegram: {
enabled: true,
botToken: “你的Token”,
dmPolicy: “pairing”
},
whatsapp: {
enabled: false,
dmPolicy: “pairing”
}
}
}

第十二部分:结语

OpenClaw的本质是:让你用自己的AI API,通过任何一个你常用的聊天工具调用AI。
它不像那些SaaS服务——你的数据是你的,规则是你定的,不用看任何人脸色。
唯一的代价是:需要有一台电脑或VPS一直开着。
下一步:
去 https://openclaw.ai 或 https://docs.openclaw.ai 查看官方文档
准备一个API Key
按上面的步骤操作
5分钟就能跑起来