Open Claw安装教程

⚡ 开源 · 本地执行 · 高可控

OpenClaw

Linux 极速部署 · 让大模型真正操作你的电脑

📖 接上文：上一期我们介绍了什么是 OpenClaw——一个能让大模型真正操作你电脑的开源 AI 智能体框架。这一期，我们来教大家如何在 Linux 系统上安装 OpenClaw。

🤖 快速回顾：什么是 OpenClaw？

OpenClaw 是一个开源、可本地化部署的 AI 智能体框架，支持 Linux / Windows / macOS。通过微信、Telegram、飞书等发送指令，它就能在本地执行具体操作：编写脚本、发送邮件、整理文件、调用 API。🎯 私有化部署 · 数据零上传 · 完全自主可控

📦环境与依赖

一键脚本自动安装，也可手动部署。

依赖	版本	作用
Node.js	≥ v22.0.0	运行时
npm	≥ 10.0.0	包管理器
Git	≥ 2.30.0	版本控制

🚀部署 OpenClaw（三种方式）

▸ 方式一：一键脚本（官方推荐）

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

⚠️ 注意事项：• 脚本会自动检测操作系统并安装 Node.js/npm/Git。• 国内用户若下载缓慢，请先执行：npm config set registry https://registry.npmmirror.com• 安装过程中可能需要 sudo 权限。

▸ 方式二：npm 全局安装

npm install -g openclaw@latest

openclaw onboard --install-daemon

⚠️ 注意事项： • 需要 Node.js ≥ v22.0.0。 • --install-daemon 参数会自动注册为 systemd 服务（Linux）。 • onboard 向导会提示配置 API 密钥和通信渠道。

▸ 方式三：源码编译（开发者）

git clone https://github.com/openclaw/openclaw.git

cd openclaw

npm install -g .

npm run start -- onboard

⚠️ 注意事项： • 适合想体验最新开发版或参与贡献的用户。 • 需要提前安装 Git 和 Node.js。 • 构建时间约 2-5 分钟，请耐心等待。

⚙️API 密钥配置

方法 A：运行向导（推荐）

openclaw onboard

✅ 向导会测试连通性并加密存储密钥，无需手动编辑文件。

方法 B：手动创建 .env 文件

mkdir -p ~/.openclaw

nano ~/.openclaw/.env

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 注意事项：• 切勿将 .env 文件提交到 Git（建议加入 .gitignore）。• 更安全的做法：使用 openclaw secret set <key> 存入系统密钥链。 • API 密钥需要对应账户有足够余额，否则会返回 401 错误。

🎯启动 & 验证

openclaw start

openclaw start --daemon

openclaw doctor

openclaw token

⚠️ Web UI 默认端口 18789，访问需携带 Token。💡 doctor 会检查环境、API 密钥、端口冲突。

🧹卸载 & 清理

openclaw stop

npm uninstall -g openclaw

rm -rf ~/.openclaw

⚠️ 若使用 systemd 服务，还需执行：sudo systemctl disable openclaw并删除 /etc/systemd/system/openclaw.service

🧩插件与扩展生态

内置：文件处理、代码执行、邮件收发、日历管理、浏览器自动化。社区插件通过 SkillHub 安装。

openclaw plugin list

openclaw plugin install feishu-advanced

openclaw plugin create my-tool --template=python

⚠️ 插件运行在独立沙箱中，默认禁止网络访问和文件写入，可在配置中按需授权。

❓常见问题排查

❌ 脚本安装失败 / 网络超时配置代理 export https_proxy=http://127.0.0.1:7890 或手动下载

❌ node: command not found安装 Node.js LTS（推荐 nvm 或 apt）

❌ npm install 卡住 / 超时npm config set registry https://registry.npmmirror.com

❌ Gateway 启动失败 (EADDRINUSE)lsof -i:18789 杀死进程，或修改 config.yaml 中的端口

❌ API 返回 401 Unauthorized检查 ~/.openclaw/.env 密钥，运行 openclaw doctor 测试连接

❌ 渠道（微信/飞书）收不到消息检查 Webhook URL 配置，内网穿透使用 ngrok/frp

⚠️重要风险提示

OpenClaw 是一个强大的 AI 工具，但请在使用前充分了解以下风险：

💰 费用风险

OpenClaw 本身免费，但它需要调用第三方大模型 API（如 OpenAI、Anthropic 等）。这些 API 按使用量收费，如果未设置预算限制或 API 密钥泄露，可能产生意外的高额账单。建议：设置月度预算上限、使用国内免费/低价模型、定期检查用量。

🔒 信息泄露风险

OpenClaw 能够访问你的文件系统、发送邮件、执行命令。如果配置不当（如弱密码、错误暴露端口），或安装了恶意第三方插件，可能导致敏感数据泄露或系统被操控。建议：仅在受信任环境部署、定期审查插件来源、使用防火墙限制访问、不要赋予不必要的系统权限。

📌 本教程仅提供技术参考，请自行评估风险并承担相应责任。建议先在隔离环境中测试。

OpenClaw · 让 AI 从「对话」到「执行」

即刻部署你的 Linux 服务器，体验下一代智能体

实训室维护组公众号

实训室维护组一直致力为同学们的计算机相关专业学习提供帮助，也将为大家带来更多专业软件的安装与使用教程，实用的计算机使用技巧，计算机领域的前沿知识介绍。

排版刘汉宇 | 编辑刘汉宇