OpenClaw 配置教程

安装并配置 OpenClaw，连接 云策平台运行本地 AI 助手。

OpenClaw 是开源本地 AI 助手，运行在你自己的电脑上，通过聊天直接执行任务，不止对话，更能动手。适合需要本地执行能力的开发者场景。

平台优势

通过 云策接入 OpenClaw：专线高速直连、无封号风险、余额永不过期，1 RMB = 1 USD。

前置准备

1. 注册并登录云策：前往 yuncezn.com/register
2. 充值获取额度：前往 yuncezn.com/purchase
3. 获取 API Key：在控制台令牌管理中创建并复制 API Key

第一步：安装 OpenClaw

macOS (Homebrew)

brew install openclaw

Windows (winget)

winget install OpenClaw.OpenClaw

Linux / npm

npm install -g openclaw

验证安装：

openclaw --version

第二步：初始化配置

首次运行初始化命令，生成配置目录：

openclaw init

这会在 ~/.openclaw/ 下创建默认配置文件。

第三步：写入 云策配置

编辑 ~/.openclaw/config.json，将 API 端点指向 yuncezn.com：

{
  "provider": "openai-compatible",
  "api_base": "https://yuncezn.com/v1",
  "api_key": "sk-替换成你的云策密钥",
  "model": "gpt-4o-mini",
  "local_execution": true
}

模型选择

OpenClaw 支持通过 OpenAI 兼容接口调用任意模型，可在控制台可用模型列表中选择。推荐 gpt-4o-mini 用于日常任务，复杂任务可切换为 gpt-4o 或 claude-3-5-sonnet。

第四步：启动并验证

启动 OpenClaw：

openclaw start

或在项目目录中交互式启动：

cd your-project-folder
openclaw

执行只读任务验证：

请只读分析当前项目结构，列出主要目录和入口文件，不要修改任何文件。

本地执行能力

OpenClaw 的核心特性是本地执行，可以直接在你的电脑上：

• 读写文件
• 执行终端命令
• 操作浏览器
• 管理系统进程

权限管理

OpenClaw 的本地执行能力较强，建议在配置中开启权限确认：

{
  "confirm_before_execute": true,
  "allowed_paths": ["~/projects"]
}

故障排查

问题现象	解决方案
command not found: openclaw	安装路径未加入 PATH
401 unauthorized	检查 API Key 是否完整
本地命令执行失败	检查 allowed_paths 是否限制了访问路径
模型调用失败	确认 api_base 带了 /v1 后缀

更多问题请参考 常见问题。