近几个月,「AI Agent」成为技术圈的高频词,但大多数人停留在 Demo、插件和概念层。
真正能跑在本地 / 服务器、拥有真实权限、能持续执行任务的 Agent 并不多。OpenClaw,正是目前少数几个工程完整、可部署、可二次开发的开源 AI Agent 框架之一。
这篇文章不讲愿景、不画饼,只讲怎么搭、怎么跑、怎么不翻车。

一句话说明白:
OpenClaw 是一个可部署在本地或服务器上的开源 AI Agent 框架,具备 Gateway(通信)、Dashboard(控制台)和 Skills(能力插件)三大核心模块。
和 ChatGPT / 插件的本质区别在于:
所以 OpenClaw 不是“聊天机器人”,而是一个真正意义上的 AI 执行体。
很多人第一次部署失败,不是技术不行,而是没搞清楚它的危险边界。
OpenClaw 具备的能力包括但不限于:
- 读写本地文件
- 调用系统命令
- 请求外部 API
- 长时间后台运行
- 通过 Gateway 接入 Telegram / Discord 等
👉 这意味着它是“高权限 Agent”
所以:
❌ 不openclaw 部署建议直接装在日常办公电脑
✅ 强烈建议:独立 VPS / Docker / 隔离环境
推荐配置(实战可用)
- 系统:Ubuntu 20.04 / 22.04
- CPU:2 核起步(4 核更稳)
- 内存:4GB 起步(8GB 更舒服)
- 用途:只跑 OpenClaw,不混别的服务
Windows 不是不能跑,但用于引流示范,Linux 更专业、稳定、通用
1️⃣ 更新系统 & 基础工具
2️⃣ 安装 Node.js(OpenClaw 必需)
官方要求 Node 18+,推荐用 nvm:
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18
验证:
3️⃣(可选但推荐)安装 pnpm
源码部署 & 二开基本都用它:
npm install -g pnpm
方式一:CLI 全局安装(最快)
适合:
- 想快速跑起来
- 不改源码
npm install -g openclaw
验证:
openclaw –version
看到版本号,说明 CLI 安装成功。
方式二:源码部署(专业玩家 / 二开)
适合:
- 想改 UI
- 想接自己系统
- 想写自定义 skills
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
OpenClaw 不是装完就能用,必须执行 onboarding。
CLI 安装方式:
openclaw onboard –install-daemon
源码方式:
pnpm openclaw onboard –install-daemon
这个步骤会做几件事:
- 初始化 Gateway
- 生成本地配置
- 注册运行服务(daemon)
- 绑定 Dashboard
- 创建 Agent 身份
👉 90% 的问题,都发生在“没正确 onboard”
openclaw gateway status
正常情况下你会看到:
- running
- healthy
- listening on port xxx
如果不是,直接看日志:
openclaw gateway logs
openclaw dashboard
你将看到:
- Agent 状态
- 会话记录
- Skills 管理
- Gateway 连接情况
- 系统日志
👉 很多人引流,就是靠这个 Dashboard 截图
你可以把 Skills 理解成:
AI 能调用的“函数 + 权限集合”
比如:
- 查询区块链数据
- 调用内部 API
- 执行脚本
- 发送 Telegram 消息
- 读取服务器状态
新手建议顺序:
- 只读类 skills
- 通知 / 查询类
- 再考虑执行型
不要一上来给它 root 权限
❌ 1. Gateway 起不来
- Node 版本不对
- 端口被占用
- 没 onboard 完
❌ 2. Dashboard 打不开
- 防火墙没放端口
- 服务器没映射
- 服务未运行
❌ 3. Skill 不生效
- 权限没授权
- 配置未 reload
- 写法不符合 schema
❌ 4. Agent 行为不可控
- skills 权限过大
- prompt 未限制
- 没做沙箱
❌ 5. 一直报错但不知道为什么
- 不看 gateway logs
- 不看 dashboard logs
❌ 6. 直接装在生产服务器
- 这是最危险的
满足以下 5 条,就可以对外说你“会 OpenClaw”:
✅ CLI 正常
✅ Gateway running
✅ Dashboard 可访问
✅ 能启用至少 1 个 skill
✅ Agent 能完成一次完整任务
发布者:Ai探索者,转载请注明出处:https://javaforall.net/253651.html原文链接:https://javaforall.net
