乐于分享
好东西不私藏

开源 AI 智能体 OpenClaw 实战|给大模型装上手脚,本地部署完整教程

开源 AI 智能体 OpenClaw 实战|给大模型装上手脚,本地部署完整教程
🎯导语
我们日常使用的 GPT、Claude 大多只能文字对话,只能给方案,没法直接帮你操作电脑。
今天分享热门开源项目 OpenClaw(圈内俗称龙虾)—— 本地优先 AI 智能体网关。
一句话概括:给大模型装上手脚,接收自然语言指令,直接操作文件、执行命令、自动化任务,支持微信 / Telegram 等多渠道远程调用

Ⅰ.什么是openclaw?

OpenClaw 是基于 MIT 协议开源的本地 AI Agent 框架。

官方口号:The AI that actually does things(真正能做事的 AI)

核心优势

  • 本地私有化运行,对话日志默认保存在本机,数据自主可控
  • 兼容云端大模型(GPT/Claude/ 通义千问)+ 本地 Ollama 开源模型
  • 拥有文件读写、终端命令、浏览器自动化、脚本运行能力
  • 支持十余种通讯渠道远程下发指令
  • 跨平台:Windows /macOS/ Linux / 服务器均可部署

和普通对话 AI 核心区别

你:帮我把桌面图片分类归档

ChatGPT:告诉你操作步骤,需要手动执行

OpenClaw:收到指令 → 自动新建文件夹、移动、归类文件,直接完成

⚠️重点前置安全预警(务必阅读)

OpenClaw 拥有本机文件系统、终端执行权限,能力极强,风险同步放大

  1. 不要把公网端口直接暴露外网,禁止裸跑
  2. 不要随意导入来路不明第三方 Skill 插件
  3. 测试优先使用非重要电脑,避免恶意指令误删文件
  4. 生产服务器部署务必开启访问令牌鉴权
Ⅱ.部署前置条件
硬件依赖:Node.js≥22.0版本
检查命令(终端/PowerShell)
node --version
版本不足,前往Node.js官网下载。(建议通过nvm管理更方便
可选准备:大模型API Key(OpenAI、Claude、通义、DeepSeek等),也可搭配Ollama本地模型免API。
Ⅲ.安装(建议NPM手动全局安装)
所有平台通用,先安装好Node.js
# 设置国内镜像(解决下载慢)npm config set registry https://registry.npmmirror.com# 全局安装最新版npm install -g openclaw# 验证是否安装成功openclaw --version
Ⅳ.初始化配置向导(核心实战步骤)
安装完成后,执行初始化引导程序
openclaw onboard

跟随交互式向导依次设置:

  1. 阅读风险声明 → Yes 确认继续
  2. 启动模式:选择 QuickStart(快速模式)
  3. LLM 模型服务商:填入你的 API Key
    👉暂时没有密钥可先选择Skip for now,后续在 Web 面板配置
  4. 通讯渠道配置:新手可先 Skip,先本地测试
  5. 是否安装 Skills 技能包:新手先选 No
  6. Hooks 钩子、自动启动:全部选择稍后配置

配置文件存放路径

Mac/Linux:~/.openclaw/openclaw.jsonWindowsC:\Users\用户名\.openclaw
Ⅴ.启动服务&开始实战使用
1.启动网关服务
openclaw gateway
网关启动成功后,访问可视化管理面板
openclaw dashboard
【浏览器自动打开:http://localhost:18789】
2.测试第一条指令(验证是否部署成功)
方式A:终端直接对话测试
openclaw chat

输入指令示例👉:

📣在桌面新建一个「AI 笔记」文件夹

正常情况下 OpenClaw 自动解析指令,调用文件工具完成创建。

方式B:Web可视化面板聊天窗口直接下发指令
3.常用基础命令汇总(收藏备用)
# 检查环境、配置完整性,自动修复简单问题openclaw doctor# 生成远程访问令牌(公网访问必须开启)openclaw token generate# 查看帮助文档openclaw help# 重启网关openclaw restart
Ⅵ.进阶玩法方向(拓展思路)
    接入 Ollama 本地大模型,实现完全离线运行,无需任何 API绑定 Telegram 机器人,手机远程发送消息操控电脑安装 ClawHub 技能:PDF 解析、邮件自动处理、定时任务编写自定义 Skill,打造专属自动化工作流
    Ⅶ.新手高频报错排查
      node 版本过低:卸载旧 Node,重装 22 + 版本npm 下载超时:切换淘宝镜像源Windows 权限报错:PowerShell 必须管理员运行API 调用失败:核对 Key、模型名称、代理网络网关端口占用:修改配置更换 18789 端口
      Ⅷ.汇总

      AI Agent 是接下来 AIGC 重要方向,OpenClaw 门槛适中,非常适合新手入门学习「大模型工具调用」。建议先本地小规模测试,熟悉权限机制之后再搭建自动化工作流。

      后续计划更新:Ollama 本地模型对接教程、Telegram 远程控制完整配置,不要错过。

      💡温馨提示:开源项目请遵守开源协议,合法合规使用,禁止用于恶意自动化操作。

      如果对你有帮助,麻烦帮忙点个免费的小红心推荐也是对阿生的一种鼓励

      点点关注

      点点赞