OpenClaw 配置完整指南：从安装到首次运行详细步骤

摘要：完整的 OpenClaw 配置指南，从基础配置到进阶设置，包含详细步骤和截图说明。

开篇：配置其实很简单

安装好 OpenClaw 后，很多人卡在配置这一步。

配置文件里一堆参数，不知道哪些要改，哪些不用管。

我第一次配置时也是这样。

但后来我发现，其实只需要改几个关键参数，其他都可以用默认值。

今天这篇文章，我会带你：

1. 理解每个配置项的作用
2. 完成最小可用配置
3. 根据你的需求做进阶配置

看完就能上手，不需要任何基础。

---

OpenClaw 配置文件在哪？

找到配置文件

OpenClaw 的配置文件通常在：

Windows: C:\Users\你的用户名\AppData\Roaming\openclaw\config.json
macOS: /Users/你的用户名/.openclaw/config.json
Linux: /home/你的用户名/.openclaw/config.json

配置文件结构

打开 config.json，你会看到类似这样的内容：

{
  "apiKey": "",
  "model": "",
  "workspace": "",
  "server": {
    "port": 18800,
    "host": "127.0.0.1"
  },
  "logging": {
    "level": "info",
    "file": "logs/openclaw.log"
  }
}

别慌，我们一个一个来配置。

---

OpenClaw 基础配置（必须改的）

1. API 密钥

这是最重要的配置，没有密钥 OpenClaw 无法工作。

{
  "apiKey": "sk-xxxxxxxxxxxxxxxx"
}

如何获取：

1. 访问模型提供商官网
2. 注册/登录账号
3. 找到 API 管理页面
4. 创建新的 API Key
5. 复制密钥到配置文件

推荐模型（国内用户）：

• 通义千问：qwen-plus
• 文心一言：ernie-bot-4
• Kimi：kimi-chat

推荐模型（能翻墙的用户）：

• GPT-4：gpt-4-turbo
• Claude：claude-3-opus

2. 模型选择

{
  "model": "qwen-portal/qwen3.5-plus"
}

模型选择建议：

使用场景	推荐模型	理由
日常写作	qwen-plus	中文好，速度快
深度分析	qwen3.5-plus	理解能力强
代码生成	gpt-4-turbo	代码能力强
长文档	claude-3-opus	上下文窗口大

3. 工作目录

{
  "workspace": "C:/Users/Administrator/OpenClaw/workspace"
}

工作目录用来存放：

• 生成的文章
• 配置文件
• 日志文件
• 缓存数据

选择原则：

• ✅ 空间充足（至少 10GB）
• ✅ 权限正常（能读写）
• ✅ 不会被云盘同步
• ✅ 方便访问

推荐位置：

Windows: C:/Users/你的用户名/OpenClaw/workspace
macOS: /Users/你的用户名/OpenClaw/workspace

---

OpenClaw 进阶配置（根据需要改）

4. 服务器设置

{
  "server": {
    "port": 18800,
    "host": "127.0.0.1"
  }
}

什么时候需要改：

• 端口冲突：如果 18800 被占用，改成 18801、18802 等
• 远程访问：如果需要从其他设备访问，把 host 改成 0.0.0.0

一般用户不用改。

5. 日志设置

{
  "logging": {
    "level": "info",
    "file": "logs/openclaw.log"
  }
}

日志级别说明：

级别	说明	适用场景
debug	最详细，包含所有调试信息	排查问题时临时使用
info	常规信息	日常使用（推荐）
warn	只记录警告和错误	生产环境
error	只记录错误	生产环境

建议： 日常用 info，出问题时临时改成 debug。

6. 超时设置

{
  "timeout": {
    "request": 30000,
    "task": 300000
  }
}

说明：

• request: 单次请求超时（毫秒）
• task: 任务总超时（毫秒）

什么时候需要改：

• 经常处理长文本 → 增加 request 超时
• 经常运行长时间任务 → 增加 task 超时

建议： 先用默认值，遇到超时错误再调整。

7. 代理设置（需要翻墙时）

{
  "proxy": {
    "enabled": true,
    "http": "http://127.0.0.1:7890",
    "https": "http://127.0.0.1:7890"
  }
}

说明：

• 如果用 GPT-4、Claude 等需要翻墙的模型，需要配置代理
• 代理地址根据你自己的代理软件设置

国内模型用户不用配置这项。

---

OpenClaw 完整配置示例

最小可用配置

{
  "apiKey": "sk-xxxxxxxxxxxxxxxx",
  "model": "qwen-portal/qwen3.5-plus",
  "workspace": "C:/Users/Administrator/OpenClaw/workspace"
}

只有这 3 项是必须的，其他都可以用默认值。

推荐配置（大多数用户）

