OpenClaw AI 助手 - 微信公众号使用手册
一个可以在多种设备上运行的个人AI助手，让跨平台交互变得简单。🦞 OpenClaw AI 助手 - 微信公众号使用手册。🦞 OpenClaw AI 助手 - 微信公众号使用手册。🎤 语音与唤醒（仅限macOS/iOS/Android）• BlueBubbles（iOS消息同步）：数据保存在你的设备上，不上传到第三方服务器。• 说出唤醒词（如"Hey Siri"风格）• 🌐 Serve：公网
🦞 OpenClaw AI 助手 - 微信公众号使用手册
一个可以在多种设备上运行的个人AI助手，让跨平台交互变得简单
📋 目录
-
1. 项目简介
-
2. 核心功能特性
-
3. 快速开始
-
4. 渠道配置指南
-
5. 高级功能
-
6. 安全与权限
-
7. 常见问题
1. 项目简介
🎯 OpenClaw 是什么？
OpenClaw 是一个个人AI助手，你可以运行在自己拥有的设备上。
它能够在你已经使用的通讯渠道上回答问题：
|
渠道 |
特点 |
|
|
全球最流行的即时通讯 |
|
✈️ Telegram |
功能丰富的加密通讯 |
|
💬 Slack |
企业团队协作 |
|
🎮 Discord |
游戏社区首选 |
|
📊 Google Chat |
企业办公集成 |
|
🔔 Signal |
隐私安全通讯 |
|
🍎 iMessage |
Apple生态专属 |
|
💼 Microsoft Teams |
企业办公套件 |
还支持扩展渠道：
-
• BlueBubbles（iOS消息同步）
-
• Matrix（去中心化通讯）
-
• Zalo（东南亚流行）
🏠 核心设计理念
-
• 本地优先：数据保存在你的设备上，不上传到第三方服务器
-
• 跨平台支持：macOS、iOS、Android、Linux、Windows
-
• 隐私安全：所有敏感操作需要明确授权
-
• 可扩展性：支持自定义技能和插件
2. 核心功能特性
🚀 多渠道集成
用户通过任意渠道发送消息
↓
OpenClaw 接收
↓
Gateway 处理（核心控制平面）
↓
分发到对应的 Agent（AI助手）
↓
返回响应支持的功能：
-
• ✅ 单聊对话
-
• ✅ 群组管理
-
• ✅ 语音消息转文字
-
• ✅ 图片识别与分析
-
• ✅ 文件处理
🎤 语音与唤醒（仅限macOS/iOS/Android）
语音唤醒功能：
-
• 说出唤醒词（如"Hey Siri"风格）
-
• 设备自动响应
-
• 持续监听模式
语音交互：
-
• 语音转文字
-
• 文字转语音
-
• 实时对话
🎨 实时 Canvas 控制
功能亮点：
-
• 🖥️ 屏幕共享与控制
-
• 📸 摄像头实时画面
-
• 🎯 元素定位与操作
-
• 📐 A2UI 智能交互
应用场景：
-
• 远程协助
-
• 自动化操作
-
• 视觉问答
📱 设备节点功能
|
功能 |
说明 |
权限要求 |
|
📷 摄像头 |
拍照、录像 |
相机权限 |
|
🖼️ 屏幕录制 |
录屏、截图 |
屏幕录制权限 |
|
📍 位置获取 |
GPS定位 |
位置权限 |
|
🔔 通知 |
系统通知 |
通知权限 |
|
⚙️ 系统运行 |
执行命令 |
主机权限 |
🌐 浏览器控制
集成 Chrome/Chromium 浏览器：
-
• 🌐 网页浏览
-
• 📸 截图功能
-
• ⌨️ 表单填写
-
• 🔗 链接点击
⚡ 自动化任务
支持多种触发方式：
-
• ⏰ Cron 定时任务
-
• 🔗 Webhooks 外部触发
-
• 📧 邮件监听
-
• 📊 定时报告
3. 快速开始
📦 环境要求
|
组件 |
版本要求 |
|
Node.js |
≥ 18.0.0 |
|
包管理器 |
npm / pnpm / bun |
|
操作系统 |
macOS / Linux / Windows(WSL2)bash |
全局安装 CLI
npm install -g openclaw@latest
启动引导程序
openclaw onboard
**方式二：使用 pnpm**
```bash
pnpm add -g openclaw@latest
openclaw onboard方式三：使用 bun
bun add -g openclaw@latest
openclaw onboard运行 `openclaw onboard` 后，wizard 会引导你完成：
1. **选择安装路径**（工作区）
2. **配置 AI 模型**（推荐 Claude/GPT-4）
3. **设置渠道**（选择要启用的通讯渠道）
4. **安装技能**（可选功能模块）
5. **权限设置**（安全bash
# 启动 Gateway（核心服务）
openclaw gateway --port 18789 --verbose
```# 发送测试消息
openclaw message send --to +1234567890 --message "Hello from OpenClaw"
# 触发助手执行任务
openclaw agent --message "Ship checklist" --thinking high📁 工作区结构
~/.openclaw/workspace/
├── agents/ # Agent 配置文件
├── skills/ # 技能模块
├── channels/ # 渠道配置
├── credentials/ # 敏感凭证（加密存储）
├── storage/ # 数据存储
└── config.json # 主配置文件4. 渠道配置指南
📱 WhatsApp 配置
获取凭证：
-
1. 访问 Meta Developer
-
2. 创建应用，获取 App ID 和 App Secret
-
3. 配置 Webhook
**
{
"channels":{
"whatsapp":{
"enabled":true,
"credentials":{
"appId":"YOUR_APP_ID",
"appSecret":"YOUR_APP_SECRET"
},
"webhookPath":"/webhooks/whatsapp"
}
}
}login --channel whatsapp
验证连接
openclaw channels status --channel whatsapp
### ✈️ Telegram 配置
**获取 Bot Token：**
1
```json
{
"channels": {
"telegram": {
"botToken": "YOUR_BOT_TOKEN",
"webhookPath": "/webhooks/telegram",
"groupPolicy": "all"
}
}
}"*": {
"requirement": "admin"
}
}
}}
}
### 💬 Discord 配置
**创建 Bot：**
1. 访问 [Discord Developer Portal](https://discord.com/developers/applications)
2. 创建 Application
3. 添加 Bot 用户
4. 获取 Token
```json
{
"channels": {
"discord": {
"token": "YOUR_BOT_TOKEN",
"allowFrom": ["*"],
"dmPolicy": "pairing"
}
}
}openclaw pairing approve discord
### 🎮 Slack 配置
**创建 App：**
1. 访问 [Slack API](https://api.slack.com/apps)
2. Create New App
3. 配置 Bot Token Scopes
**必要权限：**
- `chat:write`
- `channels:history`
- `groups:history`
- `im:history`
---
## 5. 高级功能
### 🧩 技能系统
**内置技能：**
| 技能名称 | 功能描述 |
|---------|---------|
| `browser` | 浏览器自动化 |
| `canvas` | Canvas 控制 |
| `cron` | 定时任务 |
| `images` | 图片处理 |
| `system` | 系统操作 |
| `webhook` | Webhook 触发 |
**自定义技能结构：**~/.openclaw/workspace/skills/my-skill/
├── SKILL.json # 技能定义
├── prompter.md # 提示词模板
├── system.md # 系统提示
└── main.py # 实现代码（可选）
### 🔄 自动化任务
**Cron 任务配置：**
```json
{
"cron": {
"daily-report": {
"schedule": "0 9 * * *",
"task": "生成每日报告",
"enabled": true
}
}
}Webhook 触发：
{
"webhook": {
"endpoint": "/webhook/github",
"event": "push",
"action": "处理代码提交"
}
}🔐 安全权限
DM 配对策略：
策略
行为
pairing
需要验证码确认open完全开放（不推荐）
群组安全：
-
• ✅ 陌生人会收到配对码
-
• ✅ 助手不会处理未验证的消息
-
• ✅ 公共群组需要明确配置
{
"gateway": {
"talscale": {
"mode": "serve", // 或 "funnel"
"auth": "password"
}
}
}访问方式：**
-
• 🌐 Serve：公网 HTTP 访问
-
• 🔒 Funnel：隧道转发
6. 安全与权限
🛡️ 安全模型
核心原则：
-
1. 本地运行：所有数据保存在本地
-
2. 最小权限：默认拒绝敏感操作
-
3. 明确授权：需要用户确认高风险操作
⚠️ 权限分级
|
权限级别 |
说明 |
示例 |
|
🔵 低风险 |
读操作、查询 |
查看天气、回答问题 |
|
🟡 中风险 |
写操作、修改 |
发送消息、创建任务 |
|
🔴 高风险 |
系统操作 |
执行命令、文件操作 |
🔧 权限配置
**Sandbox 模式（推荐用于
{
"agents": {
"defaults": {
"sandbox": {
"mode": "non-main"
}
}
}
}进程管理
-
•
read/write- 文件读写 -
•
edit- 文件编辑 -
•
sessions_list/sessions_history/sessions_send/sessions_spawn
7. 常见问题
❓ Q1: 安装失败怎么办？
检查清单：
-
• Node.js 版本 ≥ 18
-
• 网络连接正常
-
• 权限足够（sudo 尝试）
-
• 清理缓存：
npm cache clean --force
❓ Q2: 渠道连接失败？
排查步骤：
-
1. 检查凭证是否正确
-
2. 验证 Webhook URL 可访问
-
3. 查看日志：
openclaw doctor -
4. 重启服务：`openbash
更新 CLI
npm update -g openclaw@latest
更新工作区
openclaw update --channel stable
### ❓ Q4:
```性能优化建议
| 优化项 | 建议 |
|-------|------|
| 内存占用 | 限制并发对话数 |
| 响应速度 | 使用轻量级模型 |
| 存储空间 | 定期清理日志 |
| 网络带宽 | 压缩图片传输 |
---
## 📚 进阶资源
- 📖 **官方文档**: [https://docs.openclaw.ai](https://docs.openclaw.ai)
- 💬 **社区支持**: [Discord](https://discord.gg/claw)
- 🐛 **问题反馈**: [GitHub Issues](https://github.com/openclaw/openclaw/issues)
---
## 📝 附录：命令速查表
| 命令 | 说明 |
|------|------|
| `openclaw onboard` | 初始化配置向导 |
| `openclaw gateway` | 启动核心服务 |
| `openclaw message send` | 发送消息 |
| `openclaw agent` | 触发助手任务 |
| `openclaw channels` | 渠道管理 |
| `openclaw nodes` | 设备节点控制 |
| `openclaw update` | 更新版本 |
| `openclaw doctor` | 故障诊断 |
---
**📢 声明**
本手册基于 OpenClaw 项目 README 文档整理，如有更新请以官方文档为准。
**🔗 项目链接**
- GitHub: [https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw)
- 官网: [https://openclaw.ai](https://openclaw.ai)
- Discord: [https://discord.gg/claw](https://discord.gg/claw)
---
> 💡 **提示**：建议首次使用时运行 `openclaw onboard` 进行完整配置，享受最佳体验！
🦞 **OpenClaw** - 你的个人AI助手，让跨平台交互更简单！
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
6
0- 0
已为社区贡献5条内容
所有评论(0)