OpenClaw 简介1.1 什么是 OpenClawOpenClaw原名 Clawdbot后更名 Moltbot2025 年 1 月正式定名是一个开源的本地 AI 智能体框架。它可以运行在自有服务器或电脑上数据完全自主可控支持多种平台接入。1.2 主要特性本地部署数据完全本地隐私安全多平台支持飞书、Telegram、Discord、WhatsApp 等浏览器控制可浏览网页、填写表单、提取数据系统访问读写文件、执行 Shell 命令、运行脚本持久化记忆记住用户偏好和交互上下文1.3 推荐配置项目推荐配置操作系统macOS功能最完整/ Linux / WindowsNode.jsv22.x 或更高内存8GB推荐/ 4GB最低IM 工具飞书国内/ Telegram国外AI 模型通义千问免费/ Claude / OpenAI2. 环境准备2.1 安装 Node.jsOpenClaw 要求 Node.js 版本 ≥ 22.x推荐使用 NVMNode 版本管理器安装。macOS/Linux 用户# 安装 NVMcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh|bashsource~/.bashrc# 安装 Node.js 22nvminstall22# 验证版本node-v# 输出 v22.x.xnpm-vWindows 用户方法一访问 https://nodejs.org/ 下载 LTS 版本安装包方法二使用 WSL2推荐# 在 PowerShell 中运行wsl--install# 在 WSL2 Ubuntu 中curl-fsSL https://deb.nodesource.com/setup_22.x|sudo-E bash-sudo apt-get install-y nodejs2.2 准备 AI API KeyOpenClaw 需要配置 AI 模型服务商以下是几种常见选择服务商特点获取方式通义千问 (Qwen)免费额度充足适合中文https://dashscope.aliyun.comAnthropic (Claude)推理能力强https://console.anthropic.comOpenAI (GPT)功能全面https://platform.openai.comKimi国内友好https://platform.moonshot.cn⚠️请妥善保管 API Key勿将其提交到公开仓库或分享给他人3. OpenClaw 安装3.1 一键安装推荐使用官方提供的一键安装脚本macOS/Linuxcurl-fsSLhttps://openclaw.ai/install.sh|bashWindowsiwr-useb https://openclaw.ai/install.ps1|iex3.2 npm 全局安装# 安装最新版npminstall-gopenclawlatest# 或安装指定版本推荐 2026.4.14 稳定版npminstall-gopenclaw2026.4.14--force# 验证安装openclaw--version3.3 安装飞书插件OpenClaw 通过插件机制支持飞书需要单独安装# 方式一使用 openclaw 命令openclaw pluginsinstallopenclaw/feishu# 方式二npm 全局安装npminstall-gopenclaw/feishu# 方式三pnpmpnpmadd-gopenclaw/feishu Windows 用户建议使用 npm 全局安装方式兼容性更好。4. 初始化配置4.1 运行新手引导安装完成后运行新手引导进行初始化配置openclaw onboard --install-daemon引导会引导你完成安全风险确认选择 Yes 继续配置模式选择推荐 QuickStart 快速配置AI 模型服务商选择如 Qwen OAuthAPI Key 配置或 OAuth 授权Gateway 运行模式设置4.2 通义千问 OAuth 配置推荐如果选择通义千问按以下步骤操作选择 Qwen OAuth 后控制台会生成授权链接和验证码复制授权链接在本地浏览器打开登录阿里云账号输入验证码完成授权返回终端按回车继续5. 飞书 Bot 配置5.1 创建飞书应用访问飞书开放平台https://open.feishu.cn/app登录并点击「创建企业自建应用」填写应用名称如「AI 助手」选择应用类型为「企业自建应用」5.2 获取应用凭证在应用详情页的「凭证与基础信息」中获取字段说明格式示例App ID应用唯一标识cli_xxxxxxxxxxxxApp Secret应用密钥只显示一次xxxxxxxxxxxxxxxx⚠️App Secret 只会显示一次请立即复制保存如果遗失需要重新生成。5.3 配置应用权限进入「权限管理」点击「批量导入」粘贴以下 JSON{scopes:{tenant:[im:message,im:message:send_as_bot,im:chat,im:chat:members:readonly,im:message.p2p_msg:readonly,im:message.group_msg],user:[im:message.p2p_msg:readonly]}}5.4 启用机器人能力进入「应用能力」 → 「机器人」开启「机器人能力」开关设置机器人显示名称5.5 配置事件订阅进入「事件订阅」选择「使用长连接接收事件」WebSocket 模式添加事件接收消息 v2.0 (im.message.receive_v2)保存配置5.6 发布应用进入「版本管理与发布」创建版本 → 填写版本说明 → 提交等待审批企业内部应用通常自动通过5.7 配置 OpenClaw将飞书应用的凭证配置到 OpenClaw有三种方式方式一通过向导配置推荐openclaw onboard在配置过程中选择飞书渠道按提示输入 App ID 和 App Secret。方式二通过环境变量exportFEISHU_APP_IDcli_xxxxxxxxxxxxexportFEISHU_APP_SECRETxxxxxxxxxxxxxxxx# Windows PowerShell$env:FEISHU_APP_IDcli_xxxxxxxxxxxx$env:FEISHU_APP_SECRETxxxxxxxxxxxxxxxx方式三通过配置文件编辑~/.openclaw/config.json{channels:{feishu:{appId:cli_xxxxxxxxxxxx,appSecret:xxxxxxxxxxxxxxxx}}}6. 启动与测试6.1 启动 Gateway# 查看服务状态openclaw gateway status# 手动启动openclaw gateway start# 后台运行openclaw gateway start--daemon6.2 访问控制台启动后访问 http://localhost:3000 查看 Web 控制台可以查看 Gateway 状态管理渠道配置查看日志和调试信息管理配对码6.3 测试飞书机器人在飞书中搜索并添加创建的机器人发送消息进行测试如果收到回复说明配置成功 首次使用需要输入配对码pairing code在 Web 控制台查看或运行openclaw pairing code获取。6.4 在群组中使用将机器人添加到飞书群组机器人名称 发送消息即可触发回复也可以设置机器人为群管理员获得更多权限7. 常见问题解决7.1 Node.js 版本问题错误信息Node version is too old# 解决方法升级到 Node 22nvminstall22nvm use227.2 安装失败如果 npm 安装失败尝试使用--force参数npminstall-gopenclaw2026.4.14--force7.3 权限问题macOS 用户可能需要授予系统权限辅助功能无障碍访问文件夹访问权限屏幕录制权限7.4 飞书机器人无响应可能原因解决方法应用未发布确保应用已提交审批并通过权限不足检查已开启 im:message 等必要权限Gateway 未启动运行openclaw gateway start配置错误检查 App ID 和 App Secret 是否正确7.5 WSL2 网络问题Windows WSL2 用户如果遇到网络连接问题# 在 PowerShell 管理员模式下运行wsl--shutdown# 重新启动 WSL2wsl8. 命令速查表8.1 安装与配置命令说明openclaw --version查看版本openclaw onboard运行新手引导openclaw plugins install openclaw/feishu安装飞书插件openclaw plugins list列出已安装插件8.2 Gateway 管理命令说明openclaw gateway start启动 Gatewayopenclaw gateway start --daemon后台运行openclaw gateway stop停止 Gatewayopenclaw gateway status查看状态openclaw gateway logs查看日志8.3 配对码管理命令说明openclaw pairing code获取配对码openclaw pairing list列出已配对设备openclaw pairing revoke id撤销配对8.4 配置文件位置系统配置路径macOS~/.openclaw/config.jsonLinux~/.openclaw/config.jsonWindows%USERPROFILE%\.openclaw\config.json