OpenClaw小龙虾是github 获得星标最多的项目，OpenClaw之所以能在GitHub上获得极高的关注度，主要原因在于它提供了一个功能强大、易于扩展的AI助手开发平台。把整个操作系统，打造成AI！
OpenClaw官网：OpenClaw — Personal AI Assistant
以前的安装记录：https://skywalk.blog.ZEEKLOG.net/article/details/
本来感觉OpenClaw安装是挺简单的，没想到巨坑，有一台机器装好后没有web管理面板.....所以本来很简短的文档，写成了巨幅文档。
先在192.168.1.12安装，但是它没有systemd服务，导致OpenClaw的服务无法自动启动。需要手工执行openclaw gateway命令启动。
后在192.168.1.19安装。但是装好后没有web管理面板，反复删除重装也没有，最后是安装的openclaw-cn ，才解决了问题。参见这个文档：https://skywalk.blog.ZEEKLOG.net/article/details/
 npm安装
npm i -g openclaw
安装后启动
但是启动失败，没有openclaw命令。于是还是用一键安装。
pnpm安装
先配置pnpm
pnpm setup
激活pnpm环境
source /home/skywalk/.bashrc
安装OpenClaw
pnpm add -g openclaw@latest pnpm approve-builds -g # approve openclaw, node-llama-cpp, sharp, etc. 
耗时：
pnpm add -g openclaw@latest Done in 2m 20s using pnpm v10.30.3
pnpm approve-builds -g 选择build所有，耗时约5分钟
配置OpenClaw
openclaw onboard --install-daemon
一键安装
一键安装的好处是省心省力，啥依赖的软件都可以自己装，还能获得源代码。
缺点是国内会很慢，而且会因为github抽风而安装失败。
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
也可以用这句
curl -fsSL https://openclaw.ai/install.sh | bash
显示
 🦞 OpenClaw Installer Your AI assistant, now without the $3,499 headset. ✓ Detected: linux Install plan OS: linux Install method: git Requested version: latest Git directory: /home/skywalk/openclaw Git update: 1 [1/3] Preparing environment · Node.js not found, installing it now · Installing Node.js via NodeSource · Installing Linux build tools (make/g++/cmake/python3)
安装的时候发现windows的powershell下可以一键安装，但是不想用自己的windows机器，就还是用ubuntu，用192.168.1.19那台。后来换成了1.12那台。
安装加速
为了加快安装速度，先apt安装上python3.11 
sudo apt install python3.11 
为了加速，手工安装了nodejs 24 ，参见文档：https://skywalk.blog.ZEEKLOG.net/article/details/
也可以升级node，用命令：
npm install -g n 
因为github抽风，一键安装时到后期有可能报错：
fatal: unable to access 'https://github.com/openclaw/openclaw.git/': SSL connection timeout
那就用gitcode的镜像，手工下载，或者一键之前，先手工下载：
git clone https://gitcode.com/GitHub_Trending/cl/openclaw
注意，需要安装在用户根目录。
然后一键安装
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
即使这样，因为github抽风，有时候也会碰到一些库无法安装成功的问题。
启动配置：
openclaw onboard
详细配置
配置模型
配置hooks
 Enable hooks? │ ◻ Skip for now │ ◻ 🚀 boot-md │ ◻ 📎 bootstrap-extra-files │ ◻ 📝 command-logger │ ◻ 💾 session-memory └ Please select at least one option.
