OpenClaw安装与使用指导 ​

OpenClaw（🦞）是一款开源的个人 AI 助手平台，由 GitHub 10万+ Stars 的社区驱动开发。它运行在你自己的设备上，通过 WhatsApp、Telegram、Discord、Slack 等主流聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。

• 本地优先: 网关（Gateway）完全本地运行，数据隐私可控
• 多平台支持: 支持 WhatsApp、Telegram、Discord、Slack、Google Chat、Signal、iMessage、飞书等 10+ 通讯平台
• 多模型支持: 支持 Anthropic Claude、OpenAI GPT 等主流 LLM
• 语音交互: 支持 macOS/iOS/Android 的语音唤醒和对话模式
• 实时画布: 支持 AI 驱动的可视化工作区（Canvas）
• 技能扩展: 通过 ClawHub 安装各种技能插件

• Node.js: >= 22（必须）
• 操作系统: macOS、Linux、Windows（通过 WSL2，强烈推荐）
• 包管理器: npm、pnpm 或 bun

检查 Node.js 版本：

推荐安装方式（使用 npm）：

启动初始化向导（推荐）：

–install-daemon 参数会自动安装网关守护进程（launchd/systemd 用户服务），确保 OpenClaw 始终运行。

对于中文用户，社区提供了全中文界面的汉化版本，CLI 命令行和 Dashboard 网页控制台均已深度汉化。中文社区

安装命令：

特点： 🕐 每小时自动同步官方更新，汉化版延迟 < 1 小时 🌐 全中文界面：Dashboard、CLI、文档全面汉化 📚 中文文档：完整的中文搭建教程和排错指南

社区提供了 Windows 用户的打包安装版本，免去环境配置烦恼。 下载地址：https://claw.ver0.cn/

运行 onboard 向导完成初始化：

向导会引导你完成： 选择 AI 模型（推荐 Anthropic Claude Pro/Max） 配置 API 密钥（支持 OAuth 和 API Key 两种方式） 设置聊天通道（WhatsApp、Telegram 等） 安装守护进程（保持后台运行）

发送消息测试：

与 AI 助手对话：

打开 Web 控制台：

启动网关后，浏览器会自动打开 Dashboard 控制台（http://localhost:18789）。

环境变量方式：

安装飞书插件：

基础配置：

完整配置示例：

飞书权限申请清单：

重要：必须在飞书开放平台后台配置事件订阅，添加 im.message.receive_v1 事件，否则机器人无法接收消息。

编辑 ~/.openclaw/openclaw.json：

• Anthropic: Claude Pro/Max（推荐，长上下文、抗提示注入能力强）
• OpenAI: ChatGPT、Codex
• 其他: 支持任意兼容 OpenAI API 的模型

配置多个模型实现自动故障转移：

• DM 配对模式: 未知发送者会收到配对码，需手动批准后才能对话
• 批准命令: openclaw pairing approve channel code
• 安全检查: 运行 openclaw doctor 检查风险配置

对于群组/频道消息，建议启用 Docker 沙盒：

这会为非主会话（群组/频道）创建独立的 Docker 沙盒环境。

配置 Tailscale 实现安全的远程访问：

ClawHub 是 OpenClaw 的官方技能注册中心，支持自动搜索和安装技能。 访问地址：https://clawhub.ai/skills

仓库: m1heng/clawdbot-feishu 飞书插件提供以下工具能力：

权限申请注意事项：

1. 云空间访问: 机器人没有自己的”我的空间”，必须将文件夹分享给机器人
2. 知识库访问: 必须将机器人添加为知识库成员
3. 多维表格访问: 必须将表格分享给机器人

技能文件位于 ~/.openclaw/workspace/skills/{skill}/SKILL.md。

技能配置文件示例：

• 支持平台: macOS、iOS、Android
• 功能: 语音唤醒、连续对话、语音播报
• 配置: 需要 ElevenLabs API 密钥

• AI 驱动的可视化工作区，支持：
• 代码渲染与执行
• 图像生成与编辑
• 数据可视化
• 交互式 UI 组件

OpenClaw 会管理独立的 Chrome/Chromium 实例，支持截图、点击、表单填写等操作。

常用命令：

• /status – 查看会话状态（模型、Token、费用）
• /new 或 /reset – 重置会话
• /compact – 压缩会话上下文
• /think {level} – 设置思考深度（off/minimal/low/medium/high/xhigh）
• /verbose on|off – 开关详细输出

Q: 机器人收不到消息？

检查事件订阅配置（飞书/Discord/Telegram 都需要配置 webhook 或长连接） 确认权限已申请并审核通过 检查 allowFrom 白名单设置

Q: 飞书返回 403 错误？

确认 im:message:send_as_bot 权限已申请 检查应用是否已发布（至少测试版本）

Q: Windows 安装报错 spawn npm ENOENT？

Q: 如何升级 OpenClaw？

官方资源

• 官网: https://openclaw.ai
• GitHub: https://github.com/openclaw/openclaw
• 文档: https://docs.openclaw.ai
• Discord 社区: https://discord.gg/openclaw

中文社区资源

• 中文镜像: https://github.com//OpenClawChineseTranslation
• 飞书插件: https://github.com/m1heng/clawdbot-feishu
• 技能市场: https://clawhub.ai/skills

配置模板

• AGENTS.md: 代理行为配置
• SOUL.md: 个性化身份设定
• TOOLS.md: 工具使用说明
• MEMORY.md: 持久化记忆存储

1. 模型选择: 强烈推荐使用 Anthropic openclaw 安装 Claude Pro/Max (100/200) + Opus 4.6，长上下文能力强，抗提示注入能力更好
2. 安全设置:

• 生产环境务必设置 dmPolicy: “pairing”
• 群组使用 requireMention: true 避免误触发
• 定期运行 openclaw doctor 检查配置

3. 性能优化:

• 使用 WebSocket 模式（飞书/Discord）减少延迟
• 启用 dynamicAgentCreation 实现多用户隔离
• 合理设置 mediaMaxMb 限制媒体文件大小

4. 备份策略:

• 定期备份 ~/.openclaw/ 目录
• 重要技能文件使用 Git 管理
• 配置文件使用 JSON Schema 验证

Happy Clawing! 🦞

本文档基于 OpenClaw 官方文档和中文社区实践整理，如有更新请以官方文档为准。