# 【长文警告】手搓个人版 OpenClaw：用 Woclaw 从零搭建属于你的本地电脑智能助手
不想听啰嗦？直接去 Fork：[https://github.com/badhope/Woclaw](https://github.com/badhope/Woclaw)
## 目录
1. 为什么自己手搓 AI 助手，永远比大厂香？
2. Woclaw 是什么？能平替 OpenClaw？
3. 3 分钟一键部署（小白直接抄）
4. 模型配置：Ollama 本地 / 云端 API 双路线
5. 核心配置文件全解（权限握死在自己手里）
6. 自定义 Worker：手搓专属功能（示例代码）
7. 安全规则：防止 AI 乱删文件
8. 高频坑点 & 快速排错
9. 总结：本地 AI 时代，自己掌控才最爽
## 1. 为什么自己手搓 AI 助手，永远比大厂香？
OpenClaw 横空出世后，所有人都意识到了一件事：能直接操控电脑的 AI，才是真·效率神器。
但你去看各大厂商推出的 AI 助手，全是套路：
- 隐私裸奔：文件必须上传云端；
- 功能阉割：你只能用平台开放的有限能力；
- 收费昂贵：高级功能全是会员制；
- 断网残废：必须联网才能使用。
真正爽的，永远是这一种：本地运行、完全开源、100% 可控、想怎么改就怎么改。
这篇文章，带你用 Woclaw，手搓一个完全属于你的电脑智能体。
## 2. Woclaw 是什么？
极简理解：Woclaw 是轻量、开源、可本地部署、复刻 OpenClaw 能力的电脑控制 AI。
核心能力：
- 理解自然语言指令；
- 操作 GUI、鼠标、键盘；
- 读写文件、执行命令；
- 自动整理文档、批量处理数据；
- 支持本地 Ollama 模型，可完全离线；
- 支持无限扩展自定义功能。
一句话总结：你说一句话，它帮你操作电脑。
## 3. 3 分钟一键部署（小白直接抄）
### 环境要求
- Windows 10 / Windows 11；
- 内存 8GB 及以上；
- 必须拥有管理员权限。
### 一键安装（管理员 PowerShell）
```powershell
irm https://raw.githubusercontent.com/badhope/Woclaw/main/scripts/install.ps1 | iex
手动安装（网络不好时使用）
git clone https://github.com/badhope/Woclaw.git
cd Woclaw
pip install -e .
woclaw chat
启动方式
woclaw chat
直接说指令即可使用：
· 帮我整理下载文件夹； · 打开记事本写一段话并保存到桌面； · 查看当前 CPU、内存占用最高的进程。
- 模型配置（最关键）
Woclaw 支持本地 Ollama 和云端 API 两种模式。
本地模型（推荐：免费、隐私、完全离线）
模型推荐
· 普通笔记本：qwen3.5:7b； · 16GB 显存：deepseek-r1:14b； · 24GB+ 显存：qwen3.5:35b。
下载命令：
ollama pull qwen3.5:7b
配置文件（config.yaml）：
llm:
provider: ollama
model: qwen3.5:7b
base_url: http://localhost:11434
云端 API（豆包 / 通义千问 / Kimi）
llm:
provider: openai
model: doubao-pro-32k
api_key: sk-xxxxxxx
base_url: https://ark.cn-beijing.volces.com/api/v3
- 核心配置文件全解
配置文件路径：C:\Users\你的用户名.woclaw\config.yaml
llm:
provider: ollama
model: qwen3.5:7b
workers:
shell:
timeout: 300
gui:
backend: win32
security:
allow_dangerous: false
confirm_on_delete: true
forbidden_commands:
- format
- rm -rf /
- del /f /s /q C:\*
learning:
enabled: true
你可以完全控制：
· 使用的模型； · 各个执行器的权限； · 危险命令黑名单； · 是否开启自我学习。
- 自定义 Worker（手搓专属功能）
Worker = AI 的手脚。你可以写任何功能：自动签到、邮件处理、爬虫、自动化报表。
示例：B站签到 Worker
新建文件：bilibili_worker.py
from .base import BaseWorker
import requests
class BilibiliWorker(BaseWorker):
name = "bilibili_worker"
description = "B站签到、查询经验值"
async def run(self, params):
cookie = params.get("cookie")
headers = {"Cookie": cookie}
url = "https://api.bilibili.com/x/web-interface/nav/stat"
res = requests.get(url, headers=headers)
return "B站签到执行完成。"
注册到 init.py：
from .bilibili_worker import BilibiliWorker
WORKERS = [BilibiliWorker]
重启后直接使用：
帮我执行 B 站每日签到。
- 安全规则（必看）
security:
allow_dangerous: false
confirm_on_delete: true
log_commands: true
危险命令黑名单：
forbidden_commands:
- format
- reg add
- rm -rf
- del /f /s /q C:\*
开启后，AI 永远无法乱删你的文件。
- 高频坑点 & 快速排错
· 安装失败：必须使用管理员权限； · Ollama 拉取失败：更换国内镜像源； · GUI 操作没反应：管理员身份运行 Woclaw； · 推理速度慢：更换更小模型、插上电源、开启 GPU 加速； · 命令报错：检查安全配置是否拦截。
- 总结
OpenClaw 证明了一件事：能真正操控电脑的 AI，才是未来。
而 Woclaw 给了你：
· 完全本地运行； · 完全隐私保护； · 完全免费使用； · 完全自定义扩展。
大厂 AI 再强，都不如自己手搓的爽。
快去 Fork 吧：github.com/badhope/Woc…
