安装 OpenClaw 只是起点。
就像买了一台顶级相机却不调参数,真正让 OpenClaw 发挥威力的,是换模型、装 Skills、配工作流这三件事。
本文面向已安装 OpenClaw 的开发者,深入讲解进阶操作。没有废话,全是干货。
一、更换模型:20+ 种 Provider 随意切换
1.1 模型选择逻辑
OpenClaw 支持 provider/model 格式引用任何已配置模型,例如:
anthropic/claude-opus-4-6
openai/gpt-5.4
ollama/llama3.3
google/gemini-3-flash-preview选择优先级:Primary 模型 → Fallback 列表 → Provider 认证切换。
1.2 内置 Provider 一览
无需额外配置,只需提供 API Key 即可:
| 提供商 | Provider 名 | 示例模型 | 认证方式 |
|---|---|---|---|
| OpenAI | openai | gpt-5.4, gpt-5.4-pro | API Key |
| Anthropic | anthropic | claude-opus-4-6, claude-sonnet-4-5 | API Key / Claude Code Token |
| Google Gemini | google | gemini-3-flash-preview | API Key |
| OpenRouter | openrouter | openrouter/anthropic/claude-sonnet-4-5 | API Key |
| Kilo Gateway | kilocode | claude-opus-4.6, GPT-5.2 | API Key |
| Moonshot (Kimi) | moonshot | kimi-k2.5 | API Key |
| Z.AI (GLM) | zai | glm-5 | API Key |
| xAI Grok | xai | grok-2 | API Key |
| Mistral | mistral | mistral-large | API Key |
| Hugging Face | huggingface | deepseek-ai/DeepSeek-R1 | API Key |
国内开发者重点关注:MiniMax(
minimax)、GLM(zai)、Moonshot/Kimi(moonshot)、火山引擎豆包(volcengine)均已原生支持,配好 Key 即可使用。
1.3 配置方法
方式一:引导配置(推荐新手)
openclaw onboard向导会依次引导你选择 Provider、输入 API Key、设置默认模型。
方式二:直接修改配置文件
打开 ~/.openclaw/openclaw.json,添加或修改:
{
agents: {
defaults: {
model: {
primary: "anthropic/claude-opus-4-6",
fallbacks: [
"google/gemini-3-flash-preview",
"openai/gpt-5.4"
]
}
}
}
}设置 API Key:
# 通过 onboard 向导设置
openclaw onboard --auth-choice anthropic
# 或直接设置环境变量
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="..."设置默认模型(CLI 快捷方式):
openclaw models set openai/gpt-5.4
openclaw models status1.4 模型别名与白名单
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": { alias: "Opus" },
"anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
"openai/gpt-5.4": { alias: "GPT" }
}
}
}
}设置白名单后,用户只能使用列表中的模型:
{
agents: {
defaults: {
models: {
// 白名单之外的模型无法使用
}
}
}
}1.5 对话中即时切换模型
无需重启,直接在聊天窗口输入:
/model
/model list # 查看所有可用模型
/model 3 # 选择第3个
/model openai/gpt-5.4
/model status # 查看当前模型详情二、接入本地模型:Ollama 完全指南
不想花钱?本地跑模型是零成本方案。
2.1 安装 Ollama
# macOS / Linux
curl -fsSL https://ollama.ai/install.sh | bash
# macOS 也可以用 Homebrew
brew install ollama/tap/ollama2.2 拉取推荐模型
# 通义代码(coder 推荐)
ollama pull qwen2.5-coder:32b
# DeepSeek 推理(支持思维链)
ollama pull deepseek-r1:32b
# Llama 3.3(通用能力强)
ollama pull llama3.3
# Mistral(轻量高效)
ollama pull mistral2.3 接入 OpenClaw
第一步:启动 Ollama
ollama serve第二步:设置环境变量(任意值,Ollama 不强制校验):
export OLLAMA_API_KEY="ollama-local"第三步:配置 OpenClaw
如果 Ollama 在本机运行,OpenClaw 会自动发现所有带工具调用能力的模型,无需手动配置。
直接使用:
{
agents: {
defaults: {
model: { primary: "ollama/qwen2.5-coder:32b" }
}
}
}2.4 远程 Ollama
Ollama 跑在其他机器上?手动指定地址:
{
models: {
providers: {
ollama: {
baseUrl: "http://192.168.1.100:11434",
apiKey: "ollama-local",
api: "ollama"
}
}
},
agents: {
defaults: {
model: { primary: "ollama/qwen2.5-coder:32b" }
}
}
}⚠️ 重要:不要在 URL 后加
/v1,OpenClaw Ollama 集成使用原生 API(/api/chat),加/v1会导致工具调用失败。
三、Skills 系统:让 AI 能力无限扩展
3.1 什么是 Skills?
Skills 是 OpenClaw 的能力扩展包。每个 Skill 是一个文件夹,内含 SKILL.md 说明文档,定义 AI 如何调用某个工具或 API。
Skills 分三类:
| 类型 | 位置 | 说明 |
|---|---|---|
| 捆绑 Skills | OpenClaw 安装目录 | 内置功能,不可修改 |
| 托管 Skills | ~/.openclaw/skills | 所有 Agent 共享 |
| 工作区 Skills | <workspace>/skills | 单个 Agent 私有,优先级最高 |
3.2 ClawHub:Skills 的应用市场
安装 CLI:
npm i -g clawhub常用命令:
# 搜索 Skills
clawhub search "weather"
clawhub search "web scraping"
# 安装 Skills(安装到当前目录 ./skills)
clawhub install weather
clawhub install <skill-slug>
# 更新所有已安装的 Skills
clawhub update --all
# 备份/同步本地 Skills 到 ClawHub
clawhub sync --all
# 发布自己的 Skills
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0安装到指定位置:
clawhub install weather --workdir /root/.openclawOpenClaw 会自动从 <workspace>/skills 加载,新 Session 生效。
3.3 从零创建一个 Skill
目录结构:
skills/my-calculator/
├── SKILL.md
└── README.mdSKILL.md 示例:
---
name: my-calculator
description: Perform mathematical calculations with high precision
---
# Calculator Skill
Use this skill when the user asks you to calculate something.
## Available Operations
- Addition, subtraction, multiplication, division
- Power, square root, logarithm
- Trigonometric functions (sin, cos, tan)
## Usage
Always use the `exec` tool to run calculations via `bc` or `python3`:
Addition:
\`\`\`bash
echo "scale=10; $a + $b" | bc -l
\`\`\`
Square root:
\`\`\`bash
echo "sqrt($n)" | bc -l
\`\`\`3.4 Skill 高级配置
在 ~/.openclaw/openclaw.json 中精细控制:
{
skills: {
entries: {
"weather": { enabled: true },
"summarize": { enabled: true },
"some-skill": {
enabled: true,
apiKey: { source: "env", provider: "default", id: "API_KEY" },
env: {
API_KEY: "sk-..."
},
config: {
endpoint: "https://api.example.com"
}
}
},
load: {
watch: true, // 监听文件变化,实时生效
watchDebounceMs: 250
}
}
}技能过滤(gating): 可以设置技能只在特定条件下加载:
---
name: mac-only-tool
metadata:
{
"openclaw":
{
"requires": { "os": ["darwin"], "bins": ["some-binary"] },
},
}
---3.5 热门推荐 Skills
| Skill | 功能 | 来源 |
|---|---|---|
| Weather | 天气预报 | ClawHub |
| Browser | 网页浏览、截图 | OpenClaw 内置 |
| Summarize | 长文摘要 | ClawHub |
| PDF 解析 | OpenClaw 内置 | |
| TTS | 文字转语音 | OpenClaw 内置 |
| Firecrawl | 网页抓取 | OpenClaw 内置 |
浏览更多:https://clawhub.ai
四、个性化配置:打造专属 AI 助手
4.1 修改 System Prompt
OpenClaw 的灵魂由两个文件定义:
- •
SOUL.md— 定义 AI 的人格、语气、价值观 - •
AGENTS.md— 定义工作流程、工具使用规范
修改它们,AI 的行为就会改变:
# SOUL.md 示例
## Core Truths
**有自己的观点。** 可以不同意,可以偏好,可以觉得某些事有趣或无聊。
**先行动,再提问。** 遇到问题先尝试解决,实在卡住再问。
**私人信息保密。** 用户的东西就是私人的,不对外分享。4.2 多 Agent 配置
一台机器服务多个用户或团队:
{
agents: {
list: [
{
id: "dev-team",
name: "开发团队助手",
model: { primary: "anthropic/claude-opus-4-6" },
workspace: "/home/team/agent",
skills: { allow: ["coding", "git"] }
},
{
id: "general",
name: "通用助手",
model: { primary: "openai/gpt-5.4" },
workspace: "/home/public/agent"
}
]
}
}4.3 沙箱安全隔离
当处理不可信输入时,开启沙箱:
{
agents: {
defaults: {
sandbox: {
mode: "non-main",
scope: "agent",
workspaceAccess: "ro",
docker: {
image: "openclaw-sandbox:bookworm-slim",
memory: "1g",
network: "none",
capDrop: ["ALL"]
}
}
}
}
}这意味着即使用户输入恶意指令,也无法突破容器边界。
五、日常运维:让 Gateway 持续稳定
5.1 常用 CLI 命令
# Gateway 管理
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status
# 模型管理
openclaw models list
openclaw models status
openclaw models set <provider/model>
# 插件管理
openclaw plugins list
openclaw plugins enable <plugin>
openclaw plugins disable <plugin>
# 查看日志
openclaw logs --tail 100
openclaw logs --level error5.2 配置热重载
修改 openclaw.json 后无需重启:
openclaw gateway reload5.3 资源监控
openclaw status返回当前运行的 Agent 数量、内存占用、活跃会话数。
结语
OpenClaw 的乐趣,不在于装完即用,而在于持续调优的过程。
换更好的模型、装更合适的 Skills、定义更准确的人格——每一步都能感受到 AI 助手变得越来越懂你、越来越强。
唯一限制它的,是你愿意投入多少时间去配置。
现在,去试试换一个大模型,或者安装一个你需要的 Skill 吧。
相关资源:
- • 📖 官方文档:https://docs.openclaw.ai
- • 🛒 Skills 市场:https://clawhub.ai
- • 💬 Discord 社区:https://discord.gg/clawd
- • 🐙 GitHub:https://github.com/openclaw/openclaw
「工具本身没有极限,配置它的人才有。」
夜雨聆风