近期OpenClaw热度飙升这款能接入AI模型、调度自动化任务的工具被形象地称为“赛博养虾”。但很多用户在安装过程中会遇到环境配置复杂、权限报错、依赖缺失等问题。本文提供从零开始的OpenClaw安装实操教程覆盖Windows原生、WSL2、Linux及飞书接入全流程。如果你在看完教程后仍然卡在某个环节无法解决欢迎访问免费聚合镜像站RskAiai.rsk.cn——无需配置环境直接使用Gemini/GPT-4/Claude三合一模型还能在对话框里向我们提问求助。一、安装前准备你需要哪些基础环境OpenClaw对运行环境有一定要求建议在开始前检查以下项目二、Windows安装OpenClaw的两种方案方案A原生PowerShell安装适合快速体验这是最简单的上手方式但不适合长期稳定运行。第一步以管理员身份打开PowerShell按Win键搜索“PowerShell”右键选择“以管理员身份运行”。第二步执行一键安装命令powershell ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta如果遇到执行策略报错先运行以下命令powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser第三步初始化配置安装完成后执行powershellopenclaw onboard --flow quickstart按照向导提示选择模型服务商如Kimi、阿里云百炼等并输入对应的API Key。第四步启动服务并访问面板powershellopenclaw start openclaw dashboard浏览器会自动打开http://127.0.0.1:18789使用生成的Token登录即可。方案BWSL2 Ubuntu安装官方推荐稳定性最佳OpenClaw官方明确建议Windows用户通过WSL2运行可获得最佳兼容性。第一步安装WSL2在管理员PowerShell中执行powershellwsl --install安装完成后重启电脑。第二步启动Ubuntu并更新系统重启后在开始菜单打开Ubuntu设置用户名和密码然后执行bashsudo apt update sudo apt upgrade -y第三步安装OpenClawbashcurl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git或者使用npm安装bashnpm install -g openclawlatest第四步初始化并启动bashopenclaw onboard --install-daemon openclaw gateway start openclaw dashboardWindows常见报错与解决报错现象可能原因解决方法openclaw命令找不到环境变量未配置关闭当前终端重新打开或手动添加npm全局路径npm安装超时网络问题切换淘宝镜像npm config set registry https://registry.npmmirror.com/端口18789被占用已有进程占用修改端口openclaw configure --section serverWSL中systemd未启用配置缺失编辑/etc/wsl.conf添加[boot] systemdtrue重启WSL三、LinuxUbuntu安装OpenClaw第一步更新系统并安装基础工具bashsudo apt update sudo apt upgrade -y sudo apt install -y curl git python3 python3-pip第二步安装Node.js 22bashcurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs第三步安装OpenClawbashnpm install -g openclawlatest第四步初始化并启动bashopenclaw onboard --install-daemon openclaw gateway start openclaw dashboard四、配置飞书机器人接入可选将OpenClaw接入飞书后可以在飞书群里直接与AI对话。1. 安装飞书插件在OpenClaw控制台或终端执行bashopenclaw plugins install m1heng-clawd/feishu2. 飞书开放平台配置登录飞书开放平台创建企业自建应用获取App ID和App Secret在“权限管理”中批量导入以下权限json{ scopes: { tenant: [im:message, im:message:send_as_bot, contact:user.employee_id:readonly], user: [im:message.p2p_msg:readonly] } }在“事件订阅”中添加事件im.message.receive_v1订阅方式选择“使用长连接接收事件”3. 完成绑定在OpenClaw中配置App ID和App Secret在飞书中向机器人发送消息获取配对码在OpenClaw控制台输入配对码完成绑定五、OpenClaw核心Skills安装功能扩展OpenClaw的基础安装仅提供核心框架要激活联网搜索、自动安装技能等功能需安装必备Skills。安装技能管理工具clawhubbashnpm install -g clawhub安装三大必备Skillsbashclawhub install tavily-search # 联网搜索技能 clawhub install find-skills # 技能检索技能 clawhub install proactive-agent # 主动迭代技能配置Tavily API Key用于联网搜索编辑~/.openclaw/config.json添加json{ skills: { customEntries: { tavily: { apiKey: 你的Tavily Search API-Key } } } }六、常见问题FAQQ1安装过程中出现“npm ERR! code 1”怎么办A通常是权限问题或依赖冲突。Windows用户尝试以管理员身份运行终端Linux/Mac用户使用sudo npm install -g openclaw。也可清理npm缓存后重试npm cache clean --force。Q2OpenClaw启动后Web面板无法访问A首先确认服务是否正常运行openclaw status。检查防火墙是否放行18789端口云服务器需在安全组中放行。本地访问使用http://127.0.0.1:18789[citation:4]。Q3配置阿里云百炼API Key后提示“认证失败”A检查AccessKey ID和Secret是否正确确保账号已完成实名认证且模型调用额度未用完。百炼API endpoint应为https://bailian.aliyuncs.com。Q4飞书机器人无响应怎么办A检查飞书开放平台中事件订阅是否配置正确长连接是否建立。在OpenClaw端查看日志openclaw logs --filter feishu。Q5安装完Skills后功能仍无法使用ASkills安装后需要重启OpenClaw网关openclaw gateway restart。验证技能是否安装成功clawhub list。Q6我不想折腾环境配置只想用AI怎么办A推荐直接访问RskAi国内网络即可直接使用聚合了Gemini/GPT-4/Claude三款模型支持文件上传和联网搜索目前完全免费。如果在OpenClaw安装中遇到问题也可以在RskAi的对话框里提问我们会尽力协助。七、总结选择适合自己的方案OpenClaw作为一款强大的AI Agent工具值得花时间部署但其环境配置确实有一定门槛。我们整理了三种选择动手能力强的用户按照本文教程尝试WSL2或Linux部署可获得完整自托管体验。遇到困难或不想折腾的用户欢迎访问RskAi在对话框里向我们提问我们会尽力解答安装问题。纯粹想用AI的用户直接使用RskAi无需安装国内网络直达三款顶级模型免费使用。无论你选择哪种方式都能进入AI助手的精彩世界。如果在安装过程中遇到本文未覆盖的问题欢迎来RskAi交流提问【本文完】