OpenClaw 安装与排错完整笔记（实战记录）

安装codex

首先需要有Homebrew和Node，自行安装

sudo npm install -g @openai/codex

codex --version

创建配置文件

在用户目录下创建 .codex 文件夹，并创建两个配置文件。

# 创建目录
mkdir -p ~/.codex

# 创建配置文件
touch ~/.codex/auth.json
touch ~/.codex/config.toml

配置 auth.json

将您的 MyDamoxing API Key 填入：

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "您的MyDamoxing Codex API密钥"
}

注意: 将 您的MyDamoxing Codex API密钥 替换为您在 MyDamoxing 获取的密钥（格式类似 sk-xxx...）

配置 config.toml

model_provider = "MyDamoxing"
model = "gpt-5.3-codex"
model_reasoning_effort = "medium"
disable_response_storage = true
personality ="pragmatic"

提供商配置
[model_providers.MyDamoxing]
name = "MyDamoxing"
base_url = "https://mydmx.huoyuanqudao.cn/v1"
wire_api = "responses"
requires_openai_auth = true

配置说明

参数	说明	可选值
model	模型名称	gpt-5.3-codex
model_reasoning_effort	思考努力程度	high, medium, low
base_url	API 端点	https://mydmx.huoyuanqudao.cn/v1
wire_api	API 协议	responses

直接使用codex安装openclaw

联网搜索下最新的onenclaw官方安装教程，然后帮我安装，中途遇到需要更换大模型ur和key的问题可以问我，确保最终我能够正常使用openclanw

![[Pasted image 20260306134734.png]]

codex的安装过程，自己可以排查错误进行纠正

1. 目标与官方来源

本次按官方入口安装并验证：

• 安装页：https://docs.openclaw.ai/install
• 安装脚本入口：https://openclaw.ai/install
• 官方仓库：https://github.com/openclawdev/openclaw

官方安装命令：

curl -fsSL https://openclaw.ai/install.sh | bash

---

2. 环境现状检查

先检查系统、Node、npm、openclaw：

uname -a
node -v
npm -v
command -v openclaw
openclaw --version

检查结果（关键点）：

• Node: v25.8.0
• npm: 11.11.0
• openclaw 已存在：2026.3.2

结论：机器上已有 OpenClaw，但仍需要按官方流程校验并补齐配置。

---

3. 安装执行与结果

执行官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

报错 1：Could not resolve host: openclaw.ai

现象：

curl: (6) Could not resolve host: openclaw.ai

处理：

• 以可联网权限重试安装脚本。
• 重试后安装成功，版本仍为 v2026.3.2（已是当前安装脚本目标版本）。

---

4. 网关配置问题与修复

安装后 doctor/status 显示网关阻塞：

报错 2：Gateway start blocked: set gateway.mode=local (current: unset)

原因：gateway.mode 未设置。

处理：

openclaw config set gateway.mode local

报错 3：launchctl bootstrap failed: Bootstrap failed: 5: Input/output error

出现场景：

• openclaw gateway restart
• openclaw gateway install
• openclaw gateway start

原因：当前执行环境下，LaunchAgent 无法稳定注入到 GUI 会话。

处理策略：

1. 服务安装命令在无沙箱限制下执行一次：

openclaw gateway install

2. 常驻服务仍不稳定时，采用前台/手动运行网关（官方支持）：

openclaw gateway run

3. 背景运行验证时使用：

nohup openclaw gateway run > /tmp/openclaw-gateway-manual.log 2>&1 &

4. 健康检查：

openclaw gateway health
openclaw gateway probe

---

5. 模型配置与可用性检查

读取配置后确认已有自定义 provider（此处不记录明文密钥）。

关键检查命令：

openclaw models status --probe

结论：模型探测通过（ok）。

12. 常用维护命令（后续可直接用）

启动网关：

openclaw gateway run

检查健康：

openclaw gateway health
openclaw channels status --probe --timeout 20000

查看日志：

tail -f /tmp/openclaw-gateway-manual.log

检查端口占用：

lsof -nP -iTCP:18789 -sTCP:LISTEN