什么是 OpenClaw？
想象一下这样的场景：你正在开会，有人发来一堆文件需要整理；或者深夜你想处理今天的邮件，但实在太困了……如果有一个能真正"动手"的 AI 助手，替你完成这些操作，会怎样？
OpenClaw 就是这样的存在。
它不是一个只能陪聊的聊天机器人，而是一个能真正在你的电脑上执行操作的 AI Agent。你只需要用自然语言告诉它要做什么，它就能自动操作你的电脑：
- 📧 邮件处理：帮你分类、归档、退订广告邮件
- 📁 文件管理：自动整理下载文件夹，重命名、分类
- 🐛 代码调试：在你的项目中查找 Bug、运行测试
- 📅 日程安排：自动预约会议、添加日历提醒
- 🌙 夜间任务：你睡觉时，它继续干活
核心特性
| 特性 | 说明 |
|---|---|
| 🔒 完全本地化 | 数据存储在你自己的设备上，隐私无忧 |
| 💰 永久免费 | 开源项目，无订阅费用，不消耗 API 配额 |
| 🌍 多渠道接入 | 支持飞书、钉钉、WhatsApp、Telegram 等主流通讯工具 |
| ⚡ 异步执行 | 发出指令后可以关闭对话，任务后台继续执行 |
| 🔧 高度可扩展 | 通过 Skills 和 Hooks 自定义功能 |
项目发展历程
OpenClaw 的诞生，始于一个简单的想法：让 AI 不只是对话，而是真正成为生产力工具。
📅 进化时间线
| 阶段 | 名称 | 核心特点 |
|---|---|---|
| Phase 1 | ClawdBot | 早期原型，专注基础自动化能力 |
| Phase 2 | MoltBot | 架构重构，引入插件系统和多模态支持 |
| Phase 3 | OpenClaw | 开源发布，社区驱动，企业级能力开放 |
🏗️ 技术架构演进
OpenClaw 采用了创新的 Gateway + Agent 架构：
- Gateway：本地服务网关，负责与 LLM 通信、执行系统操作
- Channels：多渠道适配器，统一接入各类 IM 工具
- Skills：功能插件系统，用户可自建或安装社区技能
- Hooks：事件钩子机制，实现自动化工作流编排
这种设计让 OpenClaw 既轻量又强大，一台普通笔记本即可运行，同时又具备企业级扩展能力。
准备工作
系统要求
- 操作系统：macOS（推荐）、Linux
- Node.js：v22+（必须是 arm64 架构）
- 内存：建议 8GB 以上
- 网络：需要访问 LLM API（智谱、OpenAI 等）
Step 1：安装 Node.js 环境
OpenClaw 依赖 Node.js 运行，且必须是 arm64 架构的 v24 版本。这一点至关重要，x86 版本会导致核心依赖 node-llama-cpp 安装失败。
⚠️ M1/M2/M3 Mac 用户注意：这是最容易踩的坑！请务必确认架构为 arm64。
1.1 安装 nvm（Node 版本管理器）
nvm 可以让你在一台电脑上管理多个 Node 版本，切换起来非常方便。
# 使用 Homebrew 安装 nvm
brew install nvm
# 验证安装成功
nvm -v
1.2 安装 Node.js v22（arm64）
# 查看所有可安装的 Node 版本
nvm ls-remote
# 安装 Node.js v22（会自动选择 arm64 架构）
nvm install 22
# 设置 v24 为默认版本
nvm alias default 22
# 立即使用 v22
nvm use 22
# 验证版本
node -v
1.3 验证架构（重要！）
# 检查当前 Node 架构，必须输出 arm64
node -p "process.arch"
如果输出 arm64，恭喜你，可以继续下一步！
如果输出 x64 或其他，需要先卸载现有 Node，然后重新安装 arm64 版本：
# 卸载当前版本
nvm uninstall 24
# 清理缓存后重新安装
nvm cache clean
nvm install 24
Step 2：安装 OpenClaw
一条命令即可完成全局安装：
# 安装最新版本
npm install -g openclaw@latest
# 验证安装成功
openclaw --version
看到版本号输出，说明安装成功！✅
Step 3：初始化配置
OpenClaw 提供了友好的交互式配置向导，一条命令启动：
openclaw onboard --install-daemon
3.1 安全确认
向导首先会展示安全警告，告知你 OpenClaw 需要文件访问和命令执行权限。这是正常的，因为 AI 助手需要这些能力来替你完成工作。
选择 Yes 继续。
3.2 选择配置模式
推荐选择 QuickStart，这是最省心的配置方式。
3.3 配置 LLM API
OpenClaw 需要连接大模型才能工作。支持多家服务商：
| 服务商 | 特点 | 推荐场景 |
|---|---|---|
| 智谱 AI | 国产、响应快、中文友好 | 国内用户首选 |
| OpenAI | GPT-4 能力最强 | 需要最强推理能力 |
| Claude | 上下文超长 | 复杂任务处理 |
我使用的是智谱 API，注册即可免费获取额度：
🚀 立即拼团薅羊毛：智谱 GLM Coding 订阅链接直达，20 + 编程工具无缝支持，越拼越划算，建议大家直接选择MAX模型，避免高峰期间被限流→www.bigmodel.cn/glm-coding?…
3.4 配置渠道、Skills 和 Hooks
以下选项建议先跳过，后续按需配置：
- Channels：聊天渠道（飞书、钉钉等）
- Skills：功能技能插件
- Hooks：自动化工作流钩子
操作技巧：按空格键选中/取消，回车键确认。
3.5 安装 Gateway 服务
向导会自动将 OpenClaw 注册为 macOS 后台服务（LaunchAgent）：
完成后会显示控制面板访问地址：
📝 复制并保存这个地址，包含认证 Token，后续访问需要。
3.6 验证安装
# 检查 Gateway 运行状态
openclaw gateway status
3.7 访问 Web 控制台
直接打开安装时提供的链接：http://127.0.0.1:18789/?token=xxx
如果链接丢失，可通过以下方式获取：
# 方法一：获取完整访问链接
openclaw dashboard --no-open
# 方法二：仅获取 Token
openclaw config get gateway.auth.token
# 方法三：重新生成 Token
openclaw doctor --generate-gateway-token
3.8 测试对话
打开控制台后，直接在输入框发送消息测试：
如果 AI 能正常回复，说明基础配置成功！🎉
Step 4：对接飞书，打造企业级 AI 助理
飞书是目前最顺滑的 OpenClaw 接入方式。虽然配置步骤稍多，但一次配置后，你就能在飞书中拥有一个能真正「干活」的 AI 助手！
💡 为什么推荐飞书？
- 企业级安全保障
- 支持富文本、文件、图片等多种消息格式
- 可在公司内部分享给团队使用
- 移动端体验极佳
4.1 创建飞书应用
- 打开 飞书开放平台，登录账号
- 点击「创建企业自建应用」
4.2 启用机器人能力
在应用创建页面，点击「机器人」右侧的「添加」按钮：
添加后左侧会出现「机器人」菜单。
4.3 配置权限
进入机器人菜单，申请必要的权限。建议的基础权限：
| 权限名称 | 权限码 | 用途 |
|---|---|---|
| 获取与发送消息 | im:message | 接收用户消息、发送回复 |
| 获取群组信息 | im:chat | 读取群组信息 |
| 读取用户信息 | contact:user.base:readonly | 识别发送者身份 |
🔗 完整权限参考：clawdbot-feishu 项目文档
4.4 配置事件订阅
进入「事件与回调」页面：
- 订阅方式：选择「长连接」（Event Long Polling）
- 添加事件：至少添加
im:message.receive_v1（接收消息）
4.5 获取凭证
进入「凭证与基础信息」页面，复制以下信息（妥善保管）：
- App ID（应用凭证）
- App Secret（应用密钥）
4.6 发布应用版本
在「版本管理与发布」页面，创建新版本并发布：
4.7 在 OpenClaw 中配置飞书
回到 OpenClaw 的 Web 控制台，发送以下指令（替换为你自己的 App ID 和 Secret）：
我要用 https://github.com/m1heng/clawdbot-feishu 这个项目将飞书集成进来，我的 appId 是"cli_xxxxxxxxxxxxx"，我的 appSecret 是"xxxxxxxxxxxxxx"，而且我使用的是国内版飞书，现在请帮我集成进来吧。
4.8 验证配置
OpenClaw 会自动重启服务使配置生效。验证命令：
openclaw gateway
看到飞书 channel 显示为「connected」即表示成功：
4.9 开始对话！
打开飞书客户端或 App，搜索你的应用名称，开始和 AI 助手聊天吧！
写在最后
OpenClaw 代表了个人 AI 助理的未来趋势——从"聊天工具"进化为"执行工具"。虽然目前的配置过程对小白用户有一定门槛，但一旦完成设置，你将拥有一个 24/7 待命的超级助手。
⚠️ 安全风险提示
OpenClaw 是一个强大的工具，但请务必注意安全。近期有安全报告显示，大量 Gateway 实例因配置不当暴露于公网，存在严重安全风险。
🔒 安全最佳实践
| 风险类型 | 说明 | 防范措施 |
|---|---|---|
| 公网暴露 | Gateway 直接暴露可被任何人访问 | 使用强 Token，禁止 0.0.0.0 绑定 |
| 权限过大 | AI 可执行任意系统命令 | 限制文件访问范围，启用沙箱 |
| 第三方技能 | 社区技能可能含有恶意代码 | 审核代码后再安装，优先使用官方技能 |
| 办公电脑部署 | 可能泄露公司敏感数据 | 仅在个人设备使用，禁止处理公司数据 |
📋 安全检查清单
- Gateway 仅监听 127.0.0.1，未暴露到公网
- 已设置强认证 Token
- 不在办公电脑上部署
- 不处理公司敏感数据
- 安装第三方 Skills 前已审核代码
- 定期更新到最新版本
重要提醒：如需远程访问，请使用安全隧道（如 Cloudflare Tunnel），而非直接开放端口。
相关链接：
- OpenClaw GitHub: github.com/m1heng/open…
- 飞书集成项目: github.com/m1heng/claw…
- 智谱 AI 开放平台: open.bigmodel.cn/
