引言
一直想在自己的设备上跑个像贾维斯那样的 AI 助手，对比了几个开源框架后，最终锁定了 OpenClaw。它支持多种大语言模型和消息平台集成，配合树莓派 4B（4GB 内存）的低功耗和 7x24 小时运行能力，是个很理想的组合。
不过，在学校网络环境下折腾这个，过程比预想的要曲折得多。从 Python 版本编译到 npm 依赖冲突，再到 DeepSeek API 的端点识别问题，每一步都踩了不少坑。下面把完整的排查和解决路径整理出来，希望能帮后来者少走弯路。
一、环境准备：ARM64 架构的特殊性
1.1 系统基础确认
我的测试环境如下：
- 硬件：树莓派 4B（ARM Cortex-A72，4 核，3.5GB 可用内存）
- 系统：Raspberry Pi OS（基于 Debian 的 ARM64 架构）
- Python：需手动升级至 3.8+
- Node.js：v22.22.0（OpenClaw 要求版本）
1.2 Python 源码编译
树莓派官方源里往往没有现成的 Python 3.8 包，直接 apt install 会报错。这时候只能从源码编译安装，注意命令之间要有换行或分号，不能连成一串。
sudo apt-get install -y build-essential tk-dev libncurses5-dev wget
wget https://www.python.org/ftp/python/3.8.0/Python-3.8.0.tgz
tar zxf Python-3.8.0.tgz
cd Python-3.8.0
./configure --enable-optimizations
make -j4
sudo make altinstall
二、网络限制：学校环境下的最大障碍
2.1 GitHub 访问问题
学校网络对 GitHub 的限制是硬伤，经常遇到 ERR_EMPTY_RESPONSE 或 SSL 握手错误。除了物理网络环境外，本地配置也能缓解不少。
使用国内镜像源
npm config set registry https://registry.npmmirror.com
优化 Git 超时设置
git config --global http.postBuffer 524288000
git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999
强制使用 HTTPS
避免 SSH 连接被干扰，全局切换为 HTTPS 协议。
git config --global url."https://github.com/".insteadOf ssh://[email protected]/
git config --global url."https://".insteadOf ssh://
2.2 npm 安装失败与依赖修复
执行 npm install 时，libsignal-node 等依赖包容易卡住，甚至提示 Package no longer supported。这时候用 cnpm 替代 npm 通常能绕过部分 CDN 问题。
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install -g openclaw@latest
如果依然报错，建议直接从 GitHub 克隆该依赖包进行链接安装：
