从 0 开始用 OpenClaw：Windows / Mac 安装 + 飞书联动，手机远程操控 AI
下载文件1. 准备工作
环境依赖
无论是 Windows 还是 macOS，必须预先安装以下工具：
- Node.js: 版本需 > 22 。
- Git: 用于拉取 GitHub 资源。
验证环境命令 (终端/CMD):
node -v # 检查 Node 版本 npm -v # 检查 NPM 版本 git -v # 检查 Git 版本
2. 快速安装与初始化 (本机运行)
安装步骤
-
配置 NPM 国内镜像 (防止网络超时，如果在国外则不用。):
npm config set registry https://registry.npmmirror.com -
全局安装 OpenClaw:
npm install -g openclaw@latest -
初始化:
openclaw onboard --install-daemon
初始化配置向导
| 步骤 | 选项/输入 | 说明 |
|---|---|---|
| Risk Warning | Yes | 确认知晓 AI 操作风险 |
| Setup Mode | Quickstart | 快速开始模式 |
| LLM Provider | Zhipu AI (或其他) | 推荐先用智谱 GLM 等有免费额度的模型测试 |
| API Key | 粘贴你的 Key | 终端中粘贴不显示，直接回车 |
| Model | GLM 4.7 | 或 MiniMax, Kimi 等高性价比模型 |
| Skills/Channels | Skip / No | 后续在 WebUI 中配置 |
| Interface | Open the Web UI | 启动网页版图形界面 (默认端口 18789) |
测试指令:
- 对话框输入: “你好” (验证 LLM 连接)
- 对话框输入: “在我的用户主目录下，创建一个名为 Jason-OpenClaw 的文件夹” (验证系统操作权限)
3. 插件与技能 (Skills) 管理
OpenClaw 的强大在于 Skills。除了内置技能，还可以从社区安装。
- 官方市场: ClawHub (官网链接进入)
- GitHub仓库:
awesome-openclaw-skills
必装技能
- find-skills: 核心技能。允许 AI 根据你的自然语言需求，自动去寻找并安装其他所需的 Skills。
- Web Search / Browsing: 增强联网搜索能力。
安装方式
- 安装插件：命令行方式:
openclaw plugins install 插件名 - 安装Skill：对话安装: 直接把 GitHub 仓库链接发给机器人，指令：“请帮我安装这个 skill”。
4. 集成即时通讯APP（WhatsApp，飞书等）
这是实现“手机遥控数字员工”的关键步骤。
WhatsApp 集成
在 OpenClaw 的配置文件里（通常是 ~/.openclaw/openclaw.json），添加如下最基本的 WhatsApp 配置：
{
"channels": {
"whatsapp": {
"dmPolicy": "allowlist",
"allowFrom": ["+15551234567"]
}
}
}然后在终端执行：
openclaw channels login这个命令会打印一个专用的 QR 码，打开 WhatsApp 手机应用扫码即可。
飞书集成
第一步：安装飞书插件
在终端执行：
openclaw plugins install @m1heng-clawd/feishu
# 注：插件名可能随社区更新变动，具体以 github 仓库为准第二步：飞书开放平台配置
登录 飞书开放平台 -> 开发者后台。
- 创建应用: 点击“创建企业自建应用”，填写名称（如
JasonBot），选择图标。 - 添加能力: 左侧菜单“添加应用能力” -> “机器人” -> 点击添加。
- 权限管理 (关键):
- 进入“权限管理”。
- 搜索并开通
im:message相关权限 (收发消息)，如表格所示。 - 也可批量导入: 点击“批量导入”，粘贴以下 JSON 配置 (参考模板):
| 必要权限 | 范围 | 说明 |
|---|---|---|
im:message | 消息 | 发送和接收消息 |
im:message.p2p_msg:readonly | 私聊 | 读取发给机器人的私聊消息 |
im:message.group_at_msg:readonly | 群聊 | 接收群内 @机器人 的消息 |
im:message:send_as_bot | 发送 | 以机器人身份发送消息 |
im:resource | 媒体 | 上传和下载图片/文件 |
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}- 版本发布: 左侧“版本管理与发布” -> 创建版本 (v1.0.0) -> 发布。
- 获取凭证: 左侧“凭证与基础信息” -> 复制
App ID和App Secret。
第三步：OpenClaw 连接配置
回到 OpenClaw Web UI -> Channels -> Feishu (配置界面)：
- App ID: 粘贴飞书 App ID。
- App Secret: 粘贴飞书 App Secret。
- Connection Mode: 选择
WebSocket(无需公网 IP，无需内网穿透)。 - Domain:
feishu。 - Policies:
DM Policy和Group Policy建议选Open(或按需设置 Allowlist)。 - 点击 Save 保存。
第四步：开启事件订阅
OpenClaw 配置保存后，守护进程会启动 WebSocket 连接，此时才能去飞书配置长连接。
- 回到飞书开发者后台 -> “事件与回调”。
- 配置订阅方式: 选择 长连接。
- 添加事件: 点击“添加事件” -> 搜索
receive-> 勾选im.message.receive_v1(接收消息) -> 确认。 - 重新发布: 修改配置后，必须再次去“版本管理”发布一个新版本才能生效。
手机APP测试: 打开飞书 App -> 搜索机器人名称 -> 发送 “你好” 或 “在我的用户主目录下创建一个名字叫 jason-feishu 的文件夹”。（飞书桌面APP同理）
5. Docker 隔离环境部署 (进阶)
为了安全（隔离主系统文件）和 24h 运行，建议使用 Docker 部署。
部署流程
- 安装 Docker: 下载并安装 Docker Desktop。
- 下载仓库:
git clone https://github.com/openclaw/openclaw cd openclaw - 运行安装脚本:
- Mac/Linux:
./docker-setup.sh - Windows: 需在 Git Bash 中运行上述命令。
- Mac/Linux:
- 注意事项:
- 脚本会自动拉取镜像并启动容器。
- 初始化步骤与本机安装一致。
- Token 成本: 建议使用 Coding Plan 或包月类 API (如GLM, MiniMax) 防止 Token 消耗过快。
安全与隐私警告
- 数据隐私: 避免让 AI 访问存有敏感数据（私钥、密码表、个人相册等）的目录。
- 操作权限: OpenClaw 具有系统级操作权限（删除文件、运行脚本），请谨慎授予
sudo权限或在非隔离环境运行高风险指令。 - Token 监控: 智能体自主运行时会消耗大量 Token，务必设置额度上限。