OpenClaw 新手入门:第一次应该怎么配置

上一篇我们聊了 OpenClaw 是什么。如果你已经心动了，这篇教你把它跑起来。

别怕，不需要你懂编程。跟着做就行，30 分钟内就能让你的 AI 助手上线。

第 1 步：安装 OpenClaw

OpenClaw 运行在服务器上（Linux 或 macOS）。首先确保你有 Node.js 18+ 环境。

安装命令：

# 安装 OpenClaw
包管理器安装 openclaw

# 验证安装
openclaw --version

安装完成后，OpenClaw 会自动创建配置目录 ~/.openclaw/。

💡 提示：推荐使用 Ubuntu 22.04 或 Debian 12 系统。如果你用的是其他系统，安装步骤可能略有不同。

第 2 步：配置 AI 模型

你需要一个 AI 模型的 接口密钥。推荐新手用 轻量级 AI 模型，便宜够用。

获取 密钥：

2. 访问 官方平台
4. 注册账号并充值（最低 $5）
6. 在 密钥 页面创建一个新的 Key
8. 复制保存好，只显示一次

配置到 OpenClaw：

编辑配置文件 ~/.openclaw/openclaw.json，找到模型配置部分：

{
  "gateway": {
    "model": {
      "primary": "轻量模型"
    }
  }
}

然后添加 密钥：

# 添加 AI 模型认证
openclaw models auth add 模型 --"你的密钥"

💡 省钱建议：日常用 轻量模型（便宜），复杂任务再切 高级模型（更强）。OpenClaw 支持随时切换。

第 3 步：接通通讯通道

OpenClaw 支持多种通讯方式，推荐新手先用 通讯工具，配置最简单。

创建 通讯机器人：

2. 打开 通讯工具，搜索 @Bot管理工具
4. 发送 /newbot
6. 按提示输入 Bot 名称和用户名
8. Bot管理工具 会给你一个 密钥（类似 123456:ABC-DEF...）

配置到 OpenClaw：

{
  "channels": {
    "通讯工具": {
      "enabled": true,
      "密钥": "你的通讯工具-Bot-密钥"
    }
  }
}

测试：

# 启动 OpenClaw
openclaw start

# 给你的 Bot 发消息，能回复就成功了！

💡 微信通道：需要公众号或企业微信权限，配置稍复杂。建议先用 通讯工具 练手，跑通了再加微信。

第 4 步：理解工作区

OpenClaw 的工作区（workspace）就是它的”家”，所有记忆和资料都存在这里：

~/.openclaw/workspace/
├── AGENTS.md      # 助手行为规范（告诉它怎么做事）
├── SOUL.md        # 助手性格设定（定义它的性格）
├── MEMORY.md      # 长期记忆（重要的事情记这里）
├── TOOLS.md       # 工具笔记（记录你的特殊配置）
├── docs/          # 你的资料库（服务器、域名等）
└── memory/        # 每日记忆（每天做了什么）

新手先别改太多，默认配置就能用。等你熟悉了，再慢慢定制 AGENTS.md 和 SOUL.md 来定义 AI 的行为和性格。

这些文件的作用：

• AGENTS.md：告诉 AI 怎么做事，比如”先备份再修改”、”危险操作要确认”
• SOUL.md：定义 AI 的性格，比如”直接、实用、少废话”
• MEMORY.md：存储长期记忆，比如你的服务器列表、项目状态
• docs/：存放结构化资料，比如服务器信息、域名列表

第 5 步：试几个命令

配置完成，现在来测试一下。试试这些对话：

基础测试：

• “帮我查一下服务器内存使用” → AI 会执行 free -h 并告诉你结果
• “现在几点了” → AI 会告诉你当前时间
• “帮我搜一下 OpenClaw 的最新版本” → AI 会联网搜索

进阶测试：

• “提醒我明天下午 3 点开会” → AI 会设置定时提醒
• “帮我查一下 nginx 的状态” → AI 会检查服务状态
• “切换到 某 AI 模型 模型” → AI 会切换底层模型

如果 AI 能正常回复并执行命令，恭喜你，配置成功了！

⚠️ 新手避坑清单

配置过程中容易踩的坑，提前帮你避开：

坑 1：密钥 泄露

❌ 不要把 密钥 写在公开文件里或发到群里

✅ 用环境变量或私有目录存储，权限设为 600

坑 2：模型选太贵

❌ 一开始就用 高级模型，接口 费用飞涨

✅ 日常用 mini 版，复杂任务再升级

坑 3：通道配错了

❌ 同时配了 通讯工具 和微信，结果都不通

✅ 先用 通讯工具 测试，通了再加微信

坑 4：权限太大

❌ 让 AI 随便执行任何命令

✅ OpenClaw 有安全规则，危险命令会提醒你确认

坑 5：不看日志

❌ 出了问题不知道哪里错了

✅ 用 openclaw status 查看运行状态，用 openclaw logs 查看日志

🎯 配置完成检查清单

跑完上面 5 步，确认以下几点：

• ✅ openclaw --version 能显示版本号
• ✅ openclaw status 显示正常运行
• ✅ 给 通讯机器人 发消息能收到回复
• ✅ AI 能执行简单命令（如查时间、查内存）

全部打勾？你的 AI 助手已经上线了！