显示：
◇ Control UI ───────────────────────────────────────────────────────────────────────────────╮ │ │ │ Web UI: http://127.0.0.1:18789/ │ │ Web UI (with token): │ │ http://127.0.0.1:18789/#token=020470dd43 │ │ Gateway WS: ws://127.0.0.1:18789 │ │ Gateway: not detected (gateway closed (1006 abnormal closure (no close frame)): no close │ │ reason) │ │ Docs: https://docs.openclaw.ai/web/control-ui │ │ │ ├──────────────────────────────────────────────────────────────────────────────────────────◇ Dashboard ready ────────────────────────────────────────────────────────────────╮ │ │ │ Dashboard link (with token): │ │ http://127.0.0.1:18789/#token=020470dd43 │ │ Copy/paste this URL in a browser on this machine to control OpenClaw. │ │ No GUI detected. Open from your computer: │ │ ssh -N -L 18789:127.0.0.1:18789 │ │ Then open: │ │ http://localhost:18789/ │ │ http://localhost:18789/#token=020470dd43 │ │ Docs: │ │ https://docs.openclaw.ai/gateway/remote │ │ https://docs.openclaw.ai/web/control-ui │ │ │ ├──────────────────────────────────────────────────────────────────────────────────╯ │ ◇ Web search (optional) ─────────────────────────────────────────────────────────────────╮ │ │ │ If you want your agent to be able to search the web, you’ll need an API key. │ │ │ │ OpenClaw uses Brave Search for the `web_search` tool. Without a Brave Search API key, │ │ web search won’t work. │ │ │ │ Set it up interactively: │ │ - Run: openclaw configure --section web │ │ - Enable web_search and paste your Brave Search API key │ │ │ │ Alternative: set BRAVE_API_KEY in the Gateway environment (no config changes). │ │ Docs: https://docs.openclaw.ai/tools/web │ │ │ ├─────────────────────────────────────────────────────────────────────────────────────────╯──╯
发现只能本地登录，寻找可以远程访问的方法。(后来发现官方给出ssh转发的解决方案，实践文档见：https://skywalk.blog.ZEEKLOG.net/article/details/)
开启局域网访问
如果为了安全，并不需要开启局域网访问，如果要开，用这句：
openclaw config set gateway.bind lan
OpenClaw 的默认配置中，gateway.bind 选项的值是 ‌loopback‌。
这意味着网关默认只监听本地回环地址（如 127.0.0.1 或 localhost），因此只能在本地访问控制界面。
可以使用ssh映射来解决真侦听本地的问题：https://skywalk.blog.ZEEKLOG.net/article/details/
启动服务
openclaw gateway --port 18789 --verbose
web登录127.0.0.1:18789
配对和批准
如果登录报错：pairing required ，那就需要进行配对操作。
列出配对值
openclaw devices list
批准配对
openclaw devices approve
最终web 控制面板终于可以打开了。
先进行到这里，以后再调试大模型部分。
尝试了很多免费的大模型，比如星河社区免费部署的ERNIE-4.5-21B-A3B-Paddle ，Atomgit的三款免费模型，都无法使用，主要是那些免费模型都只提供4k的token 长度，不够用。
用千帆大模型ERNIE-Lite-Pro-128K进行了测试，跑出来效果如下：
 
  
    
    
 
      
    
这次安装OpenClaw走了很多弯路，甚至一些弯路到现在都不知道为什么会出问题。总之github这块很坑。
直接安装openclaw-cn国产软件：
pnpm install -g openclaw-cn --registry=https://registry.npmmirror.com # 初始化配置（自动生成国内适配的配置文件） openclaw-cn onboard --install-daemon
然后再搭载国产收费大模型即可。
openclaw跑起来是吞金兽，用下来使用千帆最便宜的模型Ernie lite pro一次对话（比如问个天气，问下当前系统软硬件情况）大约要花费0.02元，稍微问2-3个问题就要花费0.1元左右，贵的模型价格大约5-10倍，这样就要1元左右，真要让它完成点任务，不包月是不行的。
可以试试WinClaw ,官网https://winclaw.cn/
目前每天1千万免费token额度，可以完成几个小任务。
直接安装新版本
npm install -g 
可能是github抽风的问题，npm升级到11.11.0之后，再次安装就成功了
npm i -g openclaw
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
[UNRESOLVED_ENTRY] Error: Cannot resolve entry module apps/shared/OpenClawKit/Tools/CanvasA2UI/bootstrap.js.
pnpm update
不管用。
进入openclaw目录，执行
pnpm store prune rm -rf node_modules # 重新安装依赖并构建 pnpm install
还是没有openclaw命令，build
pnpm build
重新安装？
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
不行，最后这里总算用sudo过去了....
sudo npm i -g openclaw
origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)
修改.openclaw/openclaw.json 文件
 "gateway": { "port": 18789, "mode": "local", "bind": "lan", "controlUi": { "allowedOrigins": [ "http://localhost:18789", "http://127.0.0.1:18789", "http://192.168.1.12:18789"
加入这句： "http://192.168.1.12:18789"
加入这句之后报错变成：
control ui requires device identity (use HTTPS or localhost secure context)
最后使用ssh转发到127.0.0.1的方式
这个可能是星河社区的模型未启动。
启动后，报错是：
加上--verbose
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
看详细的报错信息。
我晕，原来是空间用完了
25G 24G 0 100% /
再多分15G过来
继续安装。
再重新运行一次：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
碰到新的报错：
看看端口，有侦听啊
openclaw config get gateway.bind 🦞 OpenClaw 2026.3.2 (85377a2) — I'm basically a Swiss Army knife, but with more opinions and fewer sharp edges. loopback skywalk@ub19:~/.openclaw$ netstat -an |grep 18789 tcp 0 0 127.0.0.1:18789 0.0.0.0:* LISTEN tcp6 0 0 ::1:18789 :::* LISTEN
发现直接用127.0.0.1地址，是拒绝
skywalk@ub19:~/.openclaw$ curl 127.0.0.1:18789 curl: (7) Failed to connect to 127.0.0.1 port 18789 after 0 ms: Connection refused skywalk@ub19:~/.openclaw$ curl localhost:18789 Not Founds
最后是安装openclaw-cn软件解决的，见：https://skywalk.blog.ZEEKLOG.net/article/details/
Chat
Direct gateway chat session for quick interventions.
pairing required
                              Main Session                        |
Disconnected from gateway.
pairing required
是因为没有配对，先列出来：
openclaw devices list
批准配对
openclaw devices approve 9f52af31-fcd # 配对值
问题解决
应该是推理模型还有点问题。
最终是在1.19这台服务器，用ERNIE-Lite-Pro-128K模型跑通的。