需依次完成五步：一、确保Node.js≥v22.0.0、npm≥10.0.0、内核≥5.15；二、安装Claude Code与cc-switch并验证anthropic供应商；三、用cc-switch注入Anthropic密钥及base-url并设为默认；四、克隆OpenClaw，配置CLAUDE_CODE_PATH和DEFAULT_MODEL至.env；五、调用API验证返回model字段正确且无报错。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Linux系统上部署OpenClaw并接入Claude模型，但发现终端无响应、模型调用失败或配置后仍使用默认本地模型，则可能是由于环境依赖缺失、API密钥未正确注入或模型路由未启用。以下是解决此问题的步骤：
一、确认基础环境兼容性
OpenClaw在Linux下运行依赖特定版本的Node.js与系统组件，低版本会导致cc-switch无法加载模型供应商，或claude命令不可识别。必须确保环境满足最低要求，否则后续所有配置均无效。
1、执行 node --version 检查Node.js版本，输出必须为 v22.0.0 或更高；若低于该版本，访问 https://nodejs.org 下载LTS安装包并重装。
2、执行 npm --version 验证npm版本，输出须为 10.0.0 或更高；若缺失，需通过 curl -fsSL https://install-node.vercel.app/latest | bash 重装Node.js以同步更新npm。
3、执行 wsl --list --verbose（仅WSL用户）确认内核版本不低于5.15；若为原生Ubuntu/CentOS，请运行 uname -r 核验，低于5.15需升级系统内核。
二、安装Claude Code与cc-switch桥梁工具
Claude Code是OpenClaw调用Claude模型的运行时载体，而cc-switch负责将请求路由至Anthropic官方API或兼容接口。二者缺一不可，且必须在Linux终端中以非root用户身份安装，避免权限冲突导致模型注册失败。
1、在终端中运行 curl -fsSL https://claude.ai/install.sh | bash 安装Claude Code主程序。
2、安装完成后执行 claude --version，确认输出类似 Claude Code 2.1.29 的有效版本号。
3、执行 npm install -g cc-switch 全局安装模型切换器；若提示权限错误，改用 npm install -g cc-switch --userconfig ~/.npmrc。
4、运行 cc-switch --list-providers，检查输出中是否包含 anthropic；若无，说明安装异常，需删除 ~/.cc-switch 目录后重试。
三、配置Anthropic API密钥与模型路由
直接修改settings.json虽可生效，但易因JSON语法错误导致OpenClaw启动崩溃；推荐使用cc-switch命令行方式注入，自动校验格式并热重载配置。
1、访问 https://console.anthropic.com/settings/keys 创建新密钥，复制完整字符串（以 sk-ant-api03- 开头）。
2、在终端执行 cc-switch add anthropic --key sk-ant-api03-xxxxxxxxxx --base-url https://api.anthropic.com/v1，其中base-url不可省略或替换为其他地址。
3、执行 cc-switch set-default anthropic 将Anthropic设为默认供应商。
4、手动验证路由：运行 claude chat --model claude-3-sonnet-20240229 "Hello"，若返回正常响应而非“model not found”，说明路由已通。
四、克隆OpenClaw并绑定Claude模型
OpenClaw本身不内置模型，需通过环境变量或配置文件显式声明Claude Code路径及默认模型名。若跳过此步，OpenClaw将尝试调用不存在的本地模型而报错退出。
1、创建部署目录：mkdir -p ~/openclaw && cd ~/openclaw。
2、克隆仓库：git clone https://github.com/openclaw/openclaw.git .（注意末尾英文句点）。
3、编辑配置文件：nano .env，添加以下两行：
CLAUDE_CODE_PATH=/home/$(whoami)/.local/bin/claude
DEFAULT_MODEL=claude-3-sonnet-20240229
4、保存后执行 source .env && npm install && npm start 启动服务。
五、验证Claude模型在OpenClaw中实际可用
启动成功不代表模型已就绪，必须通过真实交互触发一次完整推理链，排除缓存、token刷新或上下文初始化失败等静默错误。
1、保持OpenClaw服务运行，另开终端窗口，执行 curl -X POST http://localhost:3000/api/chat -H "Content-Type: application/json" -d '{"message":"用中文解释什么是RAG"}'。
2、观察返回体中 "model": "claude-3-sonnet-20240229" 字段是否存在；若为 "model": "unknown"，说明.env未被读取，需检查npm start是否在openclaw根目录下执行。
3、若返回含rate_limit_exceeded，确认Anthropic控制台中该密钥所属组织未超出免费额度；若返回connection refused，检查claude进程是否仍在后台运行：ps aux | grep claude。
