1. 安装前准备OpenClaw 官网https://openclaw.org请访问官网获取最新文档、下载链接和官方系统要求。在开始安装之前请确保你的开发环境满足以下要求并完成必要的准备工作这将有助于后续步骤的顺利进行。1.1 系统要求根据 OpenClaw 官网文档安装前请确保你的系统满足以下最低要求操作系统WindowsWindows 10 64位版本 1809 或更高或 Windows 11macOSmacOS 12 Monterey 或更高版本LinuxUbuntu 20.04 LTS、Ubuntu 22.04 LTS、CentOS 8 或兼容的发行版需支持 glibc 2.31处理器CPU64位双核处理器2.0 GHz 或更高内存RAM最低 8 GB推荐 16 GB 或以上以获得更好性能磁盘空间至少 10 GB 可用空间用于安装程序、依赖库和缓存图形显示支持 OpenGL 3.3 或更高版本的显卡用于图形界面组件网络稳定的互联网连接用于下载安装包、依赖项和可能的模型文件其他管理员/root 权限用于系统级安装支持 AVX2 指令集的 CPU某些加速功能需要已安装最新的系统更新和驱动程序注意以上要求基于 OpenClaw v2.3 版本具体版本可能有所不同请以官网最新文档为准。1.2 软件依赖Node.js版本 16.x 或 18.xLTS 版本推荐。你可以通过以下命令检查当前版本node--version包管理器npm随 Node.js 安装或 yarn、pnpm 等。代码编辑器推荐使用 Visual Studio Code、WebStorm 或你熟悉的任何编辑器。1.3 网络与环境稳定的网络连接用于下载依赖包和可能的在线资源。命令行终端确保你熟悉基本的终端操作如 cd、ls、mkdir 等。权限检查确保你对目标安装目录具有读写权限。1.4 可选准备版本控制建议初始化 Git 仓库便于后续代码管理。浏览器安装 Chrome 或 Firefox 用于可能的界面调试。API 密钥/凭证如果安装过程需要访问外部服务如某些云服务、数据库请提前准备好相应的访问凭证。完成上述检查后你就可以进入下一步的安装流程了。2.安装步骤2.1 macOS/Linux/WSLcurl‑fsSL https://openclaw.ai/install.sh|bash2.2 WindowsPowerShell以管理员身份运行Step1安装iwr‑useb https://openclaw.ai/install.ps1|iexStep2验证openclaw-vStep3准备飞书app① 创建飞书机器人获取app id 与 secrethttps://open.feishu.cn/?langzh-CN右上角-开发者后台-创建企业自建应用-选择创建好的应用② 事件配置在飞书应用管理页面左侧导航栏找到“事件与回调”在“事件配置”页签中选择“长连接接收事件”然后保存③ 回调配置回调配置中订阅方式选择“使用长连接接收回调”,点击添加事件搜索 im.message.receive_v1开通权限④ 权限配置管理页面左侧导航栏找到权限管理点击页面中的批量导入权限按钮{ scopes: { tenant: [ im:message, im:message.p2p_msg:readonly, im:message.group_at_msg:readonly, im:message:send_as_bot, im:resource, contact:user.base:readonly, im:message.group_msg, im:message:readonly, im:message:update, im:message:recall, im:message.reactions:read, docx:document:readonly, drive:drive:readonly, wiki:wiki:readonly, bitable:app:readonly, task:task:read, contact:contact.base:readonly, docx:document, docx:document.block:convert, drive:drive, wiki:wiki, bitable:app, task:task:write ], user: [] } }⑤ 创建版本并发布管理页面左侧导航栏找到“版本管理与发布”右上角创建版本⑥ 通信策略powershell中输入#开启dmPolicy私聊/DM 策略与群聊策略openclaw configsetchannels.feishu.dmPolicypairingopenclaw configsetchannels.feishu.groupPolicyopen#查整块飞书配置openclaw config get channels.feishuStep4配置Openclawopenclaw onboard① 选择yes接受风险运行配置向导时确认接受相关风险提示② 采用quickstart这将自动配置基本设置和默认参数。选择模型供应商③ 配置api-key到对应的模型供应商的API开发平台获取④ 配置渠道采用什么社交软件与openclaw进行通信此处我使用的是飞书⑤ 选择群聊策略选择 Open - respond in all groups (requires mention)这个模式下任何飞书群只要把机器人拉进去机器人就可以触发回复。⑥ 跳过搜索配置如果不需要搜索功能可以跳过skip for now⑦ 其他配置暂时跳过skip for now⑧ 如何hatch your bot你希望以哪种方式启动你的机器人实例do this later⑨ 工具权限配置# OpenClaw 权限完整设置 echo 1. 设置工具基础权限为 full功能最完整openclaw configsettools.profilefullecho 2. 设置 exec 为白名单模式最推荐的安全方式openclaw configsettools.exec.securityallowlistecho 3. 让不在白名单的命令必须人工确认重要安全层openclaw configsettools.exec.askon-missecho 4. 更新 safeBins保留你常用命令 常用安全工具openclaw configsettools.exec.safeBins[ls,pwd,cat,echo,git,npm,node,python,python3,pip,pip3,conda,docker,docker-compose,mkdir,rm,cp,mv,touch,grep,find,curl,wget,ps,tar,unzip,zip,make,jq,head,tail,wc,claude]echo 5. 信任完整 conda 目录解决 conda/python 警告openclaw configsettools.exec.safeBinTrustedDirs[/root/miniconda3/bin, /root/miniconda3/condabin]echo 6. 自动修复 doctor 警告safeBinProfiles 等openclaw doctor--fixecho 7. 重启 gateway 让所有配置生效openclaw gateway restartecho 设置完成下面显示最终配置 echo 查看工具总配置 openclaw config get toolsecho 查看Exec 执行配置最重要openclaw config get tools.exececho Approvals 当前状态 openclaw approvals get⑩ 快速local通信验证进行本地通信验证openclaw tui3.openclaw对话验证3.1 对话验证3.2 生产级部署配置systemd服务自启动# 安装为 systemd user 服务开机自启 自动重启openclaw gateway install--runtime node systemctl--user enable--now openclaw-gateway配置集中化目录~/.openclaw/ openclaw.json主配置文件 credentials.jsonAPI Key 等凭证 workspace/Agent 工作空间开启Sandbox安全隔离{sandbox:{enabled: true,runtime:docker,image:openclaw/sandbox:latest,resourceLimits:{cpu:1.0,memory:512M,timeout: 30000}}}健康检查与监控openclaw doctor# 环境健康诊断官方最重要命令openclaw gateway status# 查看 Gateway 运行状态openclaw logs--follow# 实时日志openclaw channels status# 查看通道状态