什么是 OpenClaw？

OpenClaw 是一个强大的 AI 助手自动化平台，它允许你通过命令行或网页界面与各种 AI 模型交互，管理会话，安装扩展和技能，以及自动化各种任务。

基础命令

状态与帮助

# 检查 OpenClaw 状态
openclaw status

# 显示帮助信息
openclaw help

# 显示版本信息
openclaw version

Gateway 管理

# 查看网关状态
openclaw gateway status

# 启动网关
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

模型管理

# 列出可用模型
openclaw models list

# 列出所有模型（包括未配置的）
openclaw models list --all

# 配置模型
openclaw configure --section model

配置管理

# 打开配置向导
openclaw configure

# 配置 Web 搜索
openclaw configure --section web

# 配置模型
openclaw configure --section model

# 配置语音
openclaw configure --section voice

会话管理

# 列出会话
openclaw sessions list

# 查看会话历史
openclaw sessions history <session-key>

模型配置详解

配置文件位置

OpenClaw 的主配置文件位于：

• Windows: C:\Users\<用户名>\.openclaw\openclaw.json
• Linux/Mac: ~/.openclaw/openclaw.json

添加新模型

在 openclaw.json 中的 models.providers 下添加新的模型配置：

{
  "models": {
    "providers": {
      "volcengine": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "your-api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "doubao-seed-2-0-code-preview-260215",
            "name": "Doubao Seed 2.0 Code Preview",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0.0001,
              "output": 0.0002
            },
            "contextWindow": 256000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

设置默认模型

在 agents.defaults.model 中设置：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine/doubao-seed-2-0-code-preview-260215",
        "fallbacks": [
          "openai/gpt-5.1-codex",
          "volcengine/ark-code-latest"
        ]
      },
      "models": {
        "volcengine/doubao-seed-2-0-code-preview-260215": {
          "alias": "seed2"
        }
      }
    }
  }
}

常用模型别名

配置好模型别名后，可以直接使用简短的别名：

# 使用别名切换模型
/model GPT           # 使用 GPT-5.1
/model seed          # 使用 Doubao Seed 1.8
/model seed2         # 使用 Doubao Seed 2.0
/model volcengine    # 使用 Volcengine ARK Code

扩展与技能

扩展管理

# 列出已安装扩展
openclaw extensions list

# 安装扩展
openclaw extensions install <extension-name>

# 卸载扩展
openclaw extensions uninstall <extension-name>

技能管理

# 列出可用技能
openclaw skills list

# 安装技能
openclaw skills install <skill-name>

实用技巧

1. 模型切换

在对话中随时切换模型：

/model volcengine/doubao-seed-2-0-code-preview-260215

2. 查看当前状态

使用 /status 命令查看当前会话状态、模型使用情况等。

3. 记忆管理

OpenClaw 会自动保存记忆到：

• 每日记录：memory/YYYY-MM-DD.md
• 长期记忆：MEMORY.md

4. 重启会话

修改配置后，刷新页面或重新开始会话即可生效。

常见问题

Q: 配置修改后不生效怎么办？
A: 刷新网页聊天页面或重新开始一个新会话。

Q: 如何查看当前使用的模型？
A: 使用 /status 命令，或直接问"你现在使用的是什么模型？"

Q: 模型列表中没有我想要的模型怎么办？
A: 手动编辑 openclaw.json 配置文件添加模型。