JavaScriptNode.jsAI
OpenClaw 本地部署与配置实战指南
OpenClaw 是一个开源 AI Agent 框架，支持本地或服务器部署。介绍其核心模块、环境准备（Ubuntu、Node.js）、安装方式（CLI 或源码）、初始化流程及常见问题排查。重点强调安全权限控制，建议使用隔离环境，避免在生产机器直接运行。通过 Gateway 和 Dashboard 管理 Agent 状态与技能插件，确保任务可控执行。
OpenClaw 是一个开源 AI Agent 框架，支持本地或服务器部署。介绍其核心模块、环境准备（Ubuntu、Node.js）、安装方式（CLI 或源码）、初始化流程及常见问题排查。重点强调安全权限控制，建议使用隔离环境，避免在生产机器直接运行。通过 Gateway 和 Dashboard 管理 Agent 状态与技能插件，确保任务可控执行。
一句话说明：OpenClaw 是一个可部署在本地或服务器上的开源 AI Agent 框架，具备 Gateway（通信）、Dashboard（控制台）和 Skills（能力插件）三大核心模块。
| 对比项 | 普通 AI 工具 | OpenClaw |
|---|---|---|
| 运行位置 | 云端 | 本地 / VPS |
| 权限 | 受限 | 可控高权限 |
| 持久运行 | 否 | 是 |
| 自动执行 | 弱 | 强 |
| 可二开 | 几乎不可 | 完全可 |
OpenClaw 不是'聊天机器人'，而是一个真正意义上的 AI 执行体。
OpenClaw 具备的能力包括但不限于：
这意味着它是'高权限 Agent'。不建议直接装在日常办公电脑，强烈建议使用独立 VPS、Docker 或隔离环境。
推荐配置（实战可用）
Linux 更专业、稳定、通用。
sudo apt update
sudo apt install -y git curl unzip
官方要求 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
验证：
node -v
npm -v
源码部署 & 二开基本都用它：
npm install -g pnpm
适合想快速跑起来且不改源码的用户。
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。
openclaw onboard --install-daemon
pnpm openclaw onboard --install-daemon
这个步骤会做几件事：
90% 的问题都发生在'没正确 onboard'。
openclaw gateway status
正常情况下你会看到 running、healthy、listening on port xxx。如果不是，直接看日志：
openclaw gateway logs
openclaw dashboard
你将看到 Agent 状态、会话记录、Skills 管理、Gateway 连接情况、系统日志。
你可以把 Skills 理解成 AI 能调用的'函数 + 权限集合'。
比如：
新手建议顺序：
不要一上来给它 root 权限。
满足以下 5 条，即可视为搭建成功： ✅ CLI 正常 ✅ Gateway running ✅ Dashboard 可访问 ✅ 能启用至少 1 个 skill ✅ Agent 能完成一次完整任务
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online