{
  "apiKey": "sk-xxxxxxxxxxxxxxxx",
  "model": "qwen-portal/qwen3.5-plus",
  "workspace": "C:/Users/Administrator/OpenClaw/workspace",
  "server": {
    "port": 18800,
    "host": "127.0.0.1"
  },
  "logging": {
    "level": "info",
    "file": "logs/openclaw.log"
  },
  "timeout": {
    "request": 30000,
    "task": 300000
  }
}

高级用户配置

{
  "apiKey": "sk-xxxxxxxxxxxxxxxx",
  "model": "qwen-portal/qwen3.5-plus",
  "workspace": "C:/Users/Administrator/OpenClaw/workspace",
  "server": {
    "port": 18800,
    "host": "0.0.0.0"
  },
  "logging": {
    "level": "debug",
    "file": "logs/openclaw.log",
    "maxSize": "10MB",
    "maxFiles": 5
  },
  "timeout": {
    "request": 60000,
    "task": 600000
  },
  "proxy": {
    "enabled": true,
    "http": "http://127.0.0.1:7890",
    "https": "http://127.0.0.1:7890"
  },
  "features": {
    "autoSave": true,
    "cacheEnabled": true,
    "webSearchEnabled": true
  }
}

---

OpenClaw 配置完成后要做什么？

1. 验证配置

# 检查配置是否正确
openclaw config-check

# 测试 API 连接
openclaw test-connection

# 查看当前配置
openclaw config-show

预期输出：

✓ 配置文件语法正确
✓ API 连接成功
✓ 工作目录可写

2. 运行测试任务

# 运行一个简单的测试任务
echo "你好，请介绍一下自己" | openclaw run

预期输出：

[INFO] 任务开始执行
[INFO] 调用模型：qwen-portal/qwen3.5-plus
[INFO] 任务完成，耗时 2.3 秒

3. 查看日志

# 查看最新日志
tail -f logs/openclaw.log

检查有没有 ERROR 级别的错误。

---

OpenClaw 常见配置问题

问题 1：配置后启动失败

可能原因：

• JSON 语法错误（少了逗号、引号等）
• 路径不存在
• 端口被占用

解决方案：

# 验证 JSON 语法
# 可以用在线工具：https://jsonlint.com/

# 检查工作目录是否存在
# Windows: dir C:\path\to\workspace
# macOS/Linux: ls /path/to/workspace

# 检查端口是否被占用
# Windows: netstat -ano | findstr 18800
# macOS/Linux: lsof -i :18800

问题 2：API 连接失败

可能原因：

• 密钥错误
• 密钥未激活
• 账户余额不足
• 网络问题

解决方案：

1. 检查密钥是否正确（有没有多余空格）
2. 登录模型提供商官网，确认密钥状态
3. 检查账户余额
4. 检查网络连接

问题 3：任务执行超时

可能原因：

• 任务太复杂
• 网络太慢
• 模型响应慢

解决方案：

{
  "timeout": {
    "request": 60000,
    "task": 600000
  }
}

增加超时时间。

问题 4：工作目录无法写入

可能原因：

• 权限不足
• 目录不存在
• 磁盘空间不足

解决方案：

# Windows：右键文件夹 → 属性 → 安全 → 编辑
# macOS/Linux：
chmod 755 /path/to/workspace

---

OpenClaw 配置管理技巧

1. 多环境配置

如果你有多个使用场景，可以创建多份配置文件：

config.dev.json    # 开发环境（用便宜模型）
config.prod.json   # 生产环境（用好模型）
config.test.json   # 测试环境

切换配置：

openclaw config-use config.prod.json

2. 配置备份

定期备份配置文件：

cp config.json config.json.bak.$(date +%Y%m%d)

3. 配置版本控制

用 Git 管理配置（但要注意不要提交密钥）：

# .gitignore 内容
config.json
.env
*.key
*.secret

---

OpenClaw 配置检查清单

配置完成后，逐项检查：

• API 密钥已填写且有效
• 模型已选择
• 工作目录已设置且存在
• 配置文件语法正确
• 配置验证通过
• 测试任务执行成功
• 日志没有 ERROR

全部打勾，配置完成！

---

下一步：开始使用

配置完成后，你可以：

1. 写第一篇文章

   echo "写一篇关于 AI 的文章" | openclaw run

2. 创建第一个自动化任务

   • 参考文档中的任务模板
   • 根据自己的需求修改

3. 探索更多功能

   • 查看官方文档
   • 加入社区交流
   • 学习高级技巧

---

写在最后

配置 OpenClaw 就像配置一个新手机。

刚开始觉得复杂，但配置好后就一劳永逸。

我写这篇文章的目的，是让你知道：

配置不需要很复杂，改好几个关键参数就能用。

其他高级功能，可以等用熟了再慢慢探索。

现在，打开你的配置文件，开始配置吧。

如果遇到问题，欢迎在评论区留言。

---

💬 互动话题：你配置 OpenClaw 时遇到了什么问题？最后怎么解决的？

👍 如果这篇文章帮你节省了时间，欢迎点赞、收藏、转发。