OpenClaw 是基于 TypeScript 开发的开源 AI 智能体，支持在 Windows 和 Linux 系统部署。文章详细记录了 Node.js 环境搭建、OpenClaw 原版与汉化版的安装命令、配置向导操作流程（含模型选择与 Token 获取），以及通过浏览器访问控制界面的方法。此外还包含 Nginx 反向代理配置方案及解决网关连接错误、Token 不匹配等常见问题。
OpenClaw（曾用名：Clawdbot、Moltbot），一款可以部署在个人电脑上的 AI 代理，采用'龙虾'图标设计，slogan 是'The AI that actually does things'，由程序员彼得·斯坦伯格开发。核心开发语言为 TypeScript，是一个采用'龙虾'图标设计的开源 AI 智能体项目。该项目定位为个人 AI 代理，具备操作软件与长期记忆功能。
node -v 和 npm -v，有出现版本表示安装成功。npm config set registry https://registry.npmmirror.com/npm config set prefix "D:\tools\node_global"
npm config set cache "D:\tools\node_cache"
D:\tools\node_globalnpm install -g npm@latestcurl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
npm -v
npm install -g npm@latest
# 安装
npm install -g openclaw@latest
# 安装完成后参考 openclaw 配置向导
# 运行安装向导
openclaw onboard --install-daemon
# 启动网关
openclaw gateway --port 18789 --verbose
# 安装
npm install -g openclaw-cn@latest
# 安装完成后参考 openclaw 配置向导
# 运行安装向导
openclaw-cn onboard --install-daemon
# 启动网关
openclaw-cn gateway --port 18789 --verbose
执行命令：openclaw-cn onboard --install-daemon 开始配置向导，设置向导的过程中通过：上下左右方向键进行选择，空格键表示勾选，回车键表示确定。此处向导以汉化版为例，原版英文的格式和选择基本相同。
.openclaw\openclaw.json 中的 token，token 在 json 中的 gateway.auth.token 位置。将该 token 复制出来替换掉 http://127.0.0.1:18789/?token= 后边的值，然后在浏览器打开在浏览器打开网址：http://127.0.0.1:18789/?token=b6b6921ce061e056dd5c7f779ed05e4a6fcd3b95e4cfaecd，如果显示已连接表示正常，否则就检测 token 是否对得上
输入一个问题进行测试：创建一个 readme.txt
输入测试，测试上一个步骤创建的文件
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://127.0.0.1:18789;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 86400;
}
}
编辑 ~/.openclaw/openclaw.json，然后增加一行："trustedProxies": ["127.0.0.1"]
{
"gateway": {
"bind": "loopback",
"port": 18789,
"trustedProxies": ["127.0.0.1"],
"auth": {
"mode": "token",
"token": "your-secure-token-here"
}
}
}
openclaw-cn gateway解决方法：
原版执行：
openclaw config set gateway.controlUi.allowInsecureAuth true
openclaw gateway restart
汉化版执行：
openclaw-cn config set gateway.controlUi.allowInsecureAuth true
openclaw-cn gateway restart
解决方法：需要给 Nginx 配置 HTTPS 证书
解决方法：重新打开 ~/.openclaw/openclaw.json 配置查看 token 是多少
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online