一文教会你OpenClaw的安装实操+教程！手把手超详细

RskAi
0 阅读6分钟

近期OpenClaw热度飙升，这款能接入AI模型、调度自动化任务的工具被形象地称为“赛博养虾”。但很多用户在安装过程中会遇到环境配置复杂、权限报错、依赖缺失等问题。

本文提供从零开始的OpenClaw安装实操教程，覆盖Windows原生、WSL2、Linux及飞书接入全流程。如果你在看完教程后仍然卡在某个环节无法解决，欢迎访问免费聚合镜像站RskAi（ai.rsk.cn）——无需配置环境，直接使用Gemini/GPT-4/Claude三合一模型，还能在对话框里向我们提问求助。

一、安装前准备：你需要哪些基础环境？

OpenClaw对运行环境有一定要求，建议在开始前检查以下项目

image.png

二、Windows安装OpenClaw的两种方案

方案A：原生PowerShell安装（适合快速体验）

这是最简单的上手方式，但不适合长期稳定运行[]。

第一步：以管理员身份打开PowerShell
按Win键，搜索“PowerShell”，右键选择“以管理员身份运行”。

第二步：执行一键安装命令

powershell

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta

如果遇到执行策略报错，先运行以下命令[]：

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

第三步：初始化配置
安装完成后执行：

powershell

openclaw onboard --flow quickstart

按照向导提示选择模型服务商（如Kimi、阿里云百炼等），并输入对应的API Key[]。

第四步：启动服务并访问面板

powershell

openclaw start
openclaw dashboard

浏览器会自动打开http://127.0.0.1:18789，使用生成的Token登录即可。

方案B：WSL2 + Ubuntu安装（官方推荐，稳定性最佳）

OpenClaw官方明确建议：Windows用户通过WSL2运行可获得最佳兼容性[]。

第一步：安装WSL2
在管理员PowerShell中执行[]：

powershell

wsl --install

安装完成后重启电脑。

第二步：启动Ubuntu并更新系统
重启后在开始菜单打开Ubuntu，设置用户名和密码，然后执行：

bash

sudo apt update && sudo apt upgrade -y

第三步：安装OpenClaw

bash

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

或者使用npm安装[]：

bash

npm install -g openclaw@latest

第四步：初始化并启动

bash

openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard

Windows常见报错与解决

报错现象可能原因解决方法
openclaw命令找不到环境变量未配置关闭当前终端重新打开，或手动添加npm全局路径[]
npm安装超时网络问题切换淘宝镜像：npm config set registry https://registry.npmmirror.com/[]
端口18789被占用已有进程占用修改端口：openclaw configure --section server[]
WSL中systemd未启用配置缺失编辑/etc/wsl.conf添加[boot] systemd=true，重启WSL[]

三、Linux（Ubuntu）安装OpenClaw

第一步：更新系统并安装基础工具

bash

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git python3 python3-pip

第二步：安装Node.js 22

bash

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

第三步：安装OpenClaw

bash

npm install -g openclaw@latest

第四步：初始化并启动

bash

openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard

四、配置飞书机器人接入（可选）

将OpenClaw接入飞书后，可以在飞书群里直接与AI对话。

1. 安装飞书插件

在OpenClaw控制台或终端执行[]：

bash

openclaw plugins install @m1heng-clawd/feishu

2. 飞书开放平台配置

  • 登录[飞书开放平台]，创建企业自建应用
  • 获取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[]。

安装技能管理工具clawhub：

bash

npm install -g clawhub

安装三大必备Skills：

bash

clawhub 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"
      }
    }
  }
}

六、常见问题FAQ

Q1：安装过程中出现“npm ERR! code 1”怎么办？
A：通常是权限问题或依赖冲突。Windows用户尝试以管理员身份运行终端；Linux/Mac用户使用sudo npm install -g openclaw。也可清理npm缓存后重试：npm cache clean --force[]。

Q2：OpenClaw启动后，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后功能仍无法使用？
A：Skills安装后需要重启OpenClaw网关：openclaw gateway restart。验证技能是否安装成功：clawhub list[]。

Q6：我不想折腾环境配置，只想用AI怎么办？
A：推荐直接访问RskAi（ai.rsk.cn），国内网络即可直接使用，聚合了Gemini/GPT-4/Claude三款模型，支持文件上传和联网搜索，目前完全免费。如果在OpenClaw安装中遇到问题，也可以在RskAi的对话框里提问，我们会尽力协助。

七、总结：选择适合自己的方案

OpenClaw作为一款强大的AI Agent工具，值得花时间部署，但其环境配置确实有一定门槛。我们整理了三种选择：

  1. 动手能力强的用户：按照本文教程尝试WSL2或Linux部署，可获得完整自托管体验。
  2. 遇到困难或不想折腾的用户：欢迎访问RskAi（ai.rsk.cn），在对话框里向我们提问，我们会尽力解答安装问题。
  3. 纯粹想用AI的用户：直接使用RskAi，无需安装，国内网络直达，三款顶级模型免费使用。

无论你选择哪种方式，都能进入AI助手的精彩世界。如果在安装过程中遇到本文未覆盖的问题，欢迎来RskAi交流提问！

【本文完】

avatar
文章
阅读
粉丝