OpenClaw 使用教程：模型配置、上下文管理与基础命令
OpenClaw 是一个自托管的个人 AI 助手框架。本文将详细介绍如何添加模型、配置上下文大小、以及常用命令的使用方法。
目录
一、基础命令
1.1 查看版本和状态
openclaw --version # 查看当前版本
openclaw status # 查看完整状态（模型、会话、用量）
openclaw health # 健康检查，确认 Gateway 运行正常
1.2 查看帮助
openclaw help # 显示所有可用命令
openclaw <command> --help # 查看具体命令的帮助信息
1.3 诊断问题
openclaw doctor # 健康检查 + 自动修复建议
openclaw doctor --yes # 自动应用修复
openclaw logs # 查看 Gateway 日志
二、添加模型
OpenClaw 支持通过配置文件添加任意模型，包括 OpenAI、Anthropic、Google、以及通过 OpenRouter 等聚合平台的模型。
2.1 交互式配置
openclaw configure # 交互式配置向导
2.2 直接编辑配置文件
配置文件位于 ~/.openclaw/openclaw.json（支持 JSON5，可写注释）：
{
agents: {
defaults: {
// 主模型（首选）
model: {
primary: "anthropic/claude-sonnet-4-6",
fallbacks: ["openrouter-ai/qwen/qwen3.6-plus:free"],
},
// 模型目录（/model 命令可选列表）
models: {
"anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
"openai/gpt-5.2": { alias: "GPT" },
"openrouter-ai/qwen/qwen3.6-plus:free": { alias: "Qwen" },
},
},
},
}
说明：
- 模型引用格式为
provider/model-name alias：聊天中可用/model命令快捷切换的别名primary：默认使用的模型fallbacks：主模型不可用或额度耗尽时自动切换的备用模型
2.3 配置自定义 Provider（自建模型）
如果你使用自建的 OpenAI 兼容 API（如 Ollama、vLLM）：
{
agents: {
defaults: {
models: {
"my-llm/local-model": {
alias: "Local",
provider: {
baseUrl: "http://localhost:11434/v1",
apiKey: "ollama",
},
},
},
},
},
}
三、配置模型参数（上下文、温度等）
在模型配置中可以调整多种推理参数：
3.1 上下文窗口大小
{
agents: {
defaults: {
models: {
"anthropic/claude-sonnet-4-6": {
alias: "Sonnet",
params: {
maxTokens: 8192, // 单次回复的最大 token 数
temperature: 0.7, // 创造性（0-1，越高越随机）
},
},
},
// 全局上下文 token 限制
contextTokens: 200000, // 最大上下文窗口
},
},
}
参数说明：
| 参数 | 说明 | 默认值 |
|---|---|---|
maxTokens |
模型单次回复生成的最大 token 数 | 取决于模型 |
temperature |
回复的创造性程度（0=确定，1=随机） | 取决于模型 |
contextTokens |
最大上下文窗口大小（影响可记住的历史消息长度） | 200000 |
3.2 上下文窗口设置技巧
- 增大
contextTokens：让 AI 记住更长的对话历史，适合长会话场景 - 增大
maxTokens：让 AI 能生成更长的回复，适合生成代码、长文章 - 注意：上下文越大，token 消耗越高，响应速度越慢
3.3 全局默认参数
{
agents: {
defaults: {
// 应用于所有模型的全局参数
params: {
cacheRetention: "long", // 启用提示缓存，降低费用
},
},
},
}
参数合并优先级：全局参数 < 模型参数 < Agent 参数
四、切换模型
在聊天中直接使用 /model 命令切换：
/model # 查看可用模型列表
/model Sonnet # 切换到 claude-sonnet（通过别名）
/model anthropic/claude-opus-4-6 # 切换到完整模型名
/model default # 恢复到配置中的主模型
临时覆盖（单次对话）
在某些界面上，可以在发送消息时指定不同模型，仅当前对话生效，不影响其他会话。
五、会话管理
5.1 基本操作
/new # 开始新会话（清空上下文）
/reset # 重置当前会话
/status # 查看当前会话状态（用量、模型、耗时）
5.2 后台任务
/reply_to <id> # 引用特定消息回复
5.3 会话状态
运行 /status 或 session_status 可以查看：
- 当前使用的模型
- Token 用量
- 会话运行时间
- 是否有后台任务在进行
六、常用运维命令
6.1 Gateway 服务管理
openclaw gateway status # 查看 Gateway 状态
openclaw gateway start # 启动 Gateway
openclaw gateway stop # 停止 Gateway
openclaw gateway restart # 重启 Gateway
6.2 连接消息渠道
openclaw channels login # 连接新的消息平台（WhatsApp / Telegram 等）
6.3 配置管理
openclaw config get agents.defaults.model # 查看当前模型配置
openclaw config set agents.defaults.contextTokens 400000 # 修改上下文窗口
openclaw config validate # 验证配置文件是否合法
6.4 Cron 定时任务
# OpenClaw 内置了 cron 调度器，可以设置定时任务
# 例如：每天早上 9 点播报天气
# 例如：每小时检查一次邮件
6.5 备份与恢复
openclaw backup create # 创建状态备份
七、配置文件热重载
OpenClaw 的 Gateway 会监听 ~/.openclaw/openclaw.json 的变化，修改配置后自动生效，无需重启。
但以下情况需要重启 Gateway：
- 更换了 API Key
- 添加了新的消息渠道
openclaw gateway restart # 重启使配置生效
八、常见问题
Q1: 配置后 Gateway 无法启动
openclaw doctor # 查看具体错误
openclaw doctor --yes # 自动修复
常见原因：JSON 语法错误、未知的配置键、模型提供商未配置 API Key。
Q2: 消息回复很慢
- 检查模型是否有 rate limit
- 适当减小
contextTokens降低 token 用量 - 使用
fallbacks添加备用模型
Q3: 如何查看当前用了多少 token？
/status # 聊天中查看
openclaw status # 命令行查看
结语
OpenClaw 的配置灵活且强大，通过合理的模型选择和上下文管理，你可以在性能、质量和费用之间找到最佳平衡。
- 官方文档： https://docs.openclaw.ai
- GitHub 仓库： https://github.com/openclaw/openclaw
- 社区 Discord： https://discord.com/invite/clawd
