夜雨聆风
OpenClaw 是一个自托管的 AI 智能体网关（Gateway），核心功能就一个：把你的聊天软件变成 AI 的入口。
它能做什么？
✅ 多渠道接入 - WhatsApp、Telegram、Discord、iMessage 一个网关全搞定 ✅ 自托管 - 运行在你自己的电脑上，数据不出本地 ✅ 多智能体路由 - 可以同时连接多个 AI（Pi、Claude、GPT 等） ✅ 媒体支持 - 发图片、文件、语音都能处理 ✅ 移动端支持 - 配对手机后可以用摄像头、语音等功能
谁适合用？
开发者 - 写代码时随时问 AI，不用切窗口
自媒体人 - 走路、通勤时都能让 AI 帮忙写稿
学生党 - 上课不方便开电脑，发消息就能问问题
效率控 - 把 AI 集成到日常工作流中
🚀 快速开始（5 分钟上手）
第一步：安装 OpenClaw
打开终端，一行命令：
npm install -g openclaw@latest
前提条件：需要 Node.js 22+ 版本
检查版本： node -v
如果版本低，去 nodejs.org 下载安装
第二步：新手引导
openclaw onboard --install-daemon
这个命令会：
引导你配置 API 密钥（用你自己的大模型 API）
安装后台服务（开机自启）
生成配置文件
第三步：登录聊天渠道
以 WhatsApp 为例：
openclaw channels login
会显示一个二维码，用手机 WhatsApp 扫码配对。
国内用户提示：WhatsApp 在国内需要特殊网络环境。你也可以选择：
Telegram - 需要特殊网络
Discord - 需要特殊网络
企业微信 - 国内可用（需要企业账号）
飞书 - 国内可用（推荐！）
第四步：启动网关
openclaw gateway --port 18789
看到 Gateway started 就成功了！
第五步：打开控制界面
浏览器访问：http://127.0.0.1:18789/
这就是你的 OpenClaw 控制台，可以在这里：
查看会话历史
配置智能体
管理节点
调试问题
💬 第一次和 AI 对话
配对完成后，给你配对的 WhatsApp/飞书 账号发一条消息：
你好，介绍一下你自己
几秒钟后，你会收到 AI 的回复！
从此，你的聊天软件里就多了一个 24 小时在线的 AI 助手。
📁 配置文件详解
配置文件位置：~/.openclaw/openclaw.json
基础配置示例
{
"channels": {
"whatsapp": {
"allowFrom": ["+8613800138000"], // 只允许这个号码访问
"groups": {
"*": {
"requireMention": true // 群里需要@才响应
}
}
}
},
"messages": {
"groupChat": {
"mentionPatterns": ["@openclaw", "@AI"] // 响应这些@
}
},
"providers": {
"bailian": { // 通义千问
"apiKey": "sk-xxx"
}
}
}
常用配置项
配置项 | 说明 | 示例 |
| 白名单，只允许这些用户 |
|
| 群里是否需要@ |
|
| 响应哪些@ |
|
| AI 提供商配置 | 见下方 |
支持的 AI 提供商
{
"providers": {
"bailian": { // 阿里云通义千问
"apiKey": "sk-xxx"
},
"openai": { // OpenAI GPT
"apiKey": "sk-xxx"
},
"anthropic": { // Claude
"apiKey": "sk-ant-xxx"
},
"deepseek": { // 深度求索
"apiKey": "sk-xxx"
}
}
}
🔧 常用命令速查
网关管理
openclaw gateway start # 启动网关
openclaw gateway stop # 停止网关
openclaw gateway restart # 重启网关
openclaw gateway status # 查看状态
渠道管理
openclaw channels login # 登录新渠道
openclaw channels list # 查看已登录渠道
openclaw channels logout # 退出渠道
会话管理
openclaw sessions list # 查看会话列表
openclaw sessions kill # 结束会话
其他工具
openclaw onboard # 重新运行新手引导
openclaw configure # 打开配置文件
openclaw logs # 查看日志
📱 移动端节点（进阶）
OpenClaw 支持配对 iOS 和 Android 手机，解锁更多功能：
配对手机
手机上安装 OpenClaw App（或配置节点）
电脑端运行：
openclaw nodes pair扫码配对
手机节点能做什么？
📷 摄像头 - 拍照发给 AI 分析
🎤 语音 - 语音输入/输出
📍 位置 - 分享位置给 AI
📱 屏幕 - 共享屏幕（需要授权）
🛠️ 实战场景
场景 1：写代码时随时问 AI
痛点：写代码遇到问题，要切浏览器问 AI，打断思路。
OpenClaw 方案：
把 AI 配对到微信/飞书
写代码时遇到问题，直接发消息
手机/电脑都能收到回复
不用切窗口，思路不打断
场景 2：通勤路上写文章
痛点：地铁上不方便开电脑，但灵感来了想写文章。
OpenClaw 方案：
发消息给 AI："帮我写一篇关于 XXX 的公众号文章"
AI 生成大纲或初稿
到家后用电脑继续完善
场景 3：群聊里的 AI 助手
痛点：技术群里经常有人问问题，手动回答太累。
OpenClaw 方案：
把 AI 拉进群
配置
requireMention: true群里有人@AI 才会响应
常见问题 AI 自动回答
⚠️ 注意事项
1. API 费用
OpenClaw 本身免费，但使用 AI 需要 API 密钥：
通义千问：按 token 计费
OpenAI：按 token 计费
DeepSeek：按 token 计费
建议：设置使用限额，避免超额消费。
2. 网络环境
WhatsApp/Telegram/Discord 需要特殊网络
国内推荐用 飞书 或 企业微信
3. 隐私安全
自托管 = 数据在你自己电脑上
但 API 请求会发送到 AI 提供商
敏感信息不要发给 AI
4. 响应速度
取决于网络 + AI 提供商速度
通常 3-10 秒回复
复杂任务可能需要更久
🐛 常见问题
Q1: 网关启动失败
检查：
openclaw gateway status
openclaw logs
常见原因：
端口被占用（换端口：
--port 18790）配置文件错误（检查 JSON 格式）
API 密钥无效（重新配置）
Q2: 收不到 AI 回复
检查：
网关是否在运行：
openclaw gateway statusAPI 密钥是否有效
是否在白名单内：检查
allowFrom群里是否需要@：检查
requireMention
Q3: 如何重置配置
# 备份配置
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
# 重新运行引导
openclaw onboard
📚 进阶资源
官方文档
英文：https://docs.openclaw.ai
中文：https://docs.openclaw.ai/zh-CN
GitHub
项目地址：https://github.com/openclaw/openclaw
问题反馈：https://github.com/openclaw/openclaw/issues
社区
Discord: https://discord.com/invite/clawd
技能市场：https://clawhub.com
🎯 总结
OpenClaw 的核心价值：让 AI 像微信好友一样，随时随地可用。
适合人群：
✅ 开发者
✅ 自媒体人
✅ 学生
✅ 效率控
上手难度：⭐⭐（需要一点技术基础）
推荐指数：⭐⭐⭐⭐⭐
最后说一句：AI 工具千千万，但能随时随地用的才是真香。OpenClaw 就是那个让你"离不开"的桥梁。
有问题？发消息给你的 AI 助手问问看！🦞
