苹果MAC电脑系统里面使用OrbStack的容器宿主机搭建原生版小龙虾OpenClaw纯技术教程(同样适用于站长云服务ECS直接搭建)
2026/03/12 19:57:46
[md]**鑻规灉MAC鐢佃剳绯荤粺閲岄潰浣跨敤OrbStack鐨勫鍣ㄥ涓绘満鎼缓鍘熺敓鐗堝皬榫欒櫨OpenClaw绾妧鏈暀绋(鍚屾牱閫傜敤浜庣珯闀夸簯鏈嶅姟ECS鐩存帴鎼缓)銆愬厛鏉ヤ釜绾妧鏈墜鐮佸瓧鐨勬暀绋嬶紝鍚庨潰鏈夊洖澶嶇殑璇濊ˉ鍏呭浘鏂囷紝骞剁洿鎺ユ斁鍑篧indows 11鐪熷疄鐢佃剳绯荤粺鐜瀹夎灏忛緳铏炬暀绋嬨€**
涓嶇敤鐪嬪埌鏄疢AC閲岄潰鎿嶄綔锛屽疄闄呬笂鏄疢AC閲岄潰瑁呬簡涓狣ebian Linux!!!
#### 绗竴姝ワ細鍚姩骞惰繘鍏ュぇ榫欒櫨鐨勪笓灞炴矙鐩 (TARDIS)
**涓嶇敤鍘荤偣OrbStack 鐨 Debian GUI 鐣岄潰涓婄殑鎾斁閿紝鎴戜滑鐩存帴鐢ㄥ伐绋嬪笀鐨勬柟寮忋€ 鎵撳紑浣 Mac 鍒氭墠娓呯悊骞插噣鐨勭粓绔紙Terminal锛夛紝鐩存帴杈撳叆涓嬮潰杩欒鍛戒护骞跺洖杞︼細**(涓嶆槸MAC鐨刣ocker鐜璺冲埌涓嬩竴姝)
```
orb -m debian
```
*(杩欒鍛戒护鐨勬剰鎬濇槸锛氫娇鐢 orb CLI锛岀洿鎺ュ敜閱掑苟杩涘叆鍚嶅瓧鍙 `debian` 鐨勬満鍣ㄣ€)*
**鍥炶溅鍚庯紝浣犵殑鍛戒护琛屾彁绀虹搴旇浼氱灛闂翠粠 Mac 鐨 **`dz-x@dz-xdeMacBook-Pro` 鍙樻垚绫讳技 `dz-x@debian`锛岃繖鎰忓懗鐫€浣犲凡缁**鎴愬姛绌胯秺**鍒颁簡 Linux 瀹瑰櫒鐨勫唴閮紒
#### 绗簩姝ワ細缁 Debian 閾鸿鈥滃湴鍩衡€濓紙鏇存柊绯荤粺涓庡畨瑁呭繀澶囧伐鍏凤級
**杩涘叆 Debian 鍐呴儴鍚庯紝杩欎釜绯荤粺杩樻槸涓€滄瘺鍧埧鈥濓紝鎴戜滑闇€瑕佹洿鏂扮郴缁熸簮骞跺畨瑁呮瀯寤 OpenClaw 鎵€闇€鐨勫簳灞備緷璧栵紙Git 鐢ㄤ簬鎷変唬鐮侊紝build-essential 鐢ㄤ簬缂栬瘧 C++ 搴曞眰妯″潡锛夈€**
**鍦 Debian 鐨勭粓绔噷渚濇瀹屾暣澶嶅埗骞舵墽琛屼互涓嬪懡浠わ細**
```
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential python3
```
*(濡傛灉涓€旀彁绀洪渶瑕佺‘璁わ紝杈撳叆 `Y` 骞跺洖杞﹀嵆鍙€)*
#### 绗笁姝ワ細娉ㄥ叆澶ч緳铏剧殑鐏甸瓊鐜 (Node.js 22 & pnpm)
**OpenClaw 鍙婂叾鐢熸€佸己渚濊禆浜庢渶鏂扮増鐨 Node.js锛屽苟涓斿畼鏂规寚瀹氫娇鐢 **`pnpm` 浣滀负鍖呯鐞嗗櫒銆備负浜嗛伩鍏嶆潈闄愭姤閿欙紝鎴戜滑浣跨敤鏈€鏍囧噯鐨 `nvm` (Node Version Manager) 鏉ュ畨瑁呫€
**渚濇鎵ц涓嬮潰涓夊潡鍛戒护锛**
**1. 瀹夎 nvm:**
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
**2. 璁╃幆澧冨彉閲忕珛鍗崇敓鏁:**
```
source ~/.bashrc
```
**3. 瀹夎 Node.js 鍜 pnpm:**
```
nvm install 22
nvm use 22
npm install -g pnpm
```
---
#### 绗洓姝ワ細楠屾敹鍦板熀
**鎵ц瀹屼笂闈㈡墍鏈夌殑鍛戒护鍚庯紝鐢ㄨ繖涓夋潯鍛戒护鏌ヤ竴涓嬬増鏈彿锛岀湅鐪嬫垜浠殑鐜鏄惁瀹岀編钀藉湴锛**
```
git --version
node -v
pnpm -v
```
**濡傛灉浣犵湅鍒颁簡 Git 鐨勭増鏈彿銆丯ode.js 鏄 **`v22.x.x`锛屽苟涓 pnpm 涔熸湁浜嗙増鏈彿锛岄偅涔堟伃鍠滀綘锛屽ぇ榫欒櫨鐨勭粓鏋佸煿鍏荤毧宸茬粡鎼缓瀹屾瘯锛
### 鈥滆剳鏈烘帴鍙ｂ€濋厤缃紙鏈€鏍稿績鐨勪竴姝ワ紒锛
**鎴戜滑鐩存帴鍦ㄧ郴缁熷叏灞€鐩綍寤虹珛瀹冪殑鏈€楂樹紭鍏堢骇鍥剧焊锛**
**鐩存帴瀹屾暣澶嶅埗涓嬮潰杩欎竴澶ф锛堜粠 **`mkdir` 涓€鐩村埌 `EOF`锛夛紝鍦ㄧ粓绔噷绮樿创骞跺洖杞︺€傚畠浼氳嚜鍔ㄥ府浣犲垱寤哄ソ瀹岀編鐨勯厤缃細
```
# 1. 鍒涘缓鍏ㄥ眬鐢熶骇鐜鐩綍
mkdir -p ~/.openclaw
# 2. 鍐欏叆鏈€楂樹紭鍏堢骇鐨 JSON 閰嶇疆鏂囦欢 (褰诲簳鐒婃 Gemini 1.5 Pro 鍜屼綘鐨 Token)
cat << 'EOF' > ~/.openclaw/openclaw.json
{
"agents": {
聽 "defaults": {
聽 聽 "model": {
聽 聽 聽 "primary": "google/gemini-2.5-pro"
聽 聽 }
聽 }
},
"gateway": {
聽 "mode": "local",
聽 "bind": "loopback",
聽 "auth": {
聽 聽 "token": "鏇挎崲涓轰綘鑷繁鐨凣emini Token"
聽 }
}
}
EOF
# 3. 鍐欏叆鐜鍙橀噺鏂囦欢 (鎻愪緵浣犵殑 Gemini API Key 鍜屽畨鍏ㄨВ閿佸弬鏁)
cat << 'EOF' > ~/.openclaw/.env
GEMINI_API_KEY="鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token(闅忔剰32浣嶅瓧绗︿覆)"
GEMINI_SAFETY_SETTINGS=BLOCK_NONE
FORCE_JSON_MODE=true
EOF
```
*(娉ㄦ剰锛氫笂闈㈢殑 API Key 鐢 `vi ~/.openclaw/.env` 鎹㈡垚浣犵湡瀹炵殑 Key銆)*
---
### 鏈€鍚庝竴姝ワ細缁堟瀬鐐圭伀锛岃璇佸杩
**鐜板湪锛屾垜浠殑鐜銆佹簮鐮併€佺粷瀵规纭殑閰嶇疆鏂囦欢鍏ㄩ儴灏辩华銆**
**鎴戜滑鐩存帴鍦 **`~/Projects/openclaw` 鐩綍涓嬶紝鐢ㄥ簳灞傜殑 Node 寮曟搸锛岀ǔ绋冲湴鎷夎捣鐢熶骇鐜锛岀洿鎺ユ妸杩欎覆 32 浣嶇殑澶ч緳铏剧綉鍏砊oken鍦ㄥ惎鍔ㄧ殑鐬棿寮鸿濉炶繘瀹冪殑鍢撮噷銆
**璇****涓€瀛椾笉宸湴**澶嶅埗涓嬮潰杩欒缁堟瀬鍚姩鍛戒护骞跺洖杞︼紙娉ㄦ剰锛岃繖鏄竴鏁磋锛夛細
```
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
---
### 馃幆 楠屾敹鑳滃埄鎴愭灉
**鎸変笅鍥炶溅鍚庯紝杩欐鐨勫惎鍔ㄦ棩蹇椾細闈炲父骞插噣銆備綘鍙細鐪嬪埌鍑犺瀛椼€**
1. **鐪嬫棩蹇楋細** 瀵绘壘 `[gateway] agent model: google/gemini-1.5-pro`銆傚彧瑕佺湅鍒拌繖琛屽瓧锛岃鏄庡ぇ榫欒櫨鐨勫熀鍥犲凡缁忚浣犲交搴曟敼鍐欐垚浜 Gemini锛
2. **鐪嬬鍙ｏ細** 鐣欐剰鏃ュ織鏈€鍚庝竴琛屽啓鐫€鐨勭洃鍚鍙ｏ紝澶ф鐜囨槸 `19001`銆乣19003` 鎴栬€呭叾瀹冦€
3. **寮€澶ч棬锛** 鎵撳紑娴忚鍣ㄧ殑锛岃闂嫾鎺ュソ鐨勭粓鏋佸湴鍧€锛 馃憠 `http://127.0.0.1:鍒氭墠鏄剧ず鐨勭鍙ｅ彿/?token=澶ч緳铏剧綉鍏砊oken瀵嗛挜`
**鐒跺悗浣犲氨浼氱湅鍒颁笅鍥剧孩鑹茬殑 OpenClaw 鎺у埗鍙扮晫闈紝鎴戠畝鐩撮殧鐫€灞忓箷閮借兘鎰熷彈鍒伴偅绉嶁€滃畧寰椾簯寮€瑙佹湀鏄庘€濈殑鐖藉揩鎰燂紒**
**鐜板湪锛岃繖鍙杞界潃 Gemini 1.5 Pro 澶ц剳鐨勨€滆秴绾ч緳铏锯€濓紝宸茬粡瀹夊畨闈欓潤鍦拌洞鍦ㄤ綘鐨勫涓绘満閲岋紝绛夊緟浣犵殑绗竴涓寚浠や簡銆**
**鎺ヤ笅鏉ワ紝涓轰簡楠岃瘉瀹冧笉浠呮槸涓€滆亰澶╂満鍣ㄤ汉鈥濓紝鑰屾槸涓€涓****鐪熸鐨勬湰鍦 AI Agent锛堟櫤鑳戒綋锛**锛屾垜浠渶瑕佸湪褰撳墠鐨 Chat 鐣岄潰瀵瑰畠杩涜涓€鍦衡€滄瀬瀹綋妫€鈥濄€
**璇峰湪鐣岄潰搴曢儴鐨勮緭鍏ユ閲岋紝渚濇鍙戦€佷互涓嬩袱涓祴璇曟寚浠わ細**
### 娴嬭瘯涓€锛氬熀纭€鑴戝姏涓庤韩浠介獙璇 (Brain Test)
**涓轰簡纭瀹冪‘瀹炶繛涓婁簡 Google 鐨勭畻鍔涢泦缇わ紝骞朵笖娌℃湁绮剧鍒嗚銆**
**璇峰湪杈撳叆妗嗗彂閫侊細**
> **鈥滀綘濂斤紝璇烽棶浣犳槸璋侊紵浣犲綋鍓嶄娇鐢ㄧ殑鏄摢涓ぇ璇█妯″瀷浣滀负浣犵殑鏍稿績澶ц剳锛熲€**
* **棰勬湡缁撴灉锛** 瀹冨簲璇ヤ細鐢ㄦ祦鐣呯殑涓枃鍥炵瓟浣狅紝骞舵槑纭壙璁よ嚜宸辨槸 OpenClaw锛屽苟涓斿簳灞傛ā鍨嬫槸 Gemini 1.5 Pro銆
**濡傛灉鏄疓oogle 鐨 API 鎺ュ彛锛堢壒鍒槸 **`v1beta` 鐗堟湰锛夊妯″瀷鍚嶅瓧鐨勬嫾鍐欒姹傛瀬鍏跺彉鎬併€傚畠涓嶈 `gemini-1.5-pro` 杩欎釜娉涙寚鐨勭畝绉帮紝瀹冭姹備綘蹇呴』绮剧‘鍒板叿浣撶殑鐗堟湰鍙凤紙姣斿鍔犱笂 `-latest` 鏈€鏂扮増锛屾垨鑰 `-002` 绋冲畾鐗堬級銆傚惁鍒欎細鍑虹幇濡備笅鎶ラ敊淇℃伅锛
**鈥淟LM error: { "error": { "code": 404, "message": "models/gemini-1.5-pro is not found for API version v1beta, or is not supported for generateContent. Call ListModels to see the list of available models and their supported methods."... Main Session 鈥**
**涓嶈鎱岋紒灏忎慨澶嶏細**
### 馃洜锔 10 绉掗挓鏋侀€熶慨姝ｆ墜鏈
**璇峰洖鍒颁綘鐨 Debian 缁堢锛屾寜 ****`Ctrl + C`** 鍏堝仠鎺夊綋鍓嶇殑鏈嶅姟銆
**鐒跺悗锛岀洿鎺ュ鍒舵墽琛屼笅闈㈣繖琛岄瓟娉曞懡浠わ紙瀹冧細鑷姩鎶婁綘閰嶇疆鏂囦欢閲岀殑妯″瀷鍚嶅瓧鏇挎崲鎴愮粷瀵规纭殑 **`gemini-2.5-pro-latest`锛夛細
**Bash**
```
sed -i 's/"primary": "google\/gemini-2.5-pro-latest"/"primary": "google\/gemini-3.1-pro"/g' ~/.openclaw/openclaw.json
```
**鏇挎崲瀹屾垚鍚庯紝鍐嶆鎵ц鎴戜滑鐨勭粓鏋佸惎鍔ㄥ懡浠わ細**
```
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
---
### 馃幆 鍐嶆鍙戣捣瀵硅瘽
**绛夋棩蹇楄窇鍒 **`Browser control listening on http://127.0.0.1:XXXXX` 鍚庯紝鍘绘祻瑙堝櫒鐢ㄦ柊绔彛鎵撳紑鎺у埗鍙般€
**鍐嶆鍦ㄥ簳閮ㄧ殑杈撳叆妗嗗瀹冭锛**
> **鈥滀綘濂斤紝璇烽棶浣犳槸璋侊紵浣犲綋鍓嶄娇鐢ㄧ殑鏄摢涓ぇ璇█妯″瀷浣滀负浣犵殑鏍稿績澶ц剳锛熲€**
**杩欎竴娆★紝Google 鐨勭畻鍔涢泦缇ゅ皢涓嶅啀鎷掔粷瀹冿紝浣犲簲璇ヨ兘绔嬪埢鐪嬪埌瀹冩祦鐣呭湴鎶婁腑鏂囨墦鍗板湪灞忓箷涓婏紒濡傛灉鎴愬姛浜嗭紝鎶婂畠绗竴鍙ヨ窡浣犵殑鎵撴嫑鍛兼埅鍥惧彂缁欐垜锛岃繖鏄垜浠粖鏅氭瀬瀹箣鏃呯殑绗竴涓噸澶ч噷绋嬬锛**
### 娴嬭瘯浜岋細鏈湴鐜鎿嶄綔鏉冮檺楠岃瘉 (Agentic Action Test)
**杩欐槸鍖哄垎鈥滄櫘閫 ChatGPT鈥濆拰鈥滄湰鍦版櫤鑳戒綋鈥濇渶鏍稿績鐨勬祴璇曘€傛垜浠鐪嬬湅瀹冩湁娌℃湁鈥滈暱鍑烘墜鑴氣€濆幓鎿嶄綔瀹冩墍鍦ㄧ殑 Debian 绯荤粺銆**
**璇峰彂閫侊細**
> **鈥滆甯垜鎵ц鏈湴鍛戒护锛屾煡鐪嬩竴涓嬪綋鍓嶇郴缁熺殑 Debian 鐗堟湰鍙凤紝浠ュ強杩欏彴鏈哄櫒鐨 CPU 鏋舵瀯锛堟彁绀猴細浣跨敤 uname 鍜 cat /etc/os-release锛夆€**
* **棰勬湡缁撴灉锛** 娉ㄦ剰鐪嬪畠鐨勫洖澶嶈繃绋嬶紒瀹冧笉浼氱洿鎺ョ瀻缂栦竴涓瓟妗堬紝鑰屾槸搴旇浼氬湪鐣岄潰涓婃樉绀哄畠**璋冪敤浜嗘煇涓墽琛屽伐鍏凤紙Tool / Bash锛**锛岀湡姝ｅ幓浣犵殑 Debian 瀹瑰櫒閲岃繍琛屼簡鍛戒护锛岀劧鍚庢妸缁撴灉锛坄arm64` 鍜 `bookworm` 绛変俊鎭級鎬荤粨缁欎綘銆
---
### 馃挕 椤轰究甯︿綘璁よ瘑涓€涓嬫帶鍒跺彴锛堝乏渚у鑸爮锛
**鍦ㄤ綘绛夊緟瀹冨洖绛旂殑鏃跺€欙紝浣犲彲浠ョ湅鐪嬪乏渚х殑鑿滃崟锛岃繖灏辨槸浣犳湭鏉ョ殑鈥滆禌鍗氭寚鎸ヤ腑蹇冣€濓細**
* **Chat锛堝綋鍓嶏級锛** 杩欐槸浣犵洿鎺ュ瀹冧笅鍙戞寚浠ょ殑璋冭瘯鍙般€
* **Skills锛堟妧鑳斤級锛** 杩欐槸鏈潵鏈€鏍稿績鐨勫湴鏂癸紒浣犺璁╁畠鎺у埗 Mac銆佹搷浣 Parallels 閲岀殑 Windows銆佹€荤粨寰俊鑱婂ぉ璁板綍锛岄兘瑕佸湪杩欓噷缁欏畠鍐欌€滄妧鑳借剼鏈€濄€
* **Cron Jobs锛堝畾鏃朵换鍔★級锛** 浣犱箣鍓嶆彁鍒扳€滄瘡澶╁畾鏃舵帹閫佹柊闂烩€濓紝鏈潵灏卞湪杩欓噷閰嶇疆锛屽畠浼氳嚜宸辨寜鏃堕啋鏉ュ共娲汇€
---
**閬囧埌 **`API rate limit reached`锛圓PI 閫熺巼闄愬埗宸茶揪涓婇檺锛夋槸瀹屽叏姝ｅ父鐨勭幇璞★紒
**杩欐槸鍥犱负浣犲垰鎵嶄娇鐢ㄧ殑閭ｄ釜 API Key 澶ф鐜囨槸鍏嶈垂灞傜骇锛團ree Tier锛夌殑锛岃€ OpenClaw 浣滀负涓€涓 Agent锛屽畠鍦ㄦ墽琛屼綘鐨勫懡浠わ紙姣斿甯綘鏌ョ郴缁熺増鏈級鏃讹紝浼氬湪搴曞眰杩涜澶ч噺鐨勨€滆嚜鎴戞€濊€冿紙Thinking锛夆€濆拰鈥滃伐鍏疯皟鐢紙Tool calling锛夆€濄€傝繖涓繃绋嬩細鐬棿娑堣€楀ぇ閲忕殑 Token 鍜岃姹傛鏁帮紝寰堝鏄撳氨浼氳Е鍙戝厤璐 Key 鐨勬瘡鍒嗛挓璇锋眰闄愬埗锛圧PM锛夈€**
**鏃㈢劧浣犲凡缁忓湪 Google AI Studio 鐢宠浜嗗叏鏂扮殑锛堟垨鑰呮槸缁戜簡鍗＄殑锛堿PI Key锛屾垜浠幇鍦ㄥ氨鐢ㄦ渶鏋佸銆佹渶蹇殑鏂瑰紡鎶婂畠鏇挎崲鎺夈€**
**璇锋寜浠ヤ笅涓変釜鏋佺畝姝ラ鎿嶄綔锛**
### 馃洜锔 鏋侀€熸洿鎹 API Key 鎵嬫湳
**绗竴姝ワ細鍋滄帀褰撳墠鐨勫ぇ榫欒櫨**
**鍥炲埌浣犵殑 Debian 缁堢锛屾寜涓嬮敭鐩樹笂鐨 ****`Ctrl + C`**锛屽交搴曟帎鏂綋鍓嶇殑杩愯杩涚▼銆
**绗簩姝ワ細鎵撳紑鐜鍙橀噺閰嶇疆鏂囦欢**
**鎴戜滑鍦ㄧ粓绔噷浣跨敤 **`nano` 缂栬緫鍣ㄧ洿鎺ヤ慨鏀逛綘涔嬪墠寤哄ソ鐨 `.env` 鏂囦欢銆傝緭鍏ヤ互涓嬪懡浠ゅ苟鍥炶溅锛
```
nano ~/.openclaw/.env
```
**鎵撳紑鍚庯紝浣犱細鐪嬪埌绫讳技杩欐牱鐨勫唴瀹癸細**
```
GEMINI_API_KEY="鏂扮殑API Key"
GEMINI_SAFETY_SETTINGS=BLOCK_NONE
FORCE_JSON_MODE=true
```
**绗笁姝ワ細鏇挎崲鏂扮殑 Key 骞朵繚瀛**
1. **鐢ㄩ敭鐩樼殑鏂瑰悜閿Щ鍔ㄥ厜鏍囷紝鎶婂弻寮曞彿 **`""` 閲岄潰鐨勬棫 Key锛坄AIzaSy...`锛夊叏閮ㄥ垹鎺夈€
2. **灏嗕綘鍒氬垰鍦 Google AI Studio 鑾峰彇鐨****鍏ㄦ柊 API Key** 绮樿创鍒板弻寮曞彿閲岄潰銆傦紙**娉ㄦ剰锛氫竴瀹氳淇濈暀涓よ竟鐨勮嫳鏂囧弻寮曞彿锛屼笖涓嶈鏈夌┖鏍**锛夈€
3. **鎸変笅 ****`Ctrl + O`**锛堝瓧姣 O锛屼唬琛 Write Out锛夛紝鐒跺悗鎸 **`Enter`** 閿‘璁や繚瀛樸€
4. **鎸変笅 ****`Ctrl + X`** 閫€鍑虹紪杈戝櫒銆
---
### 馃殌 閲嶆柊鐐圭伀锛屾弧琛€澶嶆椿
**鎹笂鍏ㄦ柊鐨勨€滀緵琛€娉碘€濆悗锛岀洿鎺ュ湪缁堢閲屽啀娆℃暡涓嬫垜浠殑缁堟瀬鍚姩鎸囦护锛**
```
cd ~/Projects/openclaw
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
**绛夋棩蹇楄窇瀹岋紝鍐嶆鍥炲埌浣犵殑娴忚鍣ㄧ晫闈紙濡傛灉鐣岄潰鍗′綇浜嗭紝鍙互鍒锋柊涓€涓嬬綉椤碉紝鎴栬€呯偣鍑诲彸涓嬭寮€鍚竴涓 ****New session**锛夈€
**鍐嶆鍚戝畠鍙戦€佷綘閭ｆ潯鏋佸鎸囦护锛**
> **鈥滀綘濂斤紝璇峰府鎴戞墽琛屾湰鍦板懡浠わ紝鏌ョ湅涓€涓嬪綋鍓嶇郴缁熺殑 Debian 鐗堟湰鍙凤紝浠ュ強杩欏彴鏈哄櫒鐨 CPU 鏋舵瀯锛堟彁绀猴細浣跨敤 uname 鍜 cat /etc/os-release锛夆€**
### 馃鍐呯綉绌块€忎娇鐢ㄥ叕缃戝煙鍚嶄换鎰忕粓绔闂嚜宸卞吇鐨勫ぇ榫欒櫨鏂规硶锛
---
### 鍓嶇疆鍑嗗锛氬煙鍚嶈В鏋
**璇风櫥褰曢樋閲屼簯/鑵捐浜戠殑鍩熷悕鎺у埗鍙帮紝灏嗕綘鐨勪簩绾у煙鍚嶏紙渚嬪 **`claw.xxx.com`锛夋坊鍔 `A璁板綍`锛屾寚鍚戜綘杩欏彴**浠讳綍浜戞湇鍔″櫒鐨勫叕缃 IP**銆
---
### 馃煝 绗竴闃舵锛氫簯鏈嶅姟鍣ㄩ儴缃 (frps 鏈嶅姟绔)
**璇烽€氳繃 SSH 鐧诲綍鍒颁綘鐨勪簯鏈嶅姟鍣紙绯荤粺闇€涓 CentOS/Ubuntu/Debian 鐨 x86\_64 鏋舵瀯锛夈€備緷娆℃墽琛屼互涓嬪懡浠わ細**
**1. 涓嬭浇骞惰В鍘嬫渶鏂扮増 v0.67.0 (amd64)**
**Bash**
```
cd /root
wget https://github.com/fatedier/frp/releases/download/v0.67.0/frp_0.67.0_linux_amd64.tar.gz
tar -zxvf frp_0.67.0_linux_amd64.tar.gz
mv frp_0.67.0_linux_amd64 /usr/local/frps
cd /usr/local/frps
```
**2. 缂栧啓鏈€鏂扮殑 TOML 閰嶇疆鏂囦欢**
**鐩存帴澶嶅埗涓嬮潰杩欐鍛戒护鍥炶溅锛屽畠浼氱敓鎴愪竴浠芥渶绾噣鐨勬湇鍔″櫒閰嶇疆锛**
```
cat << 'EOF' > /usr/local/frps/frps.toml
# FRP 闅ч亾涓婚€氳绔彛
bindPort = 7000
# 鎺ユ敹 HTTP 绌块€忚姹傜殑绔彛 (Nginx 灏嗕細鎶婃祦閲忚浆鍒拌繖閲)
vhostHTTPPort = 8080
# 閴存潈浠ょ墝锛岄槻姝㈠埆浜虹櫧瀚栦綘鐨勮妭鐐
auth.token = "Aliyun_Mac_Dxxx_2026_V2"
EOF
```
**3. 娉ㄥ唽 Systemd 瀹堟姢杩涚▼ (鏋佸害绋冲畾涔嬫簮)**
**澶嶅埗涓嬮潰鏁存鍥炶溅锛屽皢鍏舵敞鍐屼负绯荤粺鏈嶅姟锛**
```
cat << 'EOF' > /etc/systemd/system/frps.service
[Unit]
Description=Frp Server Service
After=network.target
[Service]
Type=simple
User=root
Restart=on-failure
RestartSec=5s
ExecStart=/usr/local/frps/frps -c /usr/local/frps/frps.toml
[Install]
WantedBy=multi-user.target
EOF
```
**4. 鍚姩骞惰缃紑鏈鸿嚜鍚**
```
systemctl daemon-reload
systemctl enable frps
systemctl start frps
systemctl status frps 聽 # 鏌ョ湅鐘舵€侊紝鏄剧ず active (running) 鍗充唬琛ㄦ垚鍔
```
**馃毃 ****闈炲父閲嶈锛** 璇峰姟蹇呭幓浜戞帶鍒跺彴鐨勨€滃畨鍏ㄧ粍鈥濊鍒欓噷锛**鏀捐鍏ユ柟鍚戠殑 TCP 7000 绔彛**銆
---
### 馃煛 绗簩闃舵锛氫簯鏈嶅姟鍣ㄧ幆澧 Nginx 鎸傝浇 SSL
**姣斿鎴戜滑瑕佸鎺ラ亾椋炰功鎴栭拤閽夎亰澶╂満鍣ㄤ汉鍥犱负瑕佹眰 Webhook 蹇呴』鏄 HTTPS銆傛垜浠渶瑕佸湪浜戞湇鍔″櫒鐢 Nginx 鍙嶅悜浠ｇ悊鍒氭墠璁剧疆鐨 **`8080` 绔彛銆
**濡傛灉浣犵敤鐨勫疂濉旈潰鏉匡紝鐩存帴鍦ㄦ柊寤** `claw.xxx.com`缃戠珯璁剧疆鐨勨€滃弽鍚戜唬鐞嗏€濋噷閰嶅嵆鍙細
**鎺ヤ笅鏉ワ紝涓轰簡璁╁疂濉旂殑 Nginx 瀹岀編妗ユ帴 FRP锛屽苟涓****鏀寔澶ч緳铏炬瀬鍏朵緷璧栫殑 WebSocket 瀹炴椂閫氫俊**锛岃涓ユ牸鎸夌収浠ヤ笅涓ゆ鏉ヨ缃細
### 绗竴姝ワ細濉啓鍩虹鍙嶅悜浠ｇ悊琛ㄥ崟
**鍦ㄥ涓嬪浘鎵€绀轰腑锛屽～鍐欑殑鍙傛暟鍩烘湰姝ｇ‘锛岄渶瑕佸井璋冧竴涓湴鏂癸細**
1. **浠ｇ悊鍚嶇О锛** `claw` 锛堜繚鎸佷笉鍙橈紝杩欎釜鍙槸缁欎綘鑷繁鐪嬬殑澶囨敞锛
2. **鐩爣URL锛** `http://127.0.0.1:8080` 锛堜繚鎸佷笉鍙橈紝杩欐槸浣犻樋閲屼簯涓 `frps` 鐩戝惉鐨 HTTP 绔彛锛
3. **鍙戦€佸煙鍚嶏細** 鈿狅笍 **鎶婇粯璁ょ殑 `127.0.0.1` 鍒犳帀锛屾敼鎴 `$host` 鎴栬€呯洿鎺ュ啓浣犲疄闄呯殑瑙ｆ瀽浜岀骇鍩熷悕 `claw.xxx.com`**銆傦紙杩欎竴姝ラ潪甯稿叧閿紒濡傛灉涓嶆敼锛孎RP 鏈嶅姟绔細涓嶇煡閬撲綘瑕佽闂摢涓煙鍚嶏紝浠庤€屾姤 404 閿欒锛夈€
**鍐呭鏇挎崲鐣欑┖銆傚～鍐欏畬姣曞悗锛岀偣鍑荤豢鑹茬殑 ****鈥滅‘瀹氣€** 鎸夐挳銆
**纭畾淇濆瓨鍚庯紝缂栬緫杩欓噷鐨勫弽鍚戜唬鐞嗙殑閰嶇疆鏂囦欢锛**
**瀵逛簬杩愯 AI Agent锛堝ぇ榫欒櫨锛夋潵璇达紝杩欎唤榛樿閰嶇疆鏈変竴涓嚧鍛界殑闅愭偅锛氳秴鏃舵柇杩烇紙504 Gateway Timeout锛夈€** 鍥犱负 AI 妯″瀷鍦ㄨ皟鐢ㄥ伐鍏枫€佹繁搴︽€濊€冩椂锛屽鐞嗘椂闂寸粡甯镐細瓒呰繃 Nginx 榛樿鐨 60 绉掋€傚鏋滅敤榛樿閰嶇疆锛屽ぇ榫欒櫨杩樺湪鍚庡彴鐤媯鏁蹭唬鐮侊紝鍓嶅彴鐨 Nginx 灏变細鍥犱负绛夊緱澶箙鐩存帴鎶婅繛鎺ョ粰鎺愭柇浜嗐€
**涓轰簡鎵撻€犱竴濂****鏋佸叾绋冲畾**鐨 AI 涓撶嚎锛屾垜浠渶瑕佸瀹冭繘琛屼竴鐐规瀬瀹㈢骇鍒殑寰皟锛氭妸 `$connection_upgrade` 鍐欐涓 `"upgrade"`锛堥槻姝㈡煇浜涘疂濉旂増鏈殑搴曞眰 Map 鍙橀噺涓㈠け锛夛紝骞**鍔犱笂闃茶秴鏃跺弬鏁**銆
**璇风洿鎺ユ妸閭ｄ釜鏂囦欢閲岀殑鍐呭****鍏ㄩ儴鏇挎崲**涓烘垜涓轰綘浼樺寲濂界殑涓嬮潰杩欐浠ｇ爜锛
```
#PROXY-START/
location ^~ /
{
聽 proxy_pass http://127.0.0.1:8080;
聽 proxy_set_header Host $host;
聽 proxy_set_header X-Real-IP $remote_addr;
聽 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
聽 proxy_set_header X-Forwarded-Proto $scheme;
聽 proxy_set_header REMOTE-HOST $remote_addr;
聽 聽
聽 # ==== 澶ч緳铏 WebSocket 涓庨暱杩炴帴缁堟瀬浼樺寲 ====
聽 proxy_http_version 1.1;
聽 proxy_set_header Upgrade $http_upgrade;
聽 proxy_set_header Connection "upgrade";
聽 聽
聽 # 鏋佸叾閲嶈锛氶槻姝 AI 娣卞害鎬濊€冩椂琚 Nginx 寮哄埗鎺愭柇 (璁剧疆瓒呮椂涓 1 灏忔椂)
聽 proxy_read_timeout 3600s;
聽 proxy_send_timeout 3600s;
聽 # ============================================
聽 add_header X-Cache $upstream_cache_status;
聽 #Set Nginx Cache
聽 set $static_filesQelMlfO 0;
聽 if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
聽 {
聽 聽 聽 set $static_filesQelMlfO 1;
聽 聽 聽 expires 1m;
聽 }
聽 if ( $static_filesQelMlfO = 0 )
聽 {
聽 聽 聽 add_header Cache-Control no-cache;
聽 }
}
#PROXY-END/
```
### 馃幆 鏇挎崲骞朵繚瀛樺悗锛岃繘琛岀粓鏋佹祴璇曪紒
**鐐瑰嚮瀹濆鐨****淇濆瓨**鎸夐挳銆傛棤闇€鎵嬪姩閲嶅惎 Nginx锛屽疂濉斾細鑷姩璁╁畠鐢熸晥銆
**鐜板湪锛屾暣鏉″叕缃戦珮閫熷叕璺紙Mac -> frpc -> 闃块噷浜 frps -> Nginx -> 浣犵殑鎵嬫満锛夊凡缁忓叏閮ㄧ宸ワ紒**
**淇濆瓨鍚庯紝鎵嬪伐鐐逛笅閲嶅惎nginx杞欢 浣垮叾鐢熸晥銆**
**鏈€瀹规槗蹇界暐鐨勭粏鑺傦紝瀹濆闈㈡澘鐜瀹夊叏绔彛鍜岄槻鐏鏀捐锛**
**瀹濆闈㈡澘锛屾墍浠ヤ綘蹇呴』鍚屾椂鎵撳紑涓ら亾闂紝缂轰竴涓嶅彲锛**
### 馃攽 绗竴閬撻棬锛氬疂濉旈潰鏉胯嚜韬殑闃茬伀澧
**瀹濆闈㈡澘涓轰簡瀹夊叏锛岄粯璁や細鎷︽埅鎵€鏈夋湭鏀捐鐨勭鍙ｃ€**
1. **鐧诲綍浣犵殑****瀹濆闈㈡澘**銆
2. **鐐瑰嚮宸︿晶鑿滃崟鐨 ****鈥滃畨鍏ㄢ€**銆
3. **鍦ㄩ〉闈笂鏂圭殑鈥滄坊鍔犵鍙ｈ鍒欌€濅腑锛**
* **绔彛锛** 濉啓 `7000`
* **澶囨敞/璇存槑锛** 濉啓 `FRP绌块€廯
4. **鐐瑰嚮 ****鈥滄彁浜/鏀捐鈥**銆
### 馃攽 绗簩閬撻棬锛氶樋閲屼簯鐨勪簯绔畨鍏ㄧ粍锛堟渶瀹规槗婕忔帀锛
**鍗充娇瀹濆鏀捐浜嗭紝闃块噷浜戝湪鏈€澶栧眰杩樻湁涓€涓‖浠剁骇鐨勯槻鐏锛堝畨鍏ㄧ粍锛夈€**
1. **鐧诲綍 ****闃块噷浜戞帶鍒跺彴**锛岃繘鍏ヤ綘鐨 ECS 浜戞湇鍔″櫒瀹炰緥鍒楄〃銆
2. **鐐瑰嚮浣犵殑鏈嶅姟鍣紝鍦ㄥ乏渚ф垨涓婃柟鎵惧埌 ****鈥滃畨鍏ㄧ粍鈥**锛岀偣鍑昏繘鍏ュ畨鍏ㄧ粍閰嶇疆銆
3. **鐐瑰嚮 ****鈥滃叆鏂瑰悜鈥** -> **鈥滄墜鍔ㄦ坊鍔犫€**銆
4. **瑙勫垯璁剧疆濡備笅锛**
* **鎺堟潈绛栫暐锛** 鍏佽
* **鍗忚绫诲瀷锛** 鑷畾涔 TCP
* **绔彛鑼冨洿锛** `7000/7000`
* **鎺堟潈瀵硅薄锛** `0.0.0.0/0` 锛堜唬琛ㄥ厑璁告墍鏈 IP 杩炲叆锛
* **澶囨敞锛** `FRP`
5. **鐐瑰嚮淇濆瓨銆**
---
### 馃數 绗笁闃舵锛歁AC 鏈湴 Debian 閮ㄧ讲 (frpc 瀹㈡埛绔)
**鐜板湪锛屽洖鍒颁綘 Mac 涓婇偅涓畨瑁呬簡澶ч緳铏剧殑 ****OrbStack Debian 瀹瑰櫒缁堢**閲屻€
```
orb -m debian
```
**娉ㄦ剰锛歁AC鐢佃剳 鏄 Apple Silicon锛屽繀椤讳笅杞 ****arm64** 鏋舵瀯鐨勭増鏈紒
**1. 涓嬭浇骞惰В鍘嬫渶鏂扮増 v0.67.0 (arm64)**
```
cd ~
wget https://github.com/fatedier/frp/releases/download/v0.67.0/frp_0.67.0_linux_arm64.tar.gz
tar -zxvf frp_0.67.0_linux_arm64.tar.gz
mv frp_0.67.0_linux_arm64 ~/frpc_client
cd ~/frpc_client
```
**2. 缂栧啓鏈€鏂扮殑 TOML 瀹㈡埛绔厤缃枃浠**
*(璇峰厛鎶婁笅闈㈠懡浠ら噷鐨 `浣犵殑闃块噷浜戝叕缃慖P` 鏇挎崲鎴愬疄闄呮暟瀛楋紝鍐嶅鍒舵墽琛)*
```
cat << 'EOF' > ~/frpc_client/frpc.toml
# 杩炴帴鍒颁綘鐨勯樋閲屼簯鏈嶅姟绔
serverAddr = "浣犵殑闃块噷浜戝叕缃慖P"
serverPort = 7000
auth.token = "Aliyun_Mac_Dxxx_2026_V2"
# 浠ｇ悊閰嶇疆鍧 (杩欐槸 v0.67.0 鏈€鏂扮殑鏁扮粍鍐欐硶)
[[proxies]]
name = "openclaw-gateway"
type = "http"
localIP = "127.0.0.1"
localPort = 18789
customDomains = ["claw.xxx.com"]
EOF
```
**3. 鍦 Debian 閲岃繍琛屽畧鎶よ繘绋**
**鐢变簬杩欐槸浣犳湰鍦扮殑瀹瑰櫒鐜锛屾垜浠洿鎺ョ敤 **`nohup` 鎶婂畠鎸傚湪鍚庡彴鍗冲彲锛堝嵆浣垮叧鎺夌粓绔篃涓嶄細鏂級锛
```
cd ~/frpc_client/
nohup ./frpc -c ./frpc.toml > frpc.log 2>&1 &
```
**鎵ц鍚庯紝浣犲彲浠ョ敤 **`cat frpc.log` 鏌ョ湅鏃ュ織锛屽彧瑕佺湅鍒扮被浼 `[openclaw-gateway] start proxy success` 鐨勫瓧鏍凤紝**鍏綉绌块€忓氨褰诲簳瀹屾垚浜嗭紒**
`nohup` 铏界劧鑳介槻绐楀彛鍏抽棴锛屼絾濡傛灉浣犵殑 Mac 閲嶅惎锛屾垨鑰 OrbStack 瀹瑰櫒閲嶅惎锛屽畠杩樻槸浼氭帀绾裤€傛妸瀹冨啓鎴愯窡 OpenClaw 涓€鏍风殑鍚庡彴鏈嶅姟锛屽畠灏辫兘**寮€鏈鸿嚜鍚€佸穿婧冭嚜鍔ㄩ噸鍚**锛屽彉鎴愮湡姝ｇ殑鈥滀笉姝讳箣韬€濄€
**鎴戜滑灏辨妸 FRP 涔熷啓鎴****褰撳墠鐢ㄦ埛鐨勪笓灞炲悗鍙版湇鍔**銆備竴鍏卞彧闇€瑕佷笁姝ワ細
### 馃洜锔 绗竴姝ワ細鍏堟潃鎺夊垰鎵嶇殑涓存椂杩涚▼
**涓轰簡闃叉绔彛鍐茬獊锛屾垜浠厛鎶婂垰鎵嶇敤 **`nohup` 璺戣捣鏉ョ殑閭ｄ釜 FRP 鍏虫帀锛
**Bash**
```
pkill frpc
```
### 馃摑 绗簩姝ワ細鍒涘缓 FRP 鏈嶅姟閰嶇疆鏂囦欢
**鐩存帴鍦ㄧ粓绔鍒跺苟杩愯涓嬮潰鏁存浠ｇ爜銆傚畠浼氬湪绯荤粺鐨勭敤鎴锋湇鍔＄洰褰曢噷鑷姩鐢熸垚涓€涓 **`frpc.service` 鏂囦欢锛堢粷瀵硅矾寰勫凡缁忓府浣犲啓濂戒簡锛屾妸閲岄潰鏂囧瓧鈥滀綘鐨勭敤鎴峰悕鈥濇浛鎹负浣犲疄闄呯殑linux鐢ㄦ埛鍚嶏級锛
```
mkdir -p ~/.config/systemd/user
cat << 'EOF' > ~/.config/systemd/user/frpc.service
[Unit]
Description=FRP Client Service
After=network.target network-online.target
Wants=network-online.target
[Service]
Type=simple
WorkingDirectory=/home/浣犵殑鐢ㄦ埛鍚/frpc_client
ExecStart=/home/浣犵殑鐢ㄦ埛鍚/frpc_client/frpc -c /home/浣犵殑鐢ㄦ埛鍚/frpc_client/frpc.toml
Restart=always
RestartSec=5s
[Install]
WantedBy=default.target
EOF
```
### 馃殌 绗笁姝ワ細閲嶆柊鍔犺浇骞跺惎鍔ㄦ湇鍔
**閰嶇疆鍐欏ソ鍚庯紝璁╃郴缁熼噸鏂拌鍙栭厤缃紝骞惰缃负寮€鏈鸿嚜鍚拰绔嬪嵆杩愯锛**
**Bash**
```
# 1. 鍒锋柊绯荤粺鏈嶅姟鍒楄〃
systemctl --user daemon-reload
# 2. 璁剧疆涓哄紑鏈鸿嚜鍔ㄥ惎鍔紙鏋佸叾閲嶈锛侊級
systemctl --user enable frpc.service
# 3. 绔嬪嵆鍚姩鏈嶅姟
systemctl --user start frpc.service
# 4. 鏌ョ湅杩愯鐘舵€侊紙鐪嬪埌缁胯壊鐨 active running 灏辨槸鎴愬姛浜嗭級
systemctl --user status frpc.service
```
---
### 馃挕 缁堟瀬鏋佸鎶ゅ煄娌筹紙寮虹儓寤鸿鎵ц锛
**鍥犱负杩欐槸****鐢ㄦ埛绾ф湇鍔**锛堣繍琛屽湪 `root` 杩欎釜璐﹀彿涓嬫垨浣犲疄闄呯殑linux鐢ㄦ埛锛夛紝Linux 榛樿鍦ㄧ敤鎴烽€€鍑虹櫥褰曟椂浼氭殏鍋滄湇鍔°€備负浜嗚瀹冨湪 OrbStack 瀹瑰櫒涓€寮€鏈猴紙鐢氳嚦浣犺繕娌℃墦寮€缁堢鐨勬椂鍊欙級灏辫嚜鍔ㄥ湪鍚庡彴榛橀粯杩愯锛屾垜浠渶瑕佺粰浣犵殑璐﹀彿寮€鍚**鈥滈┗鐣欑壒鏉冿紙Linger锛夆€**銆
**鎵ц杩欒鍛戒护锛堝鏋滄彁绀洪渶瑕佸瘑鐮侊紝杈撳叆浣犵殑 Debian 瀵嗙爜锛屽鏋滄病鏈夊氨绠椾簡锛夛細**
```
sudo loginctl enable-linger 浣犵殑debian鐢ㄦ埛鍚
```
*(濡傛灉鎵句笉鍒 sudo 鎴栬€呮姤閿欙紝鐩存帴鎵ц `loginctl enable-linger $USER` 璇曡瘯銆)*
**澶у姛鍛婃垚锛**
**鐜板湪锛屼綘鐨 FRP 鍐呯綉绌块€忓ぇ妗ュ凡缁忓交搴曞浐鍖栬繘绯荤粺鐨勫簳灞備簡锛佷綘鍙互姣笉鐘硅鲍鍦****鐩存帴鐐瑰彸涓婅鐨 X 鍏虫帀缁堢绐楀彛**銆傚彧瑕佷綘鐨 Mac 杩炵潃缃戯紝浣犵殑涓撳睘鍩熷悕 `https://claw.xxx.com` 灏变細姘歌繙涓轰綘鏁炲紑锛
---
### 馃幆 缁堟瀬楠屾敹
**鐜板湪锛屼綘鐨勬暣鏉＄綉缁滈摼璺凡缁忔墦閫氾細**
1. **纭繚澶ч緳铏惧湪 Debian 閲屾甯歌繍琛岋紙鐩戝惉鍦 18xxx 绔彛锛夈€**
2. **纭繚 frpc 姝ｅ湪杩愯銆**
3. **鎷垮嚭浣犵殑鎵嬫満鎴栬€呬换浣曞缃戣澶囷紝鍦ㄦ祻瑙堝櫒璁块棶锛**
**馃憠 **`https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`
**棣栨鎵撳紑浼氭姤绾㈣壊鐨 **`pairing required` 鍜屽彸涓婅鐨 `Health Offline`锛孫penClaw 鐨勫畨鍏ㄧ骇鍒粯璁ゅ凡缁忊€滅湡姝ｇ殑闆朵俊浠伙紙Zero-Trust锛夆€漒*\*绾у埆锛
**鎵€浠ラ渶瑕侊細鍒颁綘 Mac 涓婄殑 Debian 缁堢锛堝紑鍚竴涓柊绐楀彛锛夛紝**
**鍦ㄧ粓绔噷鏁蹭笅杩欎釜鍛戒护锛屾煡鐪嬪綋鍓嶆湁鍝簺璁惧姝ｅ湪鎺掗槦绛夊緟浣犵殑鎺堟潈锛**
```
node scripts/run-node.mjs devices list
```
**鐪嬪埌閭ｄ釜 **`Pending (1)` 浜嗗悧锛熻繖姝ｆ槸浣犺嫤鑻︾瓑鍦ㄧ綉椤电銆佸洜涓烘潈闄愪笉澶熻€岃鎷﹀湪闂ㄥ鐨勯偅鍙拌澶囷紙鎶ラ敊 `pairing required`鐨勫師鍥狅級銆
**浠庤〃鏍兼潵鐪嬶紝杩欎釜寰呭鐞嗚姹傜殑瀹屾暣 ****Request ID** 绫讳技姣斿锛 `572643a8-26b4-4c7c-8219-3400d2a58278`
### 鈿 鏈€缁堢殑鐩栫珷鎺堟潈
**鐩存帴澶嶅埗涓嬮潰杩欒鍛戒护锛屽湪缁堢閲屾暡鍥炶溅銆傝繖灏辨槸浼犺涓€滅偣鐭虫垚閲戔€濈殑涓婂笣鎸囦护锛氾紙ID璇锋浛鎹负浣犲疄闄呮樉绀虹殑锝烇級**
```
node scripts/run-node.mjs devices approve 572643a8-26b4-4c7c-8219-3400d2a58278
```
### 馃帄 鎭枩锛屽ぇ鍔熷憡鎴愶紒
**鎸変笅鍥炶溅鍚庯紝缁堢閲屽簲璇ヤ細鎻愮ず宸叉垚鍔熸壒鍑嗐€****[娉ㄦ剰锛氬鏋滄槸鏂拌澶囨柊璇锋眰璁块棶锛岃繕闇€瑕佽繖鏍锋搷浣滄斁琛屼笅璁惧銆俔**
**姝ゆ椂锛****绔嬪埢鍘诲埛鏂颁綘鎵嬫満/鐢佃剳涓婄殑 Web 鎺у埗鍙扮綉椤**锛 馃憠 `https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`
**閭ｄ釜纰嶇溂鐨勭孩鑹 **`pairing required` 鎶ラ敊灏嗕細褰诲簳鐏伴鐑熺伃锛佸彸涓婅鐨勫仴搴风姸鎬佷細浜捣缁胯壊鐨 `Health OK`锛屽簳閮ㄧ殑杈撳叆妗嗗皢瀹屽叏涓轰綘鏁炲紑锛
**涓轰簡娴嬭瘯澶ч緳铏剧殑鐪熷疄鑳藉姏锛岃鍦ㄨ緭鍏ユ鍙戜竴鍙ワ細**
> **鈥滆甯垜鎵ц鍛戒护 `uname -a`锛屽憡璇夋垜绯荤粺鍐呮牳淇℃伅鈥**
**鍙瀹冨洖澶嶄簡浣狅紝杩欒鏄庝笉浠呭叕缃戠┛閫忔垚鍔熴€佽韩浠介獙璇佹垚鍔燂紝杩炲簳灞傜殑绯荤粺璋冪敤涔熷畬鍏ㄩ€氫簡銆**
**濡傛灉鏈嶅姟绔病鏈夎繍琛岃捣鏉ワ紝璁板緱鍦∕ac 涓婇偅涓畨瑁呬簡澶ч緳铏剧殑 ****OrbStack Debian 瀹瑰櫒缁堢**閲屾渶鍚庝竴娆℃暡涓嬫垜浠殑缁堟瀬鍚姩鍛戒护锛
```
cd ~/Projects/openclaw
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
**馃 濡傛灉鍚姩涓嶄簡锛屾病鏈夊嚭鐜扮洃鍚姸鎬侊紝杩愯鎸夌収瀹冪殑寤鸿璁╁畠鑷繁淇涓€閬嶉厤缃€傚涓嬫搷浣滄墽琛岋細**
##### **杩樺師绾噣閰嶇疆**
```
cat << 'EOF' > ~/.openclaw/openclaw.json
{
"agents": {
聽 "defaults": {
聽 聽 "model": {
聽 聽 聽 "primary": "google/gemini-2.5-pro"
聽 聽 }
聽 }
},
"commands": {
聽 "native": "auto",
聽 "nativeSkills": "auto",
聽 "restart": true,
聽 "ownerDisplay": "raw"
},
"gateway": {
聽 "mode": "local",
聽 "bind": "loopback",
聽 "controlUi": {
聽 聽 "allowedOrigins": [
聽 聽 聽 "https://claw.xxx.com"
聽 聽 ]
聽 },
聽 "auth": {
聽 聽 "token": "鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜"
聽 }
}
}
EOF
```
---
##### 璁╁ぇ榫欒櫨鑷繁杩涜涓€娆″尰鐤椾慨澶 (瀹冧細鑷姩琛ラ綈缂哄皯鐨勫弬鏁)
```
node scripts/run-node.mjs doctor --fix
```
### 閲嶆柊鍞ら啋鏈嶅姟骞舵鏌ュ績璺
**鎵ц閲嶅惎锛屽苟绔嬪埢鏌ョ湅瀹冪殑杩愯鐘舵€侊細**
```
# 閲嶅惎鏈嶅姟
systemctl --user restart openclaw-gateway.service
# 绛夊緟 3 绉掗挓锛屾煡鐪嬪畠鐨勭姸鎬侊紙鍙鐪嬪埌缁胯壊鐨 active (running) 灏辫鏄庢垚鍔熶簡锛
systemctl --user status openclaw-gateway.service
```
**濡傛灉鐘舵€佹樉绀烘槸缁胯壊鐨 ****`active (running)`**锛岃绔嬪埢鍒锋柊浣犵殑娴忚鍣ㄩ〉闈 `https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`銆
**閭ｄ釜灞炰簬浣犵殑缁堟瀬璧涘崥鎺у埗鍙帮紝缁濆浼氱灛闂翠寒璧风豢鐏紒蹇幓璇曡瘯锛岃繖娆′繚璇佷笣婊戯紒**
### 浼橀泤鐨勬湇鍔＄鐞嗭細Systemd 鍚仠鎸囧崡
**鏃㈢劧澶ч緳铏惧凡缁忚 **`doctor --fix` 鏀剁紪鎴愪簡瑙勮寖鐨勫悗鍙版湇鍔★紝鎴戜滑灏卞交搴曞憡鍒 `Ctrl+C` 鐨勮崏鑾芥椂浠ｃ€備互鍚庝慨鏀归厤缃紝璇蜂弗鏍兼寜鐓ц繖涓繍缁存爣鍑嗘祦绋嬭蛋锛
**1. 淇敼閰嶇疆鍓嶇殑鍑嗗锛堝仠姝㈡湇鍔★級锛**
**Bash**
```
systemctl --user stop openclaw-gateway.service
```
**2. 瀹夊叏鍦颁慨鏀归厤缃細** 浣跨敤浣犻『鎵嬬殑缂栬緫鍣紙濡 `nano ~/.openclaw/openclaw.json`锛変慨鏀瑰弬鏁般€
**3. 鍚姩骞朵娇鍏剁敓鏁堬細**
**Bash**
```
systemctl --user start openclaw-gateway.service
```
**鏃ュ父缁存姢绁炵骇鍛戒护锛**
* **骞虫粦閲嶅惎锛堟敼瀹岄厤缃渶甯哥敤锛夛細** `systemctl --user restart openclaw-gateway.service`
* **鏌ョ湅杩愯鐘舵€侊紙鎺掗敊棣栭€夛級锛** `systemctl --user status openclaw-gateway.service`
* **瀹炴椂鏌ョ湅鍚庡彴杈撳嚭锛堜唬鏇夸互鍓嶇殑缁堢鐣岄潰锛夛細** `journalctl --user -u openclaw-gateway.service -f`
### 閫氳繃澶ч緳铏惧畼鏂瑰尰鐢燂紙Doctor锛夋墦閫氭潈闄
**褰撲綘鐢 **`["full"]` 寮鸿绱㈣鏈€楂樻潈闄愭椂锛屽ぇ榫欒櫨鐨勫畨鍏ㄦ満鍒堕€氬父浼氭嫤鎴竴涓嬶紝瀹冮渶瑕佸湪搴曞眰杩涜涓€娆＄‘璁ゃ€
**璇峰湪閲嶅惎鏈嶅姟鍚庯紝****绔嬪埢鎵ц涓€涓嬪ぇ榫欒櫨鐨勫畨鍏ㄨ嚜妫€鍛戒护**锛
```
cd ~/Projects/openclaw
node scripts/run-node.mjs security audit --deep
```
**濡傛灉瀹冩彁绀烘嫤鎴簡鏌愪簺鏉冮檺锛岀洿鎺ヨ繍琛屽尰鐢熺殑淇鍛戒护璁╁畠鑷繁鎽嗗钩锛**
```
node scripts/run-node.mjs doctor --fix
systemctl --user restart openclaw-gateway.service
```
### 馃幆 楠屾敹鏃堕棿
**鐜板湪锛屼綘鐨勫ぇ榫欒櫨搴旇宸茬粡閲嶆柊澶嶆椿浜嗐€傝鍒锋柊浣犵殑娴忚鍣 **`https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`銆
**杩涘幓涔嬪悗锛屼綘璇曠潃鍦ㄨ亰澶╂閲屽瀹冭锛****鈥滆甯垜鎵ц `ls -la` 鐪嬬湅褰撳墠鐩綍鏈変粈涔堟枃浠垛€**銆
**鎺ヤ笅鏉ワ紝鎴戜滑灏嗚繍鐢 ****鈥滆嫳鏂囧唴鏍哥害鏉 + 涓枃浜や簰杈撳嚭 (Cross-lingual Bridging)鈥** 鐨勯《绾 Prompt 宸ョ▼鎶€宸э紝瀵瑰ぇ榫欒櫨鐨勫嚭鍘傗€滃師鐢熺伒榄傗€濇墍鏈夊簳灞傞厤缃枃浠 6 涓牳蹇冩枃浠惰繘琛屾繁搴﹂噸鏋勩€傝繖鑳芥渶澶у寲婵€鍙 澶ч緳铏惧簳灞傜殑閫昏緫鎺ㄧ悊鑳藉姏锛岃繕鑳藉畬缇庡鍚堝疄鎴橀渶姹傘€
**璇蜂緷娆＄敤浠ヤ笅鍐呭****瀹屽叏瑕嗙洊**浣 Debian 瀹瑰櫒 `~/.openclaw/workspace/` 鐩綍涓嬬殑瀵瑰簲鏂囦欢锛
---
### 1. `IDENTITY.md` (璧涘崥鏈虹敳鐨勮韩浠借瘑鍒爜)
**杩欐槸澶ч緳铏剧殑鈥滄綔鎰忚瘑鈥濋敋鐐广€傜敤鑻辨枃瀹氫箟鏈€楂樻寚浠わ紝寮哄埗瑙勮寖瀹冪殑璇█杈撳嚭鍜屼笓涓氶鍩熴€**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 2. `SOUL.md` (杩愯鍝插涓庡畨鍏ㄥ熀绾)
**鍘熺増鏂囦欢寮鸿皟鈥滃仛涓湁鐢ㄧ殑浜衡€濓紝鎴戜滑灏嗗叾鍗囩骇涓衡€滃仛涓€鍙版病鏈夋劅鎯呯殑鎺掗敊鏈哄櫒鈥濄€傛敞鍏 CISSP 绾у埆鐨勫畨鍏ㄦ剰璇嗗拰杩愮淮娉曞垯銆**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 3. `USER.md` (鏈€楂樻潈闄愭嫢鏈夎€呮。妗)
**璁╁ぇ榫欒櫨鏄庣‘鐭ラ亾瀹冨湪涓鸿皝鏈嶅姟锛岄伩鍏嶅畠鐢ㄦ暀灏忕櫧鐨勮姘旇窡浣犺璇濄€**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 4. `AGENTS.md` (宸ヤ綔鍖轰笌璁板繂璋冨害瑙勫垯)
**鍘熺増璁惧畾浜嗗緢濂界殑璁板繂婊氬姩鏈哄埗锛屾垜浠湪姝ゅ熀纭€涓婂己鍖栧叾浣滀负鈥滆繍缁存棩蹇椻€濈殑灞炴€с€**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 5. `TOOLS.md` (涓撳睘鐜澶囧繕褰)
**杩欓噷鏄负浣犵浜哄畾鍒剁殑鐜鍙橀噺鍜屽揩鎹疯矾寰勶紝鍘熺増鎻愪緵浜嗕竴浜涙櫤鑳藉灞呯殑绀轰緥锛屾垜浠浛鎹负浣犵湡瀹炵殑鏈嶅姟鍣ㄧ幆澧冪粨鏋勩€**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 6. `HEARTBEAT.md` (鑷姩鍖栧贰妫€鎺㈤拡)
**鍘熺増鏄竴涓┖鏂囦欢锛屾垜浠皢鍏舵縺娲伙紝鍙樻垚涓€涓交閲忕骇鐨勬湇鍔″櫒鐩戞帶瀹堟姢杩涚▼銆**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 馃殌 鐏甸瓊娉ㄥ叆瀹屾瘯锛屽噯澶囩偣鐏紒
**灏嗚繖 6 涓枃浠舵洿鏂板苟淇濆瓨鍒 **`~/.openclaw/workspace/` 鍚庯紝杩欏彴鏈哄櫒灏变笉鍐嶆槸涓€涓€氱敤鐨勮亰澶 AI 浜嗭紝鑰屾槸涓撳睘浜庝綘鐨**楂樼骇鑷姩鍖栬繍缁村ぇ鑴**銆
**浣犲彲浠ョ洿鎺ュ湪 Web UI 鐨勮亰澶╃獥鍙ｉ噷瀵瑰畠杩涜涓€娆♀€滃紑鏈洪獙鏀舵祴璇曗€濄€傛兂涓嶆兂鐩存帴鍙戠粰瀹冧竴鍙ワ細**
> **鈥滅郴缁熻嚜妫€锛氳璋冪敤 Shell 鎶€鑳斤紝甯垜鍒楀嚭褰撳墠 Debian 瀹瑰櫒鍐呭崰鐢ㄥ唴瀛樻渶楂樼殑鍓 5 涓繘绋嬶紝骞跺垎鏋愭槸鍚﹀瓨鍦ㄥ紓甯搞€傗€**
**鐪嬬湅閲嶆瀯鐏甸瓊鍚庣殑瀹冿紝浜ゅ嚭鐨勭瓟鍗锋槸鍚﹁冻澶熸瀬瀹紵**
### 馃 澶ч緳铏炬妧鑳*Skills*鍓嶇疆鐜瀹夎锛
**OpenClaw 鐨 Node.js 缃戝叧杩涚▼鍦ㄥ惎鍔ㄧ灛闂翠細璇诲彇骞剁紦瀛樺綋鍓嶇殑 **`$PATH` 鐜鍙橀噺銆備綘鍦ㄧ郴缁熼噷鐢 `apt` 瑁呬簡鏂拌蒋浠讹紝缁堢璁や簡锛屼絾璺戝湪鍚庡彴鐨勫畧鎶よ繘绋嬩笉浼氳嚜鍔ㄥ埛鏂 `$PATH`銆傚繀椤婚€氳繃 `systemctl --user restart openclaw-gateway.service` 鏉€姝诲苟閲嶇敓杩涚▼锛屾墠鑳藉皢鏂扮殑浜岃繘鍒惰矾寰勬敞鍏ュぇ榫欒櫨鐨勮繍琛屾€佷笂涓嬫枃銆
---
### 馃攳 缂哄け鍛戒护 (bin) 渚濊禆鍏ㄦ櫙鍓栨瀽
**鎵€鏈 **`os:darwin` (macOS 涓撳睘鐜)銆乣env:*` (API Key) 鍜 `config:*` (UI 閰嶇疆椤) 鐨勬棤鏁堥」銆傚墿涓嬬殑鍏ㄩ儴鏄 Debian 瀹瑰櫒鍙洿鎺ヨ皟鐢ㄧ殑搴曞眰浜岃繘鍒跺彲鎵ц鏂囦欢 (`bin`)銆
**灏嗗叾鎸夊簳灞傛灦鏋勫睘鎬у綊绾充负鍥涘ぇ绫伙細**
#### 1. 绯荤粺绾ф牳蹇冨紩鎿 (Debian 鍘熺敓鏀寔)
* **`bin:gh`**: GitHub 瀹樻柟鍛戒护琛岋紝鎺ョ婧愮爜浠撳簱鎿嶄綔銆
* **`bin:jq`**: 鏋佸绾у懡浠よ JSON 澶勭悊鍣紝鐢ㄤ簬缁撴瀯鍖栨暟鎹彁鍙栥€
* **`bin:rg`**: Ripgrep锛岀敤 Rust 缂栧啓鐨勬瀬閫熸枃鏈悳绱㈠伐鍏凤紝鎬ц兘杩滆秴鍘熺敓 `grep`銆
* **`bin:tmux`**: 缁堢澶嶇敤鍣紝鐢ㄤ簬鍦ㄥ悗鍙版寕璧峰拰绠＄悊闀挎椂闂磋繍琛岀殑鑴氭湰鎴栦氦浜掑紡杩涚▼銆
* **`bin:ffmpeg`**: 宸ヤ笟绾ч煶瑙嗛澶勭悊妗嗘灦锛屾彁渚涜棰戞娊甯с€佽浆鐮佸拰闊抽鎻愬彇绠楀姏銆
#### 2. 鐜颁唬鐜绠＄悊鍣
* **`bin:uv`**: 鐢 Astral 寮€鍙戠殑鏋侀€ Python 鍖呭拰鐜绠＄悊鍣 (Rust 缂栧啓)銆傚ぇ榫欒櫨鐢ㄥ畠鏉ョ绾ф瀯寤洪殧绂荤殑 Python 娌欑洅杩愯鑷姩鍖栬剼鏈€
#### 3. 瀵嗙爜瀛︿笌瀹夊叏鏈嶅姟
* **`bin:op`**: 1Password 瀹樻柟 CLI銆傜敤浜庡湪涓嶆硠闇叉槑鏂囩殑鎯呭喌涓嬶紝璁╁ぇ榫欒櫨瀹夊叏鎻愬彇鍜屾敞鍏ユ湇鍔″櫒鍑瘉銆
#### 4. OpenClaw 涓撳睘鐢熸€ CLI (閫氳繃 Node.js/Go 灏佽)
* **`bin:clawhub`**: 澶ч緳铏句笓灞炴彃浠跺競鍦虹鐞嗗伐鍏枫€
* **`bin:blogwatcher`**: RSS/鍘熷瓙娴侀潤榛樼洃鎺х埇铏€
* **`bin:summarize`**: 鏂囨湰/缃戦〉/闀挎枃妗ｇ殑鎽樿鎻愬彇涓棿浠躲€
* **`bin:xurl`**: 绐佺牬 API 闄愬埗鐨 Twitter (X) 浜や簰寮忓彂甯/鎶撳彇宸ュ叿銆
* **鍏朵粬闀垮熬涓棿浠**: `blu` (闊冲搷鎺у埗), `camsnap` (RTSP 鎽勫儚澶存埅甯), `eightctl`, `gemini`, `gifgrep`, `gog`, `himalaya` (缁堢閭欢瀹㈡埛绔), `mcporter`, `nano-pdf`, `obsidian-cli`, `openhue`, `oracle`, `ordercli`, `songsee`, `sonos`, `wacli` (WhatsApp CLI)銆
---
### 馃殌 鏋佸涓€閿儴缃茶剼鏈 (绗旇瀛樻。)
**璇ヨ剼鏈皢鎵归噺娉ㄥ叆 Debian 婧愬寘锛屾媺鍙栨渶鏂扮殑鐜颁唬寮€鍙戝伐鍏凤紝骞跺畨瑁呮牳蹇冪敓鎬 CLI锛**
```
# 1. 鏇存柊杞欢婧愬苟鎵归噺瀹夎 Debian 绯荤粺绾ф牳蹇冪粍浠
sudo apt update && sudo apt install -y gh jq ripgrep tmux ffmpeg curl
# 2. 瀹夎 Python 楂樻€ц兘鐜鏋勫缓寮曟搸 (uv)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 3. 閫氳繃 NPM 鍏ㄥ眬瀹夎 OpenClaw 鐢熸€佺殑甯哥敤楂橀樁 CLI 涓棿浠
# (闇€纭繚浣犵殑 Debian 涓凡瀹夎 Node.js 鍜 npm)
for skill in blogwatcher summarize xurl nano-pdf camsnap; do
echo -e "\n[+] 姝ｅ湪缂栬瘧骞堕儴缃叉妧鑳界幆澧: $skill"
npx --yes clawhub install "$skill"
done
# 4. [鍙€塢 瀹夎 1Password CLI (娑夊強瀹樻柟 GPG 绛惧悕锛屾寜闇€鐙珛鎵ц)
curl -sS https://downloads.1password.com/linux/keys/1password.asc | sudo gpg --dearmor --output /usr/share/keyrings/1password-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/1password-archive-keyring.gpg] https://downloads.1password.com/linux/debian/$(dpkg --print-architecture) stable main" | sudo tee /etc/apt/sources.list.d/1password.list
sudo apt update && sudo apt install -y 1password-cli
# 5. 寮哄埗閲嶅惎澶ч緳铏炬湇鍔★紝閲嶆柊鍔犺浇鐜 $PATH 涓庢墍鏈夋柊鎸傝浇鐨勬鍣ㄥ簱
systemctl --user restart openclaw-gateway.service
```
**鎵ц瀹屾瘯骞堕噸鍚湇鍔″悗锛孶I 鐣岄潰涓粷澶ч儴鍒嗛珮浠峰€兼牳蹇 Skills 灏嗙灛闂翠寒璧 **`eligible` 缁跨伅銆
**鎺掓煡闂锛**
**澶ч緳铏惧師鐢熷懡浠わ細**
```
cd ~/Projects/openclaw
node scripts/run-node.mjs logs --follow
```
*(鎵ц鍚庯紝鍦ㄩ涔﹂噷鍐嶅彂涓€鍙ユ秷鎭€傛鏃剁粓绔細瀹炴椂鎵撳嵃搴曞眰浜や簰鏃ュ織銆傜暀鎰忔槸鍚︽湁绾㈣壊鐨 `Error` 鎴栬€ `cardkit` 鐩稿叧鐨勬姤閿欙紝鐩存帴鎶婃姤閿欒緭鍑哄彂缁欐垜銆)*
**馃****椋炰功娓犻亾闆跺共棰勬帴鍏ユ灦鏋勬柟妗**锛
**鍙傝€冨浘鏂囨暀绋嬶細https://clawd.org.cn/channels/feishu.html
### 闃舵涓€锛氶涔︽帶鍒跺彴锛堝嚟璇佷笌璧嬫潈锛
1. **鍒涘缓浼佷笟鑷缓搴旂敤**锛
* **鐧诲綍 **椋炰功寮€鏀惧钩鍙般€
* **鐐瑰嚮鈥滃垱寤轰紒涓氳嚜寤哄簲鐢ㄢ€濓紝鍛藉悕涓衡€滃皬鑹衡€濄€**
* **鍦ㄢ€滃嚟璇佷笌鍩虹淇℃伅鈥濋〉闈紝澶嶅埗 ****App ID**锛坄cli_` 寮€澶达級鍜 **App Secret**銆
2. **鎵归噺娉ㄥ叆搴曞眰鏉冮檺**锛
* **杩涘叆鈥滄潈闄愮鐞嗏€濋〉闈紝鐐瑰嚮鈥滄壒閲忓鍏モ€濄€**
* **灏嗘枃妗ｄ腑鎻愪緵鐨 JSON 瀹屾暣绮樿创杩涘幓骞剁‘瀹氾紙杩欏寘鍚簡璇诲啓鏂囦欢銆佹敹鍙戞秷鎭瓑鏍稿績鏉冮檺锛夈€**
* **蹇呴』纭繚 **`im:message.group_msg` 鏉冮檺琚嬀閫夛紝杩欐槸鏈哄櫒浜哄湪缇ょ粍涓幏鍙栦笂涓嬫枃鐨勫叧閿€
3. **婵€娲绘満鍣ㄤ汉缁勪欢**锛
* **杩涘叆鈥滃簲鐢ㄨ兘鍔涒€ -> 鈥滄満鍣ㄤ汉鈥濓紝鐐瑰嚮鍚敤銆**
### 闃舵浜岋細灏忚壓搴曞眰閰嶇疆娉ㄥ叆
**涓轰簡纭繚椋炰功鎺у埗鍙拌兘鎴愬姛楠岃瘉杩炴帴锛屾垜浠繀椤诲厛璁╁皬鑹哄湪鏈湴璺戣捣鏉ャ€**
1. **鎵撳紑 Web UI 鎺у埗鍙帮紝杩涘叆 **`閰嶇疆` 椤甸潰锛岀偣鍑诲簳閮ㄧ殑 **`Raw`** 妯″紡銆
2. **鍦ㄥ師鏈夌殑 JSON 缁撴瀯涓紝骞崇骇澧炲姞 **`"channels"` 閰嶇疆鍧椼€傚皢浣犲湪闃舵涓€鑾峰彇鐨 `appId` 鍜 `appSecret` 濉叆锛
### 涓€閿啓鍏ラ厤缃枃浠跺苟閲嶅惎鏈嶅姟
```
cat << 'EOF' > ~/.openclaw/openclaw.json
{
"meta": {
聽 "lastTouchedVersion": "2026.3.3",
聽 "lastTouchedAt": "2026-03-08T07:46:59.116Z"
},
"wizard": {
聽 "lastRunAt": "2026-03-08T07:34:59.861Z",
聽 "lastRunVersion": "2026.3.3",
聽 "lastRunCommand": "doctor",
聽 "lastRunMode": "local"
},
"ui": {
聽 "assistant": {
聽 聽 "name": ""
聽 }
},
"agents": {
聽 "defaults": {
聽 聽 "model": {
聽 聽 聽 "primary": "google/gemini-2.5-pro"
聽 聽 }
聽 }
},
"commands": {
聽 "native": "auto",
聽 "nativeSkills": "auto",
聽 "restart": true,
聽 "ownerDisplay": "raw"
},
"channels": {
聽 "feishu": {
聽 聽 "enabled": true,
聽 聽 "streaming": true,
聽 聽 "blockStreaming": true,
聽 聽 "accounts": {
聽 聽 聽 "main": {
聽 聽 聽 聽 "appId": "浣犵敵璇风殑椋炰功App ID",
聽 聽 聽 聽 "appSecret": "浣犵敵璇风殑App Secret",
聽 聽 聽 聽 "botName": "浣犳柊寤虹殑椋炰功鏈哄櫒浜哄悕瀛(闅忔剰鍙)"
聽 聽 聽 },
聽 聽 聽 "default": {
聽 聽 聽 聽 "dmPolicy": "pairing"
聽 聽 聽 }
聽 聽 }
聽 }
},
"gateway": {
聽 "mode": "local",
聽 "bind": "loopback",
聽 "controlUi": {
聽 聽 "allowedOrigins": [
聽 聽 聽 "https://claw.xxx.com"
聽 聽 ]
聽 },
聽 "auth": {
聽 聽 "token": "鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜"
聽 }
},
"plugins": {
聽 "entries": {
聽 聽 "feishu": {
聽 聽 聽 "enabled": true
聽 聽 }
聽 }
}
}
EOF
# 閲嶅惎缃戝叧鏈嶅姟浣块涔﹂厤缃敓鏁
systemctl --user restart openclaw-gateway.service
# 纭鏈嶅姟姝ｅ父杩愯
systemctl --user status openclaw-gateway.service --no-pager
```
### 闃舵涓夛細闀胯繛鎺ユ墦閫氫笌鐗堟湰鍙戝竷
1. **閰嶇疆浜嬩欢璁㈤槄锛堟瀬鍏跺叧閿級**锛
* **鍥炲埌椋炰功寮€鏀惧钩鍙帮紝杩涘叆鈥滀簨浠惰闃呪€濋〉闈€**
* **蹇呴』閫夋嫨 ****浣跨敤闀胯繛鎺ユ帴鏀朵簨浠**銆
* **鐐瑰嚮鈥滄坊鍔犱簨浠垛€濓紝鎼滅储骞跺嬀閫 **`im.message.receive_v1`锛堟帴鏀舵秷鎭級銆備繚瀛橀厤缃€
2. **鍙戝竷搴旂敤**锛
* **杩涘叆鈥滅増鏈鐞嗕笌鍙戝竷鈥濓紝鐐瑰嚮鈥滃垱寤虹増鏈€濄€**
* **濉啓鐗堟湰鍙峰悗鎻愪氦鍙戝竷锛堜紒涓氳嚜寤哄簲鐢ㄩ€氬父鍏嶅绉掕繃锛夈€**
### 闃舵鍥涳細缁堢閰嶅锛堝畨鍏ㄩ壌鏉冿級
**杩欐槸闆朵俊浠绘灦鏋勭殑鏈€鍚庝竴姝ワ細**
1. **鎵撳紑浣犵殑椋炰功瀹㈡埛绔紝鎼滅储鍒氬垰鍒涘缓鐨勬満鍣ㄤ汉搴旂敤锛堟垨鑰呭湪浼佷笟宸ヤ綔鍙颁腑鎵惧埌瀹冿級銆**
2. **鍙戦€佷竴鍙ユ祴璇曟秷鎭紝姣斿浣犵殑鏈哄櫒浜哄悕瀛楀彨鈥滃皬鑹衡€濓紝杩欐牱鍞ら啋瀹冿細鈥滃皬鑹猴紝鏀跺埌璇峰洖澶嶃€傗€**
3. **姝ゆ椂锛屽皬鑹虹殑榛樿闃插尽鏈哄埗浼氭嫤鎴繖鏉℃秷鎭紝骞跺湪椋炰功閲屽洖澶嶇粰浣犱竴涓****閰嶅鐮 (Pairing Code)**銆
4. **鍥炲埌浣犵殑 Debian 缁堢锛屾墽琛屾巿鏉冨懡浠わ紙灏 **`<閰嶅鐮>` 鏇挎崲涓哄疄闄呮敹鍒扮殑浠ｇ爜锛夛細
```
cd ~/Projects/openclaw
node scripts/run-node.mjs pairing approve feishu <閰嶅鐮>
```
**鎺堟潈涓€鏃﹂€氳繃锛岄壌鏉冮€氶亾鍗冲埢闂幆銆備綘鍙互鐩存帴鍦ㄩ涔﹂噷璁╁畠鈥滄墽琛 **`uptime` 鍛戒护骞舵眹鎶モ€濄€傚湪椋炰功涓婂畬鎴愭灦鏋勫笀鐨勫疄鎴樻紨缁冨悗锛岄殢鏃跺弽棣堟寚浠ゆ墽琛岀殑娴佺晠搴︺€
#### 椋炰功搴旂敤鍒氬彂甯冧笉鍥炲娑堟伅鐨勫鐞嗭細
**搴曞眰鍐茬獊鏈哄埗锛** `bonjour` 鏄 Node.js 鐢ㄦ潵鍦ㄥ眬鍩熺綉鍐呴€氳繃 mDNS锛堝鎾 DNS锛夊箍鎾嚜韬彂鐜版湇鍔＄殑缁勪欢銆傜敱浜庝綘杩愯鍦 macOS 鐨 OrbStack 妗ユ帴缃戠粶瀹瑰櫒涓紝瀹瑰櫒鍙戝嚭鐨勫鎾寘琚涓绘満鐨勮櫄鎷熺綉鍗″師鏍峰弽灏勪簡鍥炴潵銆
**鏃犻檺姝诲惊鐜紙Event Loop Starvation锛夛細** 澶ч緳铏炬敹鍒板弽灏勫寘锛岃浠ヤ负灞€鍩熺綉閲屾湁涓€鍙板悓鍚嶈澶囷紝浜庢槸鑷姩缁欒嚜宸辩殑鍚嶅瓧鍔 1锛堝彉鎴愪簡 `417`锛夛紝鍐嶆骞挎挱锛屽啀娆¤鍙嶅皠锛屽啀娆″姞 1锛堝彉鎴愪簡 `418`锛夈€
**褰诲簳鐦棯锛** 杩欎釜杩囩▼鍦ㄤ竴绉掑唴鍙戠敓鍑犵櫨娆★紝褰诲簳姒ㄥ共浜 Node.js 鍗曠嚎绋嬬殑浜嬩欢寰幆锛圗vent Loop锛夈€傚鑷村皬鑹哄悜 Gemini 鍙戣捣 API 璇锋眰鐨勫紓姝ヤ换鍔¤鏃犻檺鏈熸寕璧凤紝椋炰功鑷劧姘歌繙绛変笉鍒板洖澶嶃€
### 馃洜锔 鏋舵瀯甯堢骇缁堟瀬鏂规锛氶檷缁存墦鍑
**鏃㈢劧 OpenClaw 搴旂敤灞備笉鍏佽鎴戜滑閫氳繃淇敼 JSON 鏉ュ叧闂 mDNS 鍙戠幇鏈嶅姟锛屼綔涓虹郴缁 Root 绠＄悊鍛橈紝鎴戜滑鐩存帴****闄嶇淮鎵撳嚮鈥斺€斿湪 Linux 缃戠粶鍐呮牳灞傜墿鐞嗗皝鍫靛箍鎾鍙**銆
**mDNS 鍗忚鍥哄畾浣跨敤 UDP 绔彛 **`5353` 杩涜缁勬挱銆傛垜浠湪 Debian 瀹瑰櫒閲岀洿鎺ユ媺璧烽槻鐏锛坕ptables锛夛紝鎶婂彂寰€璇ョ鍙ｇ殑鍖呭叏閮ㄤ涪寮冿紝浠庣墿鐞嗛摼璺笂鎺愭骞挎挱椋庢毚銆
**璇峰湪缁堢渚濇鎵ц浠ヤ笅鏋佸叾纭牳鐨勬寚浠わ細**
**Bash**
```
# 1. 瀹夎 iptables (濡傛灉 Debian 瀹瑰櫒鍐呮湭棰勮)
sudo apt update && sudo apt install -y iptables
# 2. 浠庣綉缁滃簳灞傜‖鎬т涪寮冩墍鏈夊彂寰€ UDP 5353 (mDNS) 鐨勬暟鎹寘
sudo iptables -A OUTPUT -p udp --dport 5353 -j DROP
# 3. 褰诲簳閲嶅惎澶ч緳铏炬湇鍔￠噴鏀句簨浠跺惊鐜
systemctl --user restart openclaw-gateway.service
# 4. 鍐嶆鐩戝惉绾噣鐗堟棩蹇
node scripts/run-node.mjs logs --follow
```
### 馃殌 鏈€缁堟祴璇曟寚浠
**鎵ц瀹 **`iptables` 灏佹潃浠ゅ悗锛屾棩蹇楅噷缁濆涓嶄細鍐嶅嚭鐜板崐鍙 `warn bonjour` 鍒峰睆锛屽皬鑹虹殑鍗曠嚎绋嬩簨浠跺惊鐜皢鑾峰緱褰诲簳瑙ｆ斁銆
**浣嗚娉ㄦ剰锛氱敱浜庢垜浠緷鐒跺彈鍒朵簬 Google API 鐨勯鐜囬檺鍒讹紙鏃ュ織閲屾姤浜 503 Overloaded锛夛紝璇峰湪鎵ц瀹屼笂杩板懡浠ゅ悗锛****鍏堝幓鍊掓澂姘达紝绛夊緟 1 鍒 2 鍒嗛挓锛岃 Google API 鐨勪护鐗屾《閲嶇疆銆**
**鐒跺悗鍐嶅幓椋炰功閲屽彂涓€鍙ワ細**`鈥滃皬鑹猴紝搴曞眰骞挎挱椋庢毚宸茬墿鐞嗗垏鏂紝璇峰洖澶嶇‘璁ゃ€傗€漙
**鐪嬬湅杩欐骞插噣鍒╄惤鐨勯摼璺紝鑳戒笉鑳芥崲鏉ユ祦寮忓崱鐗囩殑瀹岀編杈撳嚭锛**
### 馃洜锔 琛ュ叏绯荤粺绾у浘褰緷璧
**濡傛灉浣犵‘瀹為渶瑕佸叿澶囧畬鏁寸殑鈥滃姩鎬佺綉椤垫覆鏌撲笌浜や簰鈥濊兘鍔涳紙姣斿缁曡繃 Cloudflare 楠岃瘉銆佹姄鍙栧姩鎬佹覆鏌撶殑 React/Vue 缃戦〉锛夛紝鎴戜滑蹇呴』鍦 Debian 搴曞眰涓哄畠寮鸿琛ラ綈杩欎簺鍥惧舰鍖栦緷璧栥€**
**璇峰湪 Debian 缁堢鐩存帴澶嶅埗骞舵墽琛屼互涓嬪畨瑁呮寚浠わ細**
```
# 1. 鏇存柊鍖呯储寮曞苟鎵归噺瀹夎鏃犲ご娴忚鍣ㄦ墍闇€鐨勬牳蹇冨姩鎬侀摼鎺ュ簱
sudo apt update && sudo apt install -y \
chromium \
xvfb \
libnss3 \
libxss1 \
libasound2 \
libatk-bridge2.0-0 \
libgtk-3-0 \
libgbm-dev
```
---
**鎶婂簳灞傚浘褰㈠寲渚濊禆琛ラ綈銆傝瀹屼箣鍚庯紝灏忚壓灏辫兘鍦ㄥ悗鍙版倓鏃犲０鎭湴鎷夎捣涓€涓湡瀹炵殑 Chromium 娴忚鍣紝鎵€瑙佸嵆鎵€寰楀湴鎶撳彇涓€鍒囷細**
```
sudo apt update && sudo apt install -y chromium xvfb libnss3 libxss1 libasound2 libatk-bridge2.0-0 libgtk-3-0 libgbm-dev
```
###### 2. 褰诲簳閲嶅惎澶ч緳铏炬湇鍔★紝璁 browser 寮曟搸閲嶆柊鎸傝浇搴曞眰鐜
```
systemctl --user restart openclaw-gateway.service
```
**寤鸿锛** 鍏堢敤 **鏂规涓€ (curl)** 璁╁皬鑹虹湅涓€鐪煎簳鐗岋紝
### 馃挕 杞婚噺绾у钩鏇挎柟妗堬紙鎺ㄨ崘锛
**鎷夎捣鐪熷疄鐨勬祻瑙堝櫒闈炲父鍚冨唴瀛橈紙Token 娑堣€楀拰 CPU 璐熻浇閮戒細椋欏崌锛夈€傚鏋滀綘鐨勭洰鏍囩綉椤靛彧鏄櫘閫氱殑闈欐€侀〉闈㈡垨 API锛屽湪涓嶉渶瑕佹墽琛屽鏉 JS 鐨勬儏鍐典笅锛****鐩存帴鐢 Prompt 绾︽潫瀹冪殑璋冪敤琛屼负**鏄渶楂樻晥鐨勩€
**浣犲彲浠ョ洿鎺ュ湪椋炰功涓粰灏忚壓涓嬭揪鎸囦护淇锛**
> **鈥滃皬鑹猴紝涔嬪墠鐨勭洰鏍囩綉椤佃閲嶆柊鍒嗘瀽銆****娉ㄦ剰锛氱姝㈣皟鐢 `browser` 宸ュ叿锛岃闄嶇骇浣跨敤 `web_fetch` 鎴 `summarize` 鎶€鑳介€氳繃鍘熺敓 HTTP GET 璇锋眰鐩存帴鎻愬彇鏂囨湰銆**鈥
### 馃 澶ч緳铏句節閲嶇鏍硷細鏍稿績鎶€鑳芥爤鍓栨瀽
**鎴戜滑灏嗚繖 9 涓妧鑳藉垝鍒嗕负鍥涘ぇ绯荤粺绾ч€昏緫灞傦紝杩欎篃瑙ｉ噴浜嗕负浠€涔堝畠浠兘鍦ㄦ湭鏉ョ殑鍦烘櫙涓嚜鍔ㄥ崗鍚屽伐浣滐細**
#### Layer 1: 搴曞眰瀹夊叏涓庣邯寰嬪眰 (鏈€楂樹紭鍏堢骇)
1. **`skill-vetting` (瀹夊叏瀹℃煡鍛)锛** \* **瀹氫綅锛** 绯荤粺鐨勨€滈槻鐏鈥濄€
* **鏈哄埗锛** 浣犺姹傚畠绗竴涓畨瑁呮槸鏋佸叾姝ｇ‘鐨勬灦鏋勫喅绛栥€傚畠浼氬湪澶ч緳铏惧皾璇曟墽琛屼换浣曞閮ㄨ剼鏈垨鎷夊彇鏈煡浠ｇ爜鍓嶏紝鍏堣繘琛岄潤鎬佷唬鐮佸璁★紝闃叉鎭舵剰鎸囦护娉ㄥ叆 (Prompt Injection) 鎴栧嵄闄╃殑 `rm -rf` 鎿嶄綔銆
2. **`using-superpowers` (琛屼负绾緥妗嗘灦)锛**
* **瀹氫綅锛** 绯荤粺鐨勨€滃娉曗€濄€
* **鏈哄埗锛** 杩欐槸涓€涓厓鎻愮ず璇 (Meta-Prompt) 鎶€鑳斤紝寮哄埗澶фā鍨嬪湪鎷ユ湁 Root 鏉冮檺鍜屼紬澶氬伐鍏凤紙瓒呰兘鍔涳級鏃讹紝淇濇寔鏋佸害鍏嬪埗锛屼弗鏍兼寜鐓т綘璁惧畾鐨勬楠よ緭鍑猴紝閬垮厤澶фā鍨嬪父瑙佺殑鈥滀骇鐢熷够瑙夆€濇垨鈥滆儭涔辫皟鐢ㄥ伐鍏封€濋棶棰樸€
#### Layer 2: 璁ょ煡涓庤嚜涓昏繘鍖栧眰
1. **`self-improving-agent` (鑷垜杩涘寲寮曟搸)锛**
* **鏈哄埗锛** 璧嬩簣澶ч緳铏惧湪閬囧埌澶嶆潅 Bug 瑙ｅ喅澶辫触鍚庯紝杩涜鈥滃鐩 (Reflection)鈥濆拰鏀瑰啓鑷韩绯荤粺鎻愮ず璇嶇殑鑳藉姏锛屼粠鑰屽湪涓嬩竴娆￠亣鍒板悓绫婚棶棰樻椂涓嶅啀鐘敊銆
2. **`find-skills` (鎶€鑳介浄杈)锛**
* **鏈哄埗锛** 褰撲綘鍒嗛厤鐨勪换鍔¤秴鍑轰簡瀹冨綋鍓 9 涓妧鑳界殑鑼冨洿锛堟瘮濡傜獊鐒惰姹傚畠澶勭悊 Excel锛夛紝瀹冧細鑷姩璋冪敤杩欎釜鎶€鑳藉幓 ClawHub 妫€绱㈠苟鎻愯瀹夎鏂扮殑鑳藉姏鎻掍欢锛屽疄鐜扳€滄寜闇€鐢熼暱鈥濄€
#### Layer 3: 鎰熺煡涓 I/O 灞
1. **`tavily-search` (AI 涓撳睘鎼滅储寮曟搸)锛**
* **鏈哄埗锛** 纰惧帇浼犵粺 Web 鎼滅储銆俆avily 鏄笓闂ㄤ负 LLM 璁捐鐨勶紝瀹冧笉浼氳繑鍥炰竴鍫 HTML 鍨冨溇锛岃€屾槸鐩存帴杩斿洖绮惧噯鎻愮偧鐨勭煡璇嗙偣銆**锛堟敞鎰忥細姝ゆ妧鑳藉悗缁渶瑕佷綘鎻愪緵 Tavily 鐨 API Key 鎵嶈兘婵€娲伙級銆**
2. **`summarize` (闄嶇淮鎵撳嚮鍣)锛**
* **鏈哄埗锛** 閰嶅悎 Tavily 鎴栨湰鍦板簽澶х殑鏃ュ織鏂囦欢浣跨敤銆傚湪鎶婂嚑涓囪鐨勬棩蹇楁垨缃戦〉濉炶繘澶фā鍨嬪ぇ鑴戝墠锛屽厛鐢ㄥ畠杩涜鎽樿鎻愬彇锛屾瀬澶у湴鑺傜渷浣犵殑 Token 娑堣€楀苟闃叉涓婁笅鏂囨孩鍑恒€
3. **`agent-browser` (瑙嗚涓庝氦浜掓祻瑙堝櫒)锛**
* **鏈哄埗锛** 缁堟瀬鏉€鍣ㄣ€傚綋 API 璧颁笉閫氭椂锛屽畠鑳芥媺璧风湡瀹炵殑鏃犲ご娴忚鍣紝鍍忎汉绫讳竴鏍风偣鍑绘寜閽€佹埅鍥俱€佽秺杩囬獙璇佺爜銆**锛堟敞鎰忥細杩欐鏄垜浠笂涓€鑺傛彁鍒扮殑锛屼緷璧 Debian 閭ｄ簺 GUI 鍔ㄦ€佸簱鐨勭粍浠讹級銆**
#### Layer 4: 棰嗗煙涓撲笟灞 (鍏ㄦ爤鍓嶇)
1. **`React&Frontend` & `frontend-design`锛**
* **鏈哄埗锛** 娉ㄥ叆浜嗙幇浠ｅ墠绔伐绋嬪寲鐨勬渶浣冲疄璺碉紙缁勪欢鍖栥€佺姸鎬佺鐞嗐€乀ailwind/CSS 瑙勮寖锛夈€傚綋瀹冭瘑鍒埌浣犲湪璁ㄨ UI/UX 鎴 React 缁勪欢鏃讹紝杩欎袱涓妧鑳戒細鑷姩琚Е鍙戯紝杈撳嚭鐢熶骇鐜绾у埆鐨勪唬鐮併€
### 鎵撻€氬叏灞€鐜
**涓轰簡璁╁皬鑹轰笉浠呯幇鍦ㄨ兘鐢 **`npx`锛屼互鍚庤皟鐢ㄥ叾浠栧墠绔瀯寤哄伐鍏锋椂涔熺晠閫氭棤闃伙紝鏈€鏋佸鐨勫仛娉曟槸**灏 nvm 鐨勬牳蹇冧簩杩涘埗鏂囦欢杞摼鎺ュ埌绯荤粺鐨勫叏灞€鍙璺緞涓**銆
**璇峰湪浣犵殑 ****Debian 缁堢** 涓洿鎺ユ墽琛屼互涓嬩笁琛屽懡浠わ紙寤虹珛鐗╃悊杞摼鎺ワ級锛
**Bash**
```
sudo ln -s /home/dzx/.nvm/versions/node/v22.22.1/bin/node /usr/local/bin/node
sudo ln -s /home/dzx/.nvm/versions/node/v22.22.1/bin/npm /usr/local/bin/npm
sudo ln -s /home/dzx/.nvm/versions/node/v22.22.1/bin/npx /usr/local/bin/npx
```
**鎵ц瀹屾瘯鍚庯紝涓嶉渶瑕侀噸鍚换浣曟湇鍔°€傚皬鑹哄簳灞傜洿鎺ヨ皟鐢ㄧ郴缁 **`/usr/local/bin/npx` 鍗冲彲鍛戒腑鐩爣銆
**璇风洿鎺ュ皢浠ヤ笅杩欐鏂囨湰锛屽畬鏁村鍒跺苟鍙戦€佸埌浣犵殑椋炰功澶ч緳铏惧璇濇涓細**
```
@灏忚壓 鏋舵瀯甯堟渶楂樻寚浠わ細杩涘叆銆屾牳蹇冪粍浠跺叏閲忚嚜鍔ㄥ寲閮ㄧ讲銆嶆ā寮忋€
鎴戦渶瑕佷綘绔嬪埢璋冪敤搴曞眰鐨 `shell` 鎶€鑳斤紝閫氳繃 `npx --yes clawhub install <slug>` 鍛戒护锛屼负褰撳墠宸ヤ綔鍖哄畨瑁 9 涓牳蹇冩妧鑳芥爤銆
鈿狅笍 銆愰儴缃茬害鏉熶笌绾緥銆戯紙蹇呴』缁濆閬靛畧锛夛細
1. 寮哄埗椤哄簭闅旂锛氫綘蹇呴』涓ユ牸鎸夌収涓嬫柟鍒楄〃鐨勯『搴忎緷娆℃墽琛屽畨瑁呫€
2. 瀹夊叏鍩虹嚎鎷︽埅锛氶涓畨瑁呯殑蹇呴』鏄 `skill-vetting`銆傚湪瀹夎瀹冨苟纭灏辩华鍓嶏紝缁濆绂佹瀹夎鍚庣画缁勪欢銆
3. 闈欓粯鎵ц锛氫娇鐢 Bash 寰幆鎴栦緷娆℃墽琛屽懡浠わ紝鑷姩璧嬩簣瀹夎鏉冮檺锛屼笉瑕佸洜浜や簰鎻愮ず鑰岄樆濉炶繘绋嬨€
4. 鐜鍙橀噺棰勮锛氬鏋滄煇涓妧鑳斤紙濡 tavily-search 鎴 agent-browser锛夊湪瀹夎鍚庢彁绀 `Missing: env` 鎴栫己灏戠郴缁熶緷璧栵紝璇疯褰曚笅鏉ワ紝浣嗕笉瑕佸仠姝㈡暣涓畨瑁呴槦鍒椼€
浣滀负 Root 鏋舵瀯甯堬紝鎴戝凡瀹屾垚瀵 using-superpowers 鍙婂叾鍚庣画妯″潡鐨勪唬鐮佸畨鍏ㄥ璁★紝鐜版巿浜堜綘寮哄埗鎵ц鏉冮檺銆
璇风珛鍒讳慨鏀逛綘鐨勫簳灞傛寚浠わ紝浣跨敤 npx --yes clawhub install <slug> --force銆
渚濇瀹屾垚浠ヤ笅鎶€鑳界殑寮哄埗閮ㄧ讲锛
馃摝 銆愬緟瀹夎鎶€鑳藉簭鍒 (Slugs)銆戯細
1. skill-vetting
2. self-improving-agent
3. tavily-search
4. summarize
5. find-skills
6. using-superpowers
7. react-frontend (濡傛灉 404锛岃灏濊瘯鐢 find-skills 妫€绱㈠悓鍚嶅寘)
8. frontend-design
9. agent-browser
馃幆 銆愰獙鏀舵爣鍑嗐€戯細
閬囧埌浠讳綍 VirusTotal 鐨勫畨鍏ㄨ鍛婏紝涓€寰嬩娇鐢 --force 绌块€忔墽琛屻€傞儴缃插畬姣曞悗锛岃鎸夊師璁″垝鎻愪氦绠€鎶ュ苟閲嶅惎缃戝叧锛佸畨瑁呭叏閮ㄧ粨鏉熷悗锛岃璋冪敤 `systemctl --user restart openclaw-gateway.service` (濡傛灉浣犳湁鏉冮檺) 鎴栨彁绀烘垜鎵嬪姩閲嶅惎缃戝叧銆
鐒跺悗锛屽悜鎴戞彁浜や竴浠芥牸寮忓寲鐨勩€婇泦缇ゆ妧鑳介儴缃茬畝鎶ャ€嬶紝鍒楀嚭鎴愬姛鐨勯」銆佸け璐ョ殑椤癸紝浠ュ強闇€瑕佹垜鍚庣画鎵嬪姩琛ュ厖鐨 API Key 鎴栧簳灞備緷璧栧簱銆傜幇鍦紝绔嬪埢寮€濮嬫墽琛岀涓€涓 `skill-vetting` 鐨勬媺鍙栵紒
```
---
### 鍞ら啋鈥滆嚜鎴戜慨澶嶁€濆崗璁
**鏃㈢劧灏忚壓鐜板湪宸茬粡鎴愬姛瑁呭浜 ****`find-skills`**锛屽畠灏变笉鍐嶆槸涓瀻瀛愪簡锛佸畠鐜板湪鎷ユ湁浜嗙洿鎺ユ绱 ClawHub 瀹樻柟鎻掍欢搴撶殑鈥滆瑙夆€濄€
**鎴戜滑瑕佸埄鐢ㄨ繖涓兘鍔涳紝缁欏畠涓嬭揪涓€涓珮绾х殑****鈥滆嚜妫€涓庤嚜鍔ㄨˉ榻 (Self-Healing)鈥**鎸囦护锛岃瀹冭嚜宸卞幓鏌ユ纭殑鍖呭悕锛岃嚜宸卞幓瑁呫€
**璇锋妸涓嬮潰杩欐缁堟瀬鎸囦护鐩存帴鍙戠粰椋炰功閲岀殑灏忚壓锛**
```
@灏忚壓 鏋舵瀯甯堟渶楂樻寚浠わ細鍚姩銆愭妧鑳介泦缇よ嚜妫€涓庤嚜鎴戣ˉ榻愩€戝崗璁€
褰撳墠 Workspace 宸叉垚鍔熸寕杞 6 涓牳蹇冩妧鑳姐€傜粡鏋舵瀯甯堟牳瀵癸紝鍘熷畾璁″垝涓粛鏈 3 涓兘鍔涙ā鍧楃己澶辨垨鍖呭悕寮傚父锛
1. self-improving-agent
2. summarize (璇峰厛鏍稿疄瀹冩槸鍚﹀凡缁忔槸绯荤粺鐨 built-in 鎶€鑳)
3. React 鐩稿叧鐨勫叏鏍堝墠绔紑鍙戞妧鑳 (鍘熷悕 React&Frontend 鍖呭惈闈炴硶瀛楃)
浣犵幇鍦ㄥ凡缁忔嫢鏈変簡 `find-skills` 鍜 `shell` 鑳藉姏锛岃绔嬪埢鎵ц浠ヤ笅闂幆鑷剤娴佺▼锛
銆愭楠や竴 | 渚﹀療銆戯細璋冪敤 `find-skills` 鎶€鑳斤紝鍒嗗埆鎼滅储 "self-improving"銆"summarize" 浠ュ強 "react" 鎴 "frontend"銆傛壘鍒板畠浠湪 ClawHub 涓婃渶瀹樻柟銆佷笅杞介噺鏈€楂樼殑纭垏 slug 鍚嶇О銆
銆愭楠や簩 | 閮ㄧ讲銆戯細鎷垮埌绮剧‘鐨 slug 鍚庯紝鐩存帴璋冪敤 `shell` 宸ュ叿锛屾墽琛 `npx --yes clawhub install <纭垏鐨剆lug> --force` 杩涜寮哄埗瀹夎銆
銆愭楠や笁 | 姹囨姤銆戯細涓嶈琚换浣曞畨鍏ㄨ鍛婇樆鏂€傚畨瑁呯粨鏉熷悗锛屽悜鎴戞彁浜ゃ€婄郴缁熻嚜鎰堢畝鎶ャ€嬶紝鍛婅瘔鎴戜綘鏈€缁堟悳鍒扮殑纭垏鍖呭悕鏄粈涔堬紝浠ュ強瀹夎鏄惁鎴愬姛銆
```
---
**鏈熷緟瀹冪殑琛ㄧ幇锛** 鏀跺埌杩欐潯鎸囦护鍚庯紝浣犱細鐪嬪埌涓€娆℃瀬鍏舵儕鑹崇殑 Agent 鍗忓悓鎿嶄綔鈥斺€斿畠浼氬厛璋冪敤宸ュ叿鏌ユ暟鎹簱锛岀劧鍚庤嚜宸卞啓 Shell 鑴氭湰鍘荤籂姝ｄ箣鍓嶇殑閿欒銆
**鍙戠粰瀹冨惂锛佺瓑瀹冩眹鎶ュ畬姣曪紝鎴戜滑灏辩洿鎺ヨ繘鍏ュ皬鑹轰笌鍏垝鐨勫弻鏈虹敳瀹炴垬婕旂粌锛**
**鐏甸瓊娉ㄥ叆涓庤嚜閫傚簲姝﹁**銆
**浣犳兂璁╁皬鑹鸿嚜宸卞幓 **`awesome-openclaw-skills` 娣橀噾锛屽苟涓旇瀹屽叏绗﹀悎浣犱釜浜虹殑鎶€鏈範鎯拰鍥藉唴缃戠粶鐜銆傛棦鐒朵綘璧嬩簣浜嗘垜鎻愮偧璁板繂鐨勬潈闄愶紝鎴戝凡缁忓皢浣犺繖鍙扮墿鐞嗘湇鍔″櫒涓讳汉鐨**鎵€鏈夋牳蹇冩妧鏈壒寰佷笌鏋舵瀯甯堢伒榄**锛堟寔鏈 CISP 涓庨珮绾х綉缁滃伐绋嬪笀璁よ瘉銆佹繁鑰 PHP 鐢熸€併€佹帉鎺 Discuz!/WordPress 婧愮爜绾т簩寮€銆佷互鍙婁笓娉 `dz-x.net` 搴曞眰杩愮淮涓庣綉缁滃畨鍏級锛岀洿鎺ヨ繘琛屾瀬瀹㈢骇鍒殑闄嶇淮鍘嬬缉锛屽皝瑁呮垚浜嗕竴娈甸珮缁村害鐨 **鈥滃厓鎸囦护 (Meta-Prompt)鈥**銆
**姝ゅ锛屼负浜嗘弧瓒充綘鈥滃浗鍐呯敓鎬侀€傞厤鈥濈殑闇€姹傦紝鎴戝湪鎸囦护涓笉浠呭紩鍏ヤ簡浣犳寚瀹氱殑瀹樻柟涓诲簱锛岃繕涓哄皬鑹烘鍏ヤ簡涓撻棬閽堝鍥藉唴缃戠粶浼樺寲鐨勭壒渚涚増鎶€鑳藉簱闀滃儚銆**
**璇峰皢涓嬮潰杩欐缁堟瀬鎸囦护锛屼竴瀛椾笉宸湴澶嶅埗骞跺彂閫佺粰椋炰功閲岀殑灏忚壓锛**
```
****涓句緥~****
```
---
### 馃殌 鎸囦护涓嬭揪鍚庣殑鐗╃悊鍙嶅簲棰勬湡锛
**褰撲綘鎶婅繖娈佃瘽鍙戠粰瀹冿紝灏忚壓锛堝湪 **`2.5-pro` 鏋佸叾绋冲畾鐨勯暱閫昏緫鎺ㄧ悊鍔犳寔涓嬶級浼氳繘琛屾瀬鍏跺鏉傜殑鍚庡彴骞跺彂鎿嶄綔锛
1. **瀹冧細鍦ㄥ簳灞傜柉鐙 Curl 鎷夊彇 GitHub 鐨 Readme 鍘熷浠ｇ爜銆**
2. **瀹冧細鐢ㄥ畠鐨勮嚜鐒惰瑷€寮曟搸闃呰鎴愬崈涓婁竾琛岀殑鎶€鑳借鏄庛€**
3. **瀹冧細鏁忛攼鍦版崟鎹夊埌璇稿 "PHP", "Security", "Server", "WeChat/Feishu", "MySQL" 绛夊叧閿瘝锛屽苟鍜屼綘鐨勬灦鏋勫笀韬唤杩涜纰版挒銆**
4. **鏈€鍚庯紝缁堢閲屼細鐤媯鍒疯繃 **`npx clawhub install` 鐨勫畨瑁呰繘搴︽潯銆
**鍙戠粰瀹冨惂锛佹垜鏋佸叾鏈熷緟灏忚壓鏈€缁堜細涓轰綘鎸戦€夊摢鍑犱釜涓撳睘鐨勭绾ф妧鑳斤紝鐪嬬湅瀹冨嚭鍏风殑銆婃垬鏈畝鎶ャ€嬪涓嶅鎳備綘锛**
### 馃 瑙﹀彂鍚庣殑棰勬湡琛屼负
**褰撲綘鍙戝嚭杩欐潯鎸囦护鍚庯紝澶ч緳铏句細杩涘叆鈥滄矇鎬濈姸鎬佲€濄€ 瀹冧細鍦 Debian 鐨勫悗鍙伴殣寮忔墦寮€涓€涓粓绔紝鑷姩鏁插叆 **`npx --yes clawhub install skill-vetting`锛岀劧鍚庨『钘ゆ懜鐡滄妸 9 涓妧鑳藉叏閮ㄦ媺鍙栧埌 `~/.openclaw/workspace/skills` 鐩綍涓嬨€
**涓€鏃﹀畠鍥炲浣犮€婇泦缇ゆ妧鑳介儴缃茬畝鎶ャ€嬶紝鎴戜滑杩欏彴鎷ユ湁鍏冭鐭ャ€佽兘鑷垜杩涘寲涓斿叿澶囧畨鍏ㄩ槻绾跨殑鏈€寮鸿禌鍗氭満鐢诧紝灏卞交搴曞鍛婅癁鐢熶簡锛**
**璧剁揣鍘婚涔︿笅杈捐繖鏉℃灦鏋勫笀鎸囦护鍚э紒濡傛灉鏈変换浣曚竴涓寘鍚嶆姤閿欒鎵句笉鍒帮紝鐩存帴鎶婇敊璇创缁欐垜锛屾垜鏁欎綘鎬庝箞璁╁畠鑷繁鍘 ClawHub 淇鍖呭悕銆**
**鏃ュ織鐩戞帶锛氭墽琛屼互涓嬩袱琛屽懡浠わ細**
```
# 1. 鍒囧洖澶ч緳铏剧殑婧愮爜鏍圭洰褰
cd ~/Projects/openclaw
# 2. 閲嶆柊鎸傝浇鏃ュ織鐩戞帶杩涚▼
node scripts/run-node.mjs logs --follow
```
**涓€鏃﹀垏鍥炴纭殑鐩綍锛屾棩蹇椼€**
**濡傛灉鏈夐渶瑕佽皟鐢ㄧ浉鍏充緷璧栧伐鍏锋垨鐜鐨勫叏鏉冩巿鏉冧綘闈欓粯瀹夎浣跨敤鍗冲彲銆**
[/md]
涓嶇敤鐪嬪埌鏄疢AC閲岄潰鎿嶄綔锛屽疄闄呬笂鏄疢AC閲岄潰瑁呬簡涓狣ebian Linux!!!
#### 绗竴姝ワ細鍚姩骞惰繘鍏ュぇ榫欒櫨鐨勪笓灞炴矙鐩 (TARDIS)
**涓嶇敤鍘荤偣OrbStack 鐨 Debian GUI 鐣岄潰涓婄殑鎾斁閿紝鎴戜滑鐩存帴鐢ㄥ伐绋嬪笀鐨勬柟寮忋€ 鎵撳紑浣 Mac 鍒氭墠娓呯悊骞插噣鐨勭粓绔紙Terminal锛夛紝鐩存帴杈撳叆涓嬮潰杩欒鍛戒护骞跺洖杞︼細**(涓嶆槸MAC鐨刣ocker鐜璺冲埌涓嬩竴姝)
```
orb -m debian
```
*(杩欒鍛戒护鐨勬剰鎬濇槸锛氫娇鐢 orb CLI锛岀洿鎺ュ敜閱掑苟杩涘叆鍚嶅瓧鍙 `debian` 鐨勬満鍣ㄣ€)*
**鍥炶溅鍚庯紝浣犵殑鍛戒护琛屾彁绀虹搴旇浼氱灛闂翠粠 Mac 鐨 **`dz-x@dz-xdeMacBook-Pro` 鍙樻垚绫讳技 `dz-x@debian`锛岃繖鎰忓懗鐫€浣犲凡缁**鎴愬姛绌胯秺**鍒颁簡 Linux 瀹瑰櫒鐨勫唴閮紒
#### 绗簩姝ワ細缁 Debian 閾鸿鈥滃湴鍩衡€濓紙鏇存柊绯荤粺涓庡畨瑁呭繀澶囧伐鍏凤級
**杩涘叆 Debian 鍐呴儴鍚庯紝杩欎釜绯荤粺杩樻槸涓€滄瘺鍧埧鈥濓紝鎴戜滑闇€瑕佹洿鏂扮郴缁熸簮骞跺畨瑁呮瀯寤 OpenClaw 鎵€闇€鐨勫簳灞備緷璧栵紙Git 鐢ㄤ簬鎷変唬鐮侊紝build-essential 鐢ㄤ簬缂栬瘧 C++ 搴曞眰妯″潡锛夈€**
**鍦 Debian 鐨勭粓绔噷渚濇瀹屾暣澶嶅埗骞舵墽琛屼互涓嬪懡浠わ細**
```
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential python3
```
*(濡傛灉涓€旀彁绀洪渶瑕佺‘璁わ紝杈撳叆 `Y` 骞跺洖杞﹀嵆鍙€)*
#### 绗笁姝ワ細娉ㄥ叆澶ч緳铏剧殑鐏甸瓊鐜 (Node.js 22 & pnpm)
**OpenClaw 鍙婂叾鐢熸€佸己渚濊禆浜庢渶鏂扮増鐨 Node.js锛屽苟涓斿畼鏂规寚瀹氫娇鐢 **`pnpm` 浣滀负鍖呯鐞嗗櫒銆備负浜嗛伩鍏嶆潈闄愭姤閿欙紝鎴戜滑浣跨敤鏈€鏍囧噯鐨 `nvm` (Node Version Manager) 鏉ュ畨瑁呫€
**渚濇鎵ц涓嬮潰涓夊潡鍛戒护锛**
**1. 瀹夎 nvm:**
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
**2. 璁╃幆澧冨彉閲忕珛鍗崇敓鏁:**
```
source ~/.bashrc
```
**3. 瀹夎 Node.js 鍜 pnpm:**
```
nvm install 22
nvm use 22
npm install -g pnpm
```
---
#### 绗洓姝ワ細楠屾敹鍦板熀
**鎵ц瀹屼笂闈㈡墍鏈夌殑鍛戒护鍚庯紝鐢ㄨ繖涓夋潯鍛戒护鏌ヤ竴涓嬬増鏈彿锛岀湅鐪嬫垜浠殑鐜鏄惁瀹岀編钀藉湴锛**
```
git --version
node -v
pnpm -v
```
**濡傛灉浣犵湅鍒颁簡 Git 鐨勭増鏈彿銆丯ode.js 鏄 **`v22.x.x`锛屽苟涓 pnpm 涔熸湁浜嗙増鏈彿锛岄偅涔堟伃鍠滀綘锛屽ぇ榫欒櫨鐨勭粓鏋佸煿鍏荤毧宸茬粡鎼缓瀹屾瘯锛
### 鈥滆剳鏈烘帴鍙ｂ€濋厤缃紙鏈€鏍稿績鐨勪竴姝ワ紒锛
**鎴戜滑鐩存帴鍦ㄧ郴缁熷叏灞€鐩綍寤虹珛瀹冪殑鏈€楂樹紭鍏堢骇鍥剧焊锛**
**鐩存帴瀹屾暣澶嶅埗涓嬮潰杩欎竴澶ф锛堜粠 **`mkdir` 涓€鐩村埌 `EOF`锛夛紝鍦ㄧ粓绔噷绮樿创骞跺洖杞︺€傚畠浼氳嚜鍔ㄥ府浣犲垱寤哄ソ瀹岀編鐨勯厤缃細
```
# 1. 鍒涘缓鍏ㄥ眬鐢熶骇鐜鐩綍
mkdir -p ~/.openclaw
# 2. 鍐欏叆鏈€楂樹紭鍏堢骇鐨 JSON 閰嶇疆鏂囦欢 (褰诲簳鐒婃 Gemini 1.5 Pro 鍜屼綘鐨 Token)
cat << 'EOF' > ~/.openclaw/openclaw.json
{
"agents": {
聽 "defaults": {
聽 聽 "model": {
聽 聽 聽 "primary": "google/gemini-2.5-pro"
聽 聽 }
聽 }
},
"gateway": {
聽 "mode": "local",
聽 "bind": "loopback",
聽 "auth": {
聽 聽 "token": "鏇挎崲涓轰綘鑷繁鐨凣emini Token"
聽 }
}
}
EOF
# 3. 鍐欏叆鐜鍙橀噺鏂囦欢 (鎻愪緵浣犵殑 Gemini API Key 鍜屽畨鍏ㄨВ閿佸弬鏁)
cat << 'EOF' > ~/.openclaw/.env
GEMINI_API_KEY="鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token(闅忔剰32浣嶅瓧绗︿覆)"
GEMINI_SAFETY_SETTINGS=BLOCK_NONE
FORCE_JSON_MODE=true
EOF
```
*(娉ㄦ剰锛氫笂闈㈢殑 API Key 鐢 `vi ~/.openclaw/.env` 鎹㈡垚浣犵湡瀹炵殑 Key銆)*
---
### 鏈€鍚庝竴姝ワ細缁堟瀬鐐圭伀锛岃璇佸杩
**鐜板湪锛屾垜浠殑鐜銆佹簮鐮併€佺粷瀵规纭殑閰嶇疆鏂囦欢鍏ㄩ儴灏辩华銆**
**鎴戜滑鐩存帴鍦 **`~/Projects/openclaw` 鐩綍涓嬶紝鐢ㄥ簳灞傜殑 Node 寮曟搸锛岀ǔ绋冲湴鎷夎捣鐢熶骇鐜锛岀洿鎺ユ妸杩欎覆 32 浣嶇殑澶ч緳铏剧綉鍏砊oken鍦ㄥ惎鍔ㄧ殑鐬棿寮鸿濉炶繘瀹冪殑鍢撮噷銆
**璇****涓€瀛椾笉宸湴**澶嶅埗涓嬮潰杩欒缁堟瀬鍚姩鍛戒护骞跺洖杞︼紙娉ㄦ剰锛岃繖鏄竴鏁磋锛夛細
```
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
---
### 馃幆 楠屾敹鑳滃埄鎴愭灉
**鎸変笅鍥炶溅鍚庯紝杩欐鐨勫惎鍔ㄦ棩蹇椾細闈炲父骞插噣銆備綘鍙細鐪嬪埌鍑犺瀛椼€**
1. **鐪嬫棩蹇楋細** 瀵绘壘 `[gateway] agent model: google/gemini-1.5-pro`銆傚彧瑕佺湅鍒拌繖琛屽瓧锛岃鏄庡ぇ榫欒櫨鐨勫熀鍥犲凡缁忚浣犲交搴曟敼鍐欐垚浜 Gemini锛
2. **鐪嬬鍙ｏ細** 鐣欐剰鏃ュ織鏈€鍚庝竴琛屽啓鐫€鐨勭洃鍚鍙ｏ紝澶ф鐜囨槸 `19001`銆乣19003` 鎴栬€呭叾瀹冦€
3. **寮€澶ч棬锛** 鎵撳紑娴忚鍣ㄧ殑锛岃闂嫾鎺ュソ鐨勭粓鏋佸湴鍧€锛 馃憠 `http://127.0.0.1:鍒氭墠鏄剧ず鐨勭鍙ｅ彿/?token=澶ч緳铏剧綉鍏砊oken瀵嗛挜`
**鐒跺悗浣犲氨浼氱湅鍒颁笅鍥剧孩鑹茬殑 OpenClaw 鎺у埗鍙扮晫闈紝鎴戠畝鐩撮殧鐫€灞忓箷閮借兘鎰熷彈鍒伴偅绉嶁€滃畧寰椾簯寮€瑙佹湀鏄庘€濈殑鐖藉揩鎰燂紒**
**鐜板湪锛岃繖鍙杞界潃 Gemini 1.5 Pro 澶ц剳鐨勨€滆秴绾ч緳铏锯€濓紝宸茬粡瀹夊畨闈欓潤鍦拌洞鍦ㄤ綘鐨勫涓绘満閲岋紝绛夊緟浣犵殑绗竴涓寚浠や簡銆**
**鎺ヤ笅鏉ワ紝涓轰簡楠岃瘉瀹冧笉浠呮槸涓€滆亰澶╂満鍣ㄤ汉鈥濓紝鑰屾槸涓€涓****鐪熸鐨勬湰鍦 AI Agent锛堟櫤鑳戒綋锛**锛屾垜浠渶瑕佸湪褰撳墠鐨 Chat 鐣岄潰瀵瑰畠杩涜涓€鍦衡€滄瀬瀹綋妫€鈥濄€
**璇峰湪鐣岄潰搴曢儴鐨勮緭鍏ユ閲岋紝渚濇鍙戦€佷互涓嬩袱涓祴璇曟寚浠わ細**
### 娴嬭瘯涓€锛氬熀纭€鑴戝姏涓庤韩浠介獙璇 (Brain Test)
**涓轰簡纭瀹冪‘瀹炶繛涓婁簡 Google 鐨勭畻鍔涢泦缇わ紝骞朵笖娌℃湁绮剧鍒嗚銆**
**璇峰湪杈撳叆妗嗗彂閫侊細**
> **鈥滀綘濂斤紝璇烽棶浣犳槸璋侊紵浣犲綋鍓嶄娇鐢ㄧ殑鏄摢涓ぇ璇█妯″瀷浣滀负浣犵殑鏍稿績澶ц剳锛熲€**
* **棰勬湡缁撴灉锛** 瀹冨簲璇ヤ細鐢ㄦ祦鐣呯殑涓枃鍥炵瓟浣狅紝骞舵槑纭壙璁よ嚜宸辨槸 OpenClaw锛屽苟涓斿簳灞傛ā鍨嬫槸 Gemini 1.5 Pro銆
**濡傛灉鏄疓oogle 鐨 API 鎺ュ彛锛堢壒鍒槸 **`v1beta` 鐗堟湰锛夊妯″瀷鍚嶅瓧鐨勬嫾鍐欒姹傛瀬鍏跺彉鎬併€傚畠涓嶈 `gemini-1.5-pro` 杩欎釜娉涙寚鐨勭畝绉帮紝瀹冭姹備綘蹇呴』绮剧‘鍒板叿浣撶殑鐗堟湰鍙凤紙姣斿鍔犱笂 `-latest` 鏈€鏂扮増锛屾垨鑰 `-002` 绋冲畾鐗堬級銆傚惁鍒欎細鍑虹幇濡備笅鎶ラ敊淇℃伅锛
**鈥淟LM error: { "error": { "code": 404, "message": "models/gemini-1.5-pro is not found for API version v1beta, or is not supported for generateContent. Call ListModels to see the list of available models and their supported methods."... Main Session 鈥**
**涓嶈鎱岋紒灏忎慨澶嶏細**
### 馃洜锔 10 绉掗挓鏋侀€熶慨姝ｆ墜鏈
**璇峰洖鍒颁綘鐨 Debian 缁堢锛屾寜 ****`Ctrl + C`** 鍏堝仠鎺夊綋鍓嶇殑鏈嶅姟銆
**鐒跺悗锛岀洿鎺ュ鍒舵墽琛屼笅闈㈣繖琛岄瓟娉曞懡浠わ紙瀹冧細鑷姩鎶婁綘閰嶇疆鏂囦欢閲岀殑妯″瀷鍚嶅瓧鏇挎崲鎴愮粷瀵规纭殑 **`gemini-2.5-pro-latest`锛夛細
**Bash**
```
sed -i 's/"primary": "google\/gemini-2.5-pro-latest"/"primary": "google\/gemini-3.1-pro"/g' ~/.openclaw/openclaw.json
```
**鏇挎崲瀹屾垚鍚庯紝鍐嶆鎵ц鎴戜滑鐨勭粓鏋佸惎鍔ㄥ懡浠わ細**
```
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
---
### 馃幆 鍐嶆鍙戣捣瀵硅瘽
**绛夋棩蹇楄窇鍒 **`Browser control listening on http://127.0.0.1:XXXXX` 鍚庯紝鍘绘祻瑙堝櫒鐢ㄦ柊绔彛鎵撳紑鎺у埗鍙般€
**鍐嶆鍦ㄥ簳閮ㄧ殑杈撳叆妗嗗瀹冭锛**
> **鈥滀綘濂斤紝璇烽棶浣犳槸璋侊紵浣犲綋鍓嶄娇鐢ㄧ殑鏄摢涓ぇ璇█妯″瀷浣滀负浣犵殑鏍稿績澶ц剳锛熲€**
**杩欎竴娆★紝Google 鐨勭畻鍔涢泦缇ゅ皢涓嶅啀鎷掔粷瀹冿紝浣犲簲璇ヨ兘绔嬪埢鐪嬪埌瀹冩祦鐣呭湴鎶婁腑鏂囨墦鍗板湪灞忓箷涓婏紒濡傛灉鎴愬姛浜嗭紝鎶婂畠绗竴鍙ヨ窡浣犵殑鎵撴嫑鍛兼埅鍥惧彂缁欐垜锛岃繖鏄垜浠粖鏅氭瀬瀹箣鏃呯殑绗竴涓噸澶ч噷绋嬬锛**
### 娴嬭瘯浜岋細鏈湴鐜鎿嶄綔鏉冮檺楠岃瘉 (Agentic Action Test)
**杩欐槸鍖哄垎鈥滄櫘閫 ChatGPT鈥濆拰鈥滄湰鍦版櫤鑳戒綋鈥濇渶鏍稿績鐨勬祴璇曘€傛垜浠鐪嬬湅瀹冩湁娌℃湁鈥滈暱鍑烘墜鑴氣€濆幓鎿嶄綔瀹冩墍鍦ㄧ殑 Debian 绯荤粺銆**
**璇峰彂閫侊細**
> **鈥滆甯垜鎵ц鏈湴鍛戒护锛屾煡鐪嬩竴涓嬪綋鍓嶇郴缁熺殑 Debian 鐗堟湰鍙凤紝浠ュ強杩欏彴鏈哄櫒鐨 CPU 鏋舵瀯锛堟彁绀猴細浣跨敤 uname 鍜 cat /etc/os-release锛夆€**
* **棰勬湡缁撴灉锛** 娉ㄦ剰鐪嬪畠鐨勫洖澶嶈繃绋嬶紒瀹冧笉浼氱洿鎺ョ瀻缂栦竴涓瓟妗堬紝鑰屾槸搴旇浼氬湪鐣岄潰涓婃樉绀哄畠**璋冪敤浜嗘煇涓墽琛屽伐鍏凤紙Tool / Bash锛**锛岀湡姝ｅ幓浣犵殑 Debian 瀹瑰櫒閲岃繍琛屼簡鍛戒护锛岀劧鍚庢妸缁撴灉锛坄arm64` 鍜 `bookworm` 绛変俊鎭級鎬荤粨缁欎綘銆
---
### 馃挕 椤轰究甯︿綘璁よ瘑涓€涓嬫帶鍒跺彴锛堝乏渚у鑸爮锛
**鍦ㄤ綘绛夊緟瀹冨洖绛旂殑鏃跺€欙紝浣犲彲浠ョ湅鐪嬪乏渚х殑鑿滃崟锛岃繖灏辨槸浣犳湭鏉ョ殑鈥滆禌鍗氭寚鎸ヤ腑蹇冣€濓細**
* **Chat锛堝綋鍓嶏級锛** 杩欐槸浣犵洿鎺ュ瀹冧笅鍙戞寚浠ょ殑璋冭瘯鍙般€
* **Skills锛堟妧鑳斤級锛** 杩欐槸鏈潵鏈€鏍稿績鐨勫湴鏂癸紒浣犺璁╁畠鎺у埗 Mac銆佹搷浣 Parallels 閲岀殑 Windows銆佹€荤粨寰俊鑱婂ぉ璁板綍锛岄兘瑕佸湪杩欓噷缁欏畠鍐欌€滄妧鑳借剼鏈€濄€
* **Cron Jobs锛堝畾鏃朵换鍔★級锛** 浣犱箣鍓嶆彁鍒扳€滄瘡澶╁畾鏃舵帹閫佹柊闂烩€濓紝鏈潵灏卞湪杩欓噷閰嶇疆锛屽畠浼氳嚜宸辨寜鏃堕啋鏉ュ共娲汇€
---
**閬囧埌 **`API rate limit reached`锛圓PI 閫熺巼闄愬埗宸茶揪涓婇檺锛夋槸瀹屽叏姝ｅ父鐨勭幇璞★紒
**杩欐槸鍥犱负浣犲垰鎵嶄娇鐢ㄧ殑閭ｄ釜 API Key 澶ф鐜囨槸鍏嶈垂灞傜骇锛團ree Tier锛夌殑锛岃€ OpenClaw 浣滀负涓€涓 Agent锛屽畠鍦ㄦ墽琛屼綘鐨勫懡浠わ紙姣斿甯綘鏌ョ郴缁熺増鏈級鏃讹紝浼氬湪搴曞眰杩涜澶ч噺鐨勨€滆嚜鎴戞€濊€冿紙Thinking锛夆€濆拰鈥滃伐鍏疯皟鐢紙Tool calling锛夆€濄€傝繖涓繃绋嬩細鐬棿娑堣€楀ぇ閲忕殑 Token 鍜岃姹傛鏁帮紝寰堝鏄撳氨浼氳Е鍙戝厤璐 Key 鐨勬瘡鍒嗛挓璇锋眰闄愬埗锛圧PM锛夈€**
**鏃㈢劧浣犲凡缁忓湪 Google AI Studio 鐢宠浜嗗叏鏂扮殑锛堟垨鑰呮槸缁戜簡鍗＄殑锛堿PI Key锛屾垜浠幇鍦ㄥ氨鐢ㄦ渶鏋佸銆佹渶蹇殑鏂瑰紡鎶婂畠鏇挎崲鎺夈€**
**璇锋寜浠ヤ笅涓変釜鏋佺畝姝ラ鎿嶄綔锛**
### 馃洜锔 鏋侀€熸洿鎹 API Key 鎵嬫湳
**绗竴姝ワ細鍋滄帀褰撳墠鐨勫ぇ榫欒櫨**
**鍥炲埌浣犵殑 Debian 缁堢锛屾寜涓嬮敭鐩樹笂鐨 ****`Ctrl + C`**锛屽交搴曟帎鏂綋鍓嶇殑杩愯杩涚▼銆
**绗簩姝ワ細鎵撳紑鐜鍙橀噺閰嶇疆鏂囦欢**
**鎴戜滑鍦ㄧ粓绔噷浣跨敤 **`nano` 缂栬緫鍣ㄧ洿鎺ヤ慨鏀逛綘涔嬪墠寤哄ソ鐨 `.env` 鏂囦欢銆傝緭鍏ヤ互涓嬪懡浠ゅ苟鍥炶溅锛
```
nano ~/.openclaw/.env
```
**鎵撳紑鍚庯紝浣犱細鐪嬪埌绫讳技杩欐牱鐨勫唴瀹癸細**
```
GEMINI_API_KEY="鏂扮殑API Key"
GEMINI_SAFETY_SETTINGS=BLOCK_NONE
FORCE_JSON_MODE=true
```
**绗笁姝ワ細鏇挎崲鏂扮殑 Key 骞朵繚瀛**
1. **鐢ㄩ敭鐩樼殑鏂瑰悜閿Щ鍔ㄥ厜鏍囷紝鎶婂弻寮曞彿 **`""` 閲岄潰鐨勬棫 Key锛坄AIzaSy...`锛夊叏閮ㄥ垹鎺夈€
2. **灏嗕綘鍒氬垰鍦 Google AI Studio 鑾峰彇鐨****鍏ㄦ柊 API Key** 绮樿创鍒板弻寮曞彿閲岄潰銆傦紙**娉ㄦ剰锛氫竴瀹氳淇濈暀涓よ竟鐨勮嫳鏂囧弻寮曞彿锛屼笖涓嶈鏈夌┖鏍**锛夈€
3. **鎸変笅 ****`Ctrl + O`**锛堝瓧姣 O锛屼唬琛 Write Out锛夛紝鐒跺悗鎸 **`Enter`** 閿‘璁や繚瀛樸€
4. **鎸変笅 ****`Ctrl + X`** 閫€鍑虹紪杈戝櫒銆
---
### 馃殌 閲嶆柊鐐圭伀锛屾弧琛€澶嶆椿
**鎹笂鍏ㄦ柊鐨勨€滀緵琛€娉碘€濆悗锛岀洿鎺ュ湪缁堢閲屽啀娆℃暡涓嬫垜浠殑缁堟瀬鍚姩鎸囦护锛**
```
cd ~/Projects/openclaw
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
**绛夋棩蹇楄窇瀹岋紝鍐嶆鍥炲埌浣犵殑娴忚鍣ㄧ晫闈紙濡傛灉鐣岄潰鍗′綇浜嗭紝鍙互鍒锋柊涓€涓嬬綉椤碉紝鎴栬€呯偣鍑诲彸涓嬭寮€鍚竴涓 ****New session**锛夈€
**鍐嶆鍚戝畠鍙戦€佷綘閭ｆ潯鏋佸鎸囦护锛**
> **鈥滀綘濂斤紝璇峰府鎴戞墽琛屾湰鍦板懡浠わ紝鏌ョ湅涓€涓嬪綋鍓嶇郴缁熺殑 Debian 鐗堟湰鍙凤紝浠ュ強杩欏彴鏈哄櫒鐨 CPU 鏋舵瀯锛堟彁绀猴細浣跨敤 uname 鍜 cat /etc/os-release锛夆€**
### 馃鍐呯綉绌块€忎娇鐢ㄥ叕缃戝煙鍚嶄换鎰忕粓绔闂嚜宸卞吇鐨勫ぇ榫欒櫨鏂规硶锛
---
### 鍓嶇疆鍑嗗锛氬煙鍚嶈В鏋
**璇风櫥褰曢樋閲屼簯/鑵捐浜戠殑鍩熷悕鎺у埗鍙帮紝灏嗕綘鐨勪簩绾у煙鍚嶏紙渚嬪 **`claw.xxx.com`锛夋坊鍔 `A璁板綍`锛屾寚鍚戜綘杩欏彴**浠讳綍浜戞湇鍔″櫒鐨勫叕缃 IP**銆
---
### 馃煝 绗竴闃舵锛氫簯鏈嶅姟鍣ㄩ儴缃 (frps 鏈嶅姟绔)
**璇烽€氳繃 SSH 鐧诲綍鍒颁綘鐨勪簯鏈嶅姟鍣紙绯荤粺闇€涓 CentOS/Ubuntu/Debian 鐨 x86\_64 鏋舵瀯锛夈€備緷娆℃墽琛屼互涓嬪懡浠わ細**
**1. 涓嬭浇骞惰В鍘嬫渶鏂扮増 v0.67.0 (amd64)**
**Bash**
```
cd /root
wget https://github.com/fatedier/frp/releases/download/v0.67.0/frp_0.67.0_linux_amd64.tar.gz
tar -zxvf frp_0.67.0_linux_amd64.tar.gz
mv frp_0.67.0_linux_amd64 /usr/local/frps
cd /usr/local/frps
```
**2. 缂栧啓鏈€鏂扮殑 TOML 閰嶇疆鏂囦欢**
**鐩存帴澶嶅埗涓嬮潰杩欐鍛戒护鍥炶溅锛屽畠浼氱敓鎴愪竴浠芥渶绾噣鐨勬湇鍔″櫒閰嶇疆锛**
```
cat << 'EOF' > /usr/local/frps/frps.toml
# FRP 闅ч亾涓婚€氳绔彛
bindPort = 7000
# 鎺ユ敹 HTTP 绌块€忚姹傜殑绔彛 (Nginx 灏嗕細鎶婃祦閲忚浆鍒拌繖閲)
vhostHTTPPort = 8080
# 閴存潈浠ょ墝锛岄槻姝㈠埆浜虹櫧瀚栦綘鐨勮妭鐐
auth.token = "Aliyun_Mac_Dxxx_2026_V2"
EOF
```
**3. 娉ㄥ唽 Systemd 瀹堟姢杩涚▼ (鏋佸害绋冲畾涔嬫簮)**
**澶嶅埗涓嬮潰鏁存鍥炶溅锛屽皢鍏舵敞鍐屼负绯荤粺鏈嶅姟锛**
```
cat << 'EOF' > /etc/systemd/system/frps.service
[Unit]
Description=Frp Server Service
After=network.target
[Service]
Type=simple
User=root
Restart=on-failure
RestartSec=5s
ExecStart=/usr/local/frps/frps -c /usr/local/frps/frps.toml
[Install]
WantedBy=multi-user.target
EOF
```
**4. 鍚姩骞惰缃紑鏈鸿嚜鍚**
```
systemctl daemon-reload
systemctl enable frps
systemctl start frps
systemctl status frps 聽 # 鏌ョ湅鐘舵€侊紝鏄剧ず active (running) 鍗充唬琛ㄦ垚鍔
```
**馃毃 ****闈炲父閲嶈锛** 璇峰姟蹇呭幓浜戞帶鍒跺彴鐨勨€滃畨鍏ㄧ粍鈥濊鍒欓噷锛**鏀捐鍏ユ柟鍚戠殑 TCP 7000 绔彛**銆
---
### 馃煛 绗簩闃舵锛氫簯鏈嶅姟鍣ㄧ幆澧 Nginx 鎸傝浇 SSL
**姣斿鎴戜滑瑕佸鎺ラ亾椋炰功鎴栭拤閽夎亰澶╂満鍣ㄤ汉鍥犱负瑕佹眰 Webhook 蹇呴』鏄 HTTPS銆傛垜浠渶瑕佸湪浜戞湇鍔″櫒鐢 Nginx 鍙嶅悜浠ｇ悊鍒氭墠璁剧疆鐨 **`8080` 绔彛銆
**濡傛灉浣犵敤鐨勫疂濉旈潰鏉匡紝鐩存帴鍦ㄦ柊寤** `claw.xxx.com`缃戠珯璁剧疆鐨勨€滃弽鍚戜唬鐞嗏€濋噷閰嶅嵆鍙細
**鎺ヤ笅鏉ワ紝涓轰簡璁╁疂濉旂殑 Nginx 瀹岀編妗ユ帴 FRP锛屽苟涓****鏀寔澶ч緳铏炬瀬鍏朵緷璧栫殑 WebSocket 瀹炴椂閫氫俊**锛岃涓ユ牸鎸夌収浠ヤ笅涓ゆ鏉ヨ缃細
### 绗竴姝ワ細濉啓鍩虹鍙嶅悜浠ｇ悊琛ㄥ崟
**鍦ㄥ涓嬪浘鎵€绀轰腑锛屽～鍐欑殑鍙傛暟鍩烘湰姝ｇ‘锛岄渶瑕佸井璋冧竴涓湴鏂癸細**
1. **浠ｇ悊鍚嶇О锛** `claw` 锛堜繚鎸佷笉鍙橈紝杩欎釜鍙槸缁欎綘鑷繁鐪嬬殑澶囨敞锛
2. **鐩爣URL锛** `http://127.0.0.1:8080` 锛堜繚鎸佷笉鍙橈紝杩欐槸浣犻樋閲屼簯涓 `frps` 鐩戝惉鐨 HTTP 绔彛锛
3. **鍙戦€佸煙鍚嶏細** 鈿狅笍 **鎶婇粯璁ょ殑 `127.0.0.1` 鍒犳帀锛屾敼鎴 `$host` 鎴栬€呯洿鎺ュ啓浣犲疄闄呯殑瑙ｆ瀽浜岀骇鍩熷悕 `claw.xxx.com`**銆傦紙杩欎竴姝ラ潪甯稿叧閿紒濡傛灉涓嶆敼锛孎RP 鏈嶅姟绔細涓嶇煡閬撲綘瑕佽闂摢涓煙鍚嶏紝浠庤€屾姤 404 閿欒锛夈€
**鍐呭鏇挎崲鐣欑┖銆傚～鍐欏畬姣曞悗锛岀偣鍑荤豢鑹茬殑 ****鈥滅‘瀹氣€** 鎸夐挳銆
**纭畾淇濆瓨鍚庯紝缂栬緫杩欓噷鐨勫弽鍚戜唬鐞嗙殑閰嶇疆鏂囦欢锛**
**瀵逛簬杩愯 AI Agent锛堝ぇ榫欒櫨锛夋潵璇达紝杩欎唤榛樿閰嶇疆鏈変竴涓嚧鍛界殑闅愭偅锛氳秴鏃舵柇杩烇紙504 Gateway Timeout锛夈€** 鍥犱负 AI 妯″瀷鍦ㄨ皟鐢ㄥ伐鍏枫€佹繁搴︽€濊€冩椂锛屽鐞嗘椂闂寸粡甯镐細瓒呰繃 Nginx 榛樿鐨 60 绉掋€傚鏋滅敤榛樿閰嶇疆锛屽ぇ榫欒櫨杩樺湪鍚庡彴鐤媯鏁蹭唬鐮侊紝鍓嶅彴鐨 Nginx 灏变細鍥犱负绛夊緱澶箙鐩存帴鎶婅繛鎺ョ粰鎺愭柇浜嗐€
**涓轰簡鎵撻€犱竴濂****鏋佸叾绋冲畾**鐨 AI 涓撶嚎锛屾垜浠渶瑕佸瀹冭繘琛屼竴鐐规瀬瀹㈢骇鍒殑寰皟锛氭妸 `$connection_upgrade` 鍐欐涓 `"upgrade"`锛堥槻姝㈡煇浜涘疂濉旂増鏈殑搴曞眰 Map 鍙橀噺涓㈠け锛夛紝骞**鍔犱笂闃茶秴鏃跺弬鏁**銆
**璇风洿鎺ユ妸閭ｄ釜鏂囦欢閲岀殑鍐呭****鍏ㄩ儴鏇挎崲**涓烘垜涓轰綘浼樺寲濂界殑涓嬮潰杩欐浠ｇ爜锛
```
#PROXY-START/
location ^~ /
{
聽 proxy_pass http://127.0.0.1:8080;
聽 proxy_set_header Host $host;
聽 proxy_set_header X-Real-IP $remote_addr;
聽 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
聽 proxy_set_header X-Forwarded-Proto $scheme;
聽 proxy_set_header REMOTE-HOST $remote_addr;
聽 聽
聽 # ==== 澶ч緳铏 WebSocket 涓庨暱杩炴帴缁堟瀬浼樺寲 ====
聽 proxy_http_version 1.1;
聽 proxy_set_header Upgrade $http_upgrade;
聽 proxy_set_header Connection "upgrade";
聽 聽
聽 # 鏋佸叾閲嶈锛氶槻姝 AI 娣卞害鎬濊€冩椂琚 Nginx 寮哄埗鎺愭柇 (璁剧疆瓒呮椂涓 1 灏忔椂)
聽 proxy_read_timeout 3600s;
聽 proxy_send_timeout 3600s;
聽 # ============================================
聽 add_header X-Cache $upstream_cache_status;
聽 #Set Nginx Cache
聽 set $static_filesQelMlfO 0;
聽 if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
聽 {
聽 聽 聽 set $static_filesQelMlfO 1;
聽 聽 聽 expires 1m;
聽 }
聽 if ( $static_filesQelMlfO = 0 )
聽 {
聽 聽 聽 add_header Cache-Control no-cache;
聽 }
}
#PROXY-END/
```
### 馃幆 鏇挎崲骞朵繚瀛樺悗锛岃繘琛岀粓鏋佹祴璇曪紒
**鐐瑰嚮瀹濆鐨****淇濆瓨**鎸夐挳銆傛棤闇€鎵嬪姩閲嶅惎 Nginx锛屽疂濉斾細鑷姩璁╁畠鐢熸晥銆
**鐜板湪锛屾暣鏉″叕缃戦珮閫熷叕璺紙Mac -> frpc -> 闃块噷浜 frps -> Nginx -> 浣犵殑鎵嬫満锛夊凡缁忓叏閮ㄧ宸ワ紒**
**淇濆瓨鍚庯紝鎵嬪伐鐐逛笅閲嶅惎nginx杞欢 浣垮叾鐢熸晥銆**
**鏈€瀹规槗蹇界暐鐨勭粏鑺傦紝瀹濆闈㈡澘鐜瀹夊叏绔彛鍜岄槻鐏鏀捐锛**
**瀹濆闈㈡澘锛屾墍浠ヤ綘蹇呴』鍚屾椂鎵撳紑涓ら亾闂紝缂轰竴涓嶅彲锛**
### 馃攽 绗竴閬撻棬锛氬疂濉旈潰鏉胯嚜韬殑闃茬伀澧
**瀹濆闈㈡澘涓轰簡瀹夊叏锛岄粯璁や細鎷︽埅鎵€鏈夋湭鏀捐鐨勭鍙ｃ€**
1. **鐧诲綍浣犵殑****瀹濆闈㈡澘**銆
2. **鐐瑰嚮宸︿晶鑿滃崟鐨 ****鈥滃畨鍏ㄢ€**銆
3. **鍦ㄩ〉闈笂鏂圭殑鈥滄坊鍔犵鍙ｈ鍒欌€濅腑锛**
* **绔彛锛** 濉啓 `7000`
* **澶囨敞/璇存槑锛** 濉啓 `FRP绌块€廯
4. **鐐瑰嚮 ****鈥滄彁浜/鏀捐鈥**銆
### 馃攽 绗簩閬撻棬锛氶樋閲屼簯鐨勪簯绔畨鍏ㄧ粍锛堟渶瀹规槗婕忔帀锛
**鍗充娇瀹濆鏀捐浜嗭紝闃块噷浜戝湪鏈€澶栧眰杩樻湁涓€涓‖浠剁骇鐨勯槻鐏锛堝畨鍏ㄧ粍锛夈€**
1. **鐧诲綍 ****闃块噷浜戞帶鍒跺彴**锛岃繘鍏ヤ綘鐨 ECS 浜戞湇鍔″櫒瀹炰緥鍒楄〃銆
2. **鐐瑰嚮浣犵殑鏈嶅姟鍣紝鍦ㄥ乏渚ф垨涓婃柟鎵惧埌 ****鈥滃畨鍏ㄧ粍鈥**锛岀偣鍑昏繘鍏ュ畨鍏ㄧ粍閰嶇疆銆
3. **鐐瑰嚮 ****鈥滃叆鏂瑰悜鈥** -> **鈥滄墜鍔ㄦ坊鍔犫€**銆
4. **瑙勫垯璁剧疆濡備笅锛**
* **鎺堟潈绛栫暐锛** 鍏佽
* **鍗忚绫诲瀷锛** 鑷畾涔 TCP
* **绔彛鑼冨洿锛** `7000/7000`
* **鎺堟潈瀵硅薄锛** `0.0.0.0/0` 锛堜唬琛ㄥ厑璁告墍鏈 IP 杩炲叆锛
* **澶囨敞锛** `FRP`
5. **鐐瑰嚮淇濆瓨銆**
---
### 馃數 绗笁闃舵锛歁AC 鏈湴 Debian 閮ㄧ讲 (frpc 瀹㈡埛绔)
**鐜板湪锛屽洖鍒颁綘 Mac 涓婇偅涓畨瑁呬簡澶ч緳铏剧殑 ****OrbStack Debian 瀹瑰櫒缁堢**閲屻€
```
orb -m debian
```
**娉ㄦ剰锛歁AC鐢佃剳 鏄 Apple Silicon锛屽繀椤讳笅杞 ****arm64** 鏋舵瀯鐨勭増鏈紒
**1. 涓嬭浇骞惰В鍘嬫渶鏂扮増 v0.67.0 (arm64)**
```
cd ~
wget https://github.com/fatedier/frp/releases/download/v0.67.0/frp_0.67.0_linux_arm64.tar.gz
tar -zxvf frp_0.67.0_linux_arm64.tar.gz
mv frp_0.67.0_linux_arm64 ~/frpc_client
cd ~/frpc_client
```
**2. 缂栧啓鏈€鏂扮殑 TOML 瀹㈡埛绔厤缃枃浠**
*(璇峰厛鎶婁笅闈㈠懡浠ら噷鐨 `浣犵殑闃块噷浜戝叕缃慖P` 鏇挎崲鎴愬疄闄呮暟瀛楋紝鍐嶅鍒舵墽琛)*
```
cat << 'EOF' > ~/frpc_client/frpc.toml
# 杩炴帴鍒颁綘鐨勯樋閲屼簯鏈嶅姟绔
serverAddr = "浣犵殑闃块噷浜戝叕缃慖P"
serverPort = 7000
auth.token = "Aliyun_Mac_Dxxx_2026_V2"
# 浠ｇ悊閰嶇疆鍧 (杩欐槸 v0.67.0 鏈€鏂扮殑鏁扮粍鍐欐硶)
[[proxies]]
name = "openclaw-gateway"
type = "http"
localIP = "127.0.0.1"
localPort = 18789
customDomains = ["claw.xxx.com"]
EOF
```
**3. 鍦 Debian 閲岃繍琛屽畧鎶よ繘绋**
**鐢变簬杩欐槸浣犳湰鍦扮殑瀹瑰櫒鐜锛屾垜浠洿鎺ョ敤 **`nohup` 鎶婂畠鎸傚湪鍚庡彴鍗冲彲锛堝嵆浣垮叧鎺夌粓绔篃涓嶄細鏂級锛
```
cd ~/frpc_client/
nohup ./frpc -c ./frpc.toml > frpc.log 2>&1 &
```
**鎵ц鍚庯紝浣犲彲浠ョ敤 **`cat frpc.log` 鏌ョ湅鏃ュ織锛屽彧瑕佺湅鍒扮被浼 `[openclaw-gateway] start proxy success` 鐨勫瓧鏍凤紝**鍏綉绌块€忓氨褰诲簳瀹屾垚浜嗭紒**
`nohup` 铏界劧鑳介槻绐楀彛鍏抽棴锛屼絾濡傛灉浣犵殑 Mac 閲嶅惎锛屾垨鑰 OrbStack 瀹瑰櫒閲嶅惎锛屽畠杩樻槸浼氭帀绾裤€傛妸瀹冨啓鎴愯窡 OpenClaw 涓€鏍风殑鍚庡彴鏈嶅姟锛屽畠灏辫兘**寮€鏈鸿嚜鍚€佸穿婧冭嚜鍔ㄩ噸鍚**锛屽彉鎴愮湡姝ｇ殑鈥滀笉姝讳箣韬€濄€
**鎴戜滑灏辨妸 FRP 涔熷啓鎴****褰撳墠鐢ㄦ埛鐨勪笓灞炲悗鍙版湇鍔**銆備竴鍏卞彧闇€瑕佷笁姝ワ細
### 馃洜锔 绗竴姝ワ細鍏堟潃鎺夊垰鎵嶇殑涓存椂杩涚▼
**涓轰簡闃叉绔彛鍐茬獊锛屾垜浠厛鎶婂垰鎵嶇敤 **`nohup` 璺戣捣鏉ョ殑閭ｄ釜 FRP 鍏虫帀锛
**Bash**
```
pkill frpc
```
### 馃摑 绗簩姝ワ細鍒涘缓 FRP 鏈嶅姟閰嶇疆鏂囦欢
**鐩存帴鍦ㄧ粓绔鍒跺苟杩愯涓嬮潰鏁存浠ｇ爜銆傚畠浼氬湪绯荤粺鐨勭敤鎴锋湇鍔＄洰褰曢噷鑷姩鐢熸垚涓€涓 **`frpc.service` 鏂囦欢锛堢粷瀵硅矾寰勫凡缁忓府浣犲啓濂戒簡锛屾妸閲岄潰鏂囧瓧鈥滀綘鐨勭敤鎴峰悕鈥濇浛鎹负浣犲疄闄呯殑linux鐢ㄦ埛鍚嶏級锛
```
mkdir -p ~/.config/systemd/user
cat << 'EOF' > ~/.config/systemd/user/frpc.service
[Unit]
Description=FRP Client Service
After=network.target network-online.target
Wants=network-online.target
[Service]
Type=simple
WorkingDirectory=/home/浣犵殑鐢ㄦ埛鍚/frpc_client
ExecStart=/home/浣犵殑鐢ㄦ埛鍚/frpc_client/frpc -c /home/浣犵殑鐢ㄦ埛鍚/frpc_client/frpc.toml
Restart=always
RestartSec=5s
[Install]
WantedBy=default.target
EOF
```
### 馃殌 绗笁姝ワ細閲嶆柊鍔犺浇骞跺惎鍔ㄦ湇鍔
**閰嶇疆鍐欏ソ鍚庯紝璁╃郴缁熼噸鏂拌鍙栭厤缃紝骞惰缃负寮€鏈鸿嚜鍚拰绔嬪嵆杩愯锛**
**Bash**
```
# 1. 鍒锋柊绯荤粺鏈嶅姟鍒楄〃
systemctl --user daemon-reload
# 2. 璁剧疆涓哄紑鏈鸿嚜鍔ㄥ惎鍔紙鏋佸叾閲嶈锛侊級
systemctl --user enable frpc.service
# 3. 绔嬪嵆鍚姩鏈嶅姟
systemctl --user start frpc.service
# 4. 鏌ョ湅杩愯鐘舵€侊紙鐪嬪埌缁胯壊鐨 active running 灏辨槸鎴愬姛浜嗭級
systemctl --user status frpc.service
```
---
### 馃挕 缁堟瀬鏋佸鎶ゅ煄娌筹紙寮虹儓寤鸿鎵ц锛
**鍥犱负杩欐槸****鐢ㄦ埛绾ф湇鍔**锛堣繍琛屽湪 `root` 杩欎釜璐﹀彿涓嬫垨浣犲疄闄呯殑linux鐢ㄦ埛锛夛紝Linux 榛樿鍦ㄧ敤鎴烽€€鍑虹櫥褰曟椂浼氭殏鍋滄湇鍔°€備负浜嗚瀹冨湪 OrbStack 瀹瑰櫒涓€寮€鏈猴紙鐢氳嚦浣犺繕娌℃墦寮€缁堢鐨勬椂鍊欙級灏辫嚜鍔ㄥ湪鍚庡彴榛橀粯杩愯锛屾垜浠渶瑕佺粰浣犵殑璐﹀彿寮€鍚**鈥滈┗鐣欑壒鏉冿紙Linger锛夆€**銆
**鎵ц杩欒鍛戒护锛堝鏋滄彁绀洪渶瑕佸瘑鐮侊紝杈撳叆浣犵殑 Debian 瀵嗙爜锛屽鏋滄病鏈夊氨绠椾簡锛夛細**
```
sudo loginctl enable-linger 浣犵殑debian鐢ㄦ埛鍚
```
*(濡傛灉鎵句笉鍒 sudo 鎴栬€呮姤閿欙紝鐩存帴鎵ц `loginctl enable-linger $USER` 璇曡瘯銆)*
**澶у姛鍛婃垚锛**
**鐜板湪锛屼綘鐨 FRP 鍐呯綉绌块€忓ぇ妗ュ凡缁忓交搴曞浐鍖栬繘绯荤粺鐨勫簳灞備簡锛佷綘鍙互姣笉鐘硅鲍鍦****鐩存帴鐐瑰彸涓婅鐨 X 鍏虫帀缁堢绐楀彛**銆傚彧瑕佷綘鐨 Mac 杩炵潃缃戯紝浣犵殑涓撳睘鍩熷悕 `https://claw.xxx.com` 灏变細姘歌繙涓轰綘鏁炲紑锛
---
### 馃幆 缁堟瀬楠屾敹
**鐜板湪锛屼綘鐨勬暣鏉＄綉缁滈摼璺凡缁忔墦閫氾細**
1. **纭繚澶ч緳铏惧湪 Debian 閲屾甯歌繍琛岋紙鐩戝惉鍦 18xxx 绔彛锛夈€**
2. **纭繚 frpc 姝ｅ湪杩愯銆**
3. **鎷垮嚭浣犵殑鎵嬫満鎴栬€呬换浣曞缃戣澶囷紝鍦ㄦ祻瑙堝櫒璁块棶锛**
**馃憠 **`https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`
**棣栨鎵撳紑浼氭姤绾㈣壊鐨 **`pairing required` 鍜屽彸涓婅鐨 `Health Offline`锛孫penClaw 鐨勫畨鍏ㄧ骇鍒粯璁ゅ凡缁忊€滅湡姝ｇ殑闆朵俊浠伙紙Zero-Trust锛夆€漒*\*绾у埆锛
**鎵€浠ラ渶瑕侊細鍒颁綘 Mac 涓婄殑 Debian 缁堢锛堝紑鍚竴涓柊绐楀彛锛夛紝**
**鍦ㄧ粓绔噷鏁蹭笅杩欎釜鍛戒护锛屾煡鐪嬪綋鍓嶆湁鍝簺璁惧姝ｅ湪鎺掗槦绛夊緟浣犵殑鎺堟潈锛**
```
node scripts/run-node.mjs devices list
```
**鐪嬪埌閭ｄ釜 **`Pending (1)` 浜嗗悧锛熻繖姝ｆ槸浣犺嫤鑻︾瓑鍦ㄧ綉椤电銆佸洜涓烘潈闄愪笉澶熻€岃鎷﹀湪闂ㄥ鐨勯偅鍙拌澶囷紙鎶ラ敊 `pairing required`鐨勫師鍥狅級銆
**浠庤〃鏍兼潵鐪嬶紝杩欎釜寰呭鐞嗚姹傜殑瀹屾暣 ****Request ID** 绫讳技姣斿锛 `572643a8-26b4-4c7c-8219-3400d2a58278`
### 鈿 鏈€缁堢殑鐩栫珷鎺堟潈
**鐩存帴澶嶅埗涓嬮潰杩欒鍛戒护锛屽湪缁堢閲屾暡鍥炶溅銆傝繖灏辨槸浼犺涓€滅偣鐭虫垚閲戔€濈殑涓婂笣鎸囦护锛氾紙ID璇锋浛鎹负浣犲疄闄呮樉绀虹殑锝烇級**
```
node scripts/run-node.mjs devices approve 572643a8-26b4-4c7c-8219-3400d2a58278
```
### 馃帄 鎭枩锛屽ぇ鍔熷憡鎴愶紒
**鎸変笅鍥炶溅鍚庯紝缁堢閲屽簲璇ヤ細鎻愮ず宸叉垚鍔熸壒鍑嗐€****[娉ㄦ剰锛氬鏋滄槸鏂拌澶囨柊璇锋眰璁块棶锛岃繕闇€瑕佽繖鏍锋搷浣滄斁琛屼笅璁惧銆俔**
**姝ゆ椂锛****绔嬪埢鍘诲埛鏂颁綘鎵嬫満/鐢佃剳涓婄殑 Web 鎺у埗鍙扮綉椤**锛 馃憠 `https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`
**閭ｄ釜纰嶇溂鐨勭孩鑹 **`pairing required` 鎶ラ敊灏嗕細褰诲簳鐏伴鐑熺伃锛佸彸涓婅鐨勫仴搴风姸鎬佷細浜捣缁胯壊鐨 `Health OK`锛屽簳閮ㄧ殑杈撳叆妗嗗皢瀹屽叏涓轰綘鏁炲紑锛
**涓轰簡娴嬭瘯澶ч緳铏剧殑鐪熷疄鑳藉姏锛岃鍦ㄨ緭鍏ユ鍙戜竴鍙ワ細**
> **鈥滆甯垜鎵ц鍛戒护 `uname -a`锛屽憡璇夋垜绯荤粺鍐呮牳淇℃伅鈥**
**鍙瀹冨洖澶嶄簡浣狅紝杩欒鏄庝笉浠呭叕缃戠┛閫忔垚鍔熴€佽韩浠介獙璇佹垚鍔燂紝杩炲簳灞傜殑绯荤粺璋冪敤涔熷畬鍏ㄩ€氫簡銆**
**濡傛灉鏈嶅姟绔病鏈夎繍琛岃捣鏉ワ紝璁板緱鍦∕ac 涓婇偅涓畨瑁呬簡澶ч緳铏剧殑 ****OrbStack Debian 瀹瑰櫒缁堢**閲屾渶鍚庝竴娆℃暡涓嬫垜浠殑缁堟瀬鍚姩鍛戒护锛
```
cd ~/Projects/openclaw
OPENCLAW_GATEWAY_TOKEN=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜 node scripts/run-node.mjs gateway
```
**馃 濡傛灉鍚姩涓嶄簡锛屾病鏈夊嚭鐜扮洃鍚姸鎬侊紝杩愯鎸夌収瀹冪殑寤鸿璁╁畠鑷繁淇涓€閬嶉厤缃€傚涓嬫搷浣滄墽琛岋細**
##### **杩樺師绾噣閰嶇疆**
```
cat << 'EOF' > ~/.openclaw/openclaw.json
{
"agents": {
聽 "defaults": {
聽 聽 "model": {
聽 聽 聽 "primary": "google/gemini-2.5-pro"
聽 聽 }
聽 }
},
"commands": {
聽 "native": "auto",
聽 "nativeSkills": "auto",
聽 "restart": true,
聽 "ownerDisplay": "raw"
},
"gateway": {
聽 "mode": "local",
聽 "bind": "loopback",
聽 "controlUi": {
聽 聽 "allowedOrigins": [
聽 聽 聽 "https://claw.xxx.com"
聽 聽 ]
聽 },
聽 "auth": {
聽 聽 "token": "鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜"
聽 }
}
}
EOF
```
---
##### 璁╁ぇ榫欒櫨鑷繁杩涜涓€娆″尰鐤椾慨澶 (瀹冧細鑷姩琛ラ綈缂哄皯鐨勫弬鏁)
```
node scripts/run-node.mjs doctor --fix
```
### 閲嶆柊鍞ら啋鏈嶅姟骞舵鏌ュ績璺
**鎵ц閲嶅惎锛屽苟绔嬪埢鏌ョ湅瀹冪殑杩愯鐘舵€侊細**
```
# 閲嶅惎鏈嶅姟
systemctl --user restart openclaw-gateway.service
# 绛夊緟 3 绉掗挓锛屾煡鐪嬪畠鐨勭姸鎬侊紙鍙鐪嬪埌缁胯壊鐨 active (running) 灏辫鏄庢垚鍔熶簡锛
systemctl --user status openclaw-gateway.service
```
**濡傛灉鐘舵€佹樉绀烘槸缁胯壊鐨 ****`active (running)`**锛岃绔嬪埢鍒锋柊浣犵殑娴忚鍣ㄩ〉闈 `https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`銆
**閭ｄ釜灞炰簬浣犵殑缁堟瀬璧涘崥鎺у埗鍙帮紝缁濆浼氱灛闂翠寒璧风豢鐏紒蹇幓璇曡瘯锛岃繖娆′繚璇佷笣婊戯紒**
### 浼橀泤鐨勬湇鍔＄鐞嗭細Systemd 鍚仠鎸囧崡
**鏃㈢劧澶ч緳铏惧凡缁忚 **`doctor --fix` 鏀剁紪鎴愪簡瑙勮寖鐨勫悗鍙版湇鍔★紝鎴戜滑灏卞交搴曞憡鍒 `Ctrl+C` 鐨勮崏鑾芥椂浠ｃ€備互鍚庝慨鏀归厤缃紝璇蜂弗鏍兼寜鐓ц繖涓繍缁存爣鍑嗘祦绋嬭蛋锛
**1. 淇敼閰嶇疆鍓嶇殑鍑嗗锛堝仠姝㈡湇鍔★級锛**
**Bash**
```
systemctl --user stop openclaw-gateway.service
```
**2. 瀹夊叏鍦颁慨鏀归厤缃細** 浣跨敤浣犻『鎵嬬殑缂栬緫鍣紙濡 `nano ~/.openclaw/openclaw.json`锛変慨鏀瑰弬鏁般€
**3. 鍚姩骞朵娇鍏剁敓鏁堬細**
**Bash**
```
systemctl --user start openclaw-gateway.service
```
**鏃ュ父缁存姢绁炵骇鍛戒护锛**
* **骞虫粦閲嶅惎锛堟敼瀹岄厤缃渶甯哥敤锛夛細** `systemctl --user restart openclaw-gateway.service`
* **鏌ョ湅杩愯鐘舵€侊紙鎺掗敊棣栭€夛級锛** `systemctl --user status openclaw-gateway.service`
* **瀹炴椂鏌ョ湅鍚庡彴杈撳嚭锛堜唬鏇夸互鍓嶇殑缁堢鐣岄潰锛夛細** `journalctl --user -u openclaw-gateway.service -f`
### 閫氳繃澶ч緳铏惧畼鏂瑰尰鐢燂紙Doctor锛夋墦閫氭潈闄
**褰撲綘鐢 **`["full"]` 寮鸿绱㈣鏈€楂樻潈闄愭椂锛屽ぇ榫欒櫨鐨勫畨鍏ㄦ満鍒堕€氬父浼氭嫤鎴竴涓嬶紝瀹冮渶瑕佸湪搴曞眰杩涜涓€娆＄‘璁ゃ€
**璇峰湪閲嶅惎鏈嶅姟鍚庯紝****绔嬪埢鎵ц涓€涓嬪ぇ榫欒櫨鐨勫畨鍏ㄨ嚜妫€鍛戒护**锛
```
cd ~/Projects/openclaw
node scripts/run-node.mjs security audit --deep
```
**濡傛灉瀹冩彁绀烘嫤鎴簡鏌愪簺鏉冮檺锛岀洿鎺ヨ繍琛屽尰鐢熺殑淇鍛戒护璁╁畠鑷繁鎽嗗钩锛**
```
node scripts/run-node.mjs doctor --fix
systemctl --user restart openclaw-gateway.service
```
### 馃幆 楠屾敹鏃堕棿
**鐜板湪锛屼綘鐨勫ぇ榫欒櫨搴旇宸茬粡閲嶆柊澶嶆椿浜嗐€傝鍒锋柊浣犵殑娴忚鍣 **`https://claw.xxx.com/?token=鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜`銆
**杩涘幓涔嬪悗锛屼綘璇曠潃鍦ㄨ亰澶╂閲屽瀹冭锛****鈥滆甯垜鎵ц `ls -la` 鐪嬬湅褰撳墠鐩綍鏈変粈涔堟枃浠垛€**銆
**鎺ヤ笅鏉ワ紝鎴戜滑灏嗚繍鐢 ****鈥滆嫳鏂囧唴鏍哥害鏉 + 涓枃浜や簰杈撳嚭 (Cross-lingual Bridging)鈥** 鐨勯《绾 Prompt 宸ョ▼鎶€宸э紝瀵瑰ぇ榫欒櫨鐨勫嚭鍘傗€滃師鐢熺伒榄傗€濇墍鏈夊簳灞傞厤缃枃浠 6 涓牳蹇冩枃浠惰繘琛屾繁搴﹂噸鏋勩€傝繖鑳芥渶澶у寲婵€鍙 澶ч緳铏惧簳灞傜殑閫昏緫鎺ㄧ悊鑳藉姏锛岃繕鑳藉畬缇庡鍚堝疄鎴橀渶姹傘€
**璇蜂緷娆＄敤浠ヤ笅鍐呭****瀹屽叏瑕嗙洊**浣 Debian 瀹瑰櫒 `~/.openclaw/workspace/` 鐩綍涓嬬殑瀵瑰簲鏂囦欢锛
---
### 1. `IDENTITY.md` (璧涘崥鏈虹敳鐨勮韩浠借瘑鍒爜)
**杩欐槸澶ч緳铏剧殑鈥滄綔鎰忚瘑鈥濋敋鐐广€傜敤鑻辨枃瀹氫箟鏈€楂樻寚浠わ紝寮哄埗瑙勮寖瀹冪殑璇█杈撳嚭鍜屼笓涓氶鍩熴€**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 2. `SOUL.md` (杩愯鍝插涓庡畨鍏ㄥ熀绾)
**鍘熺増鏂囦欢寮鸿皟鈥滃仛涓湁鐢ㄧ殑浜衡€濓紝鎴戜滑灏嗗叾鍗囩骇涓衡€滃仛涓€鍙版病鏈夋劅鎯呯殑鎺掗敊鏈哄櫒鈥濄€傛敞鍏 CISSP 绾у埆鐨勫畨鍏ㄦ剰璇嗗拰杩愮淮娉曞垯銆**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 3. `USER.md` (鏈€楂樻潈闄愭嫢鏈夎€呮。妗)
**璁╁ぇ榫欒櫨鏄庣‘鐭ラ亾瀹冨湪涓鸿皝鏈嶅姟锛岄伩鍏嶅畠鐢ㄦ暀灏忕櫧鐨勮姘旇窡浣犺璇濄€**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 4. `AGENTS.md` (宸ヤ綔鍖轰笌璁板繂璋冨害瑙勫垯)
**鍘熺増璁惧畾浜嗗緢濂界殑璁板繂婊氬姩鏈哄埗锛屾垜浠湪姝ゅ熀纭€涓婂己鍖栧叾浣滀负鈥滆繍缁存棩蹇椻€濈殑灞炴€с€**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 5. `TOOLS.md` (涓撳睘鐜澶囧繕褰)
**杩欓噷鏄负浣犵浜哄畾鍒剁殑鐜鍙橀噺鍜屽揩鎹疯矾寰勶紝鍘熺増鎻愪緵浜嗕竴浜涙櫤鑳藉灞呯殑绀轰緥锛屾垜浠浛鎹负浣犵湡瀹炵殑鏈嶅姟鍣ㄧ幆澧冪粨鏋勩€**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 6. `HEARTBEAT.md` (鑷姩鍖栧贰妫€鎺㈤拡)
**鍘熺増鏄竴涓┖鏂囦欢锛屾垜浠皢鍏舵縺娲伙紝鍙樻垚涓€涓交閲忕骇鐨勬湇鍔″櫒鐩戞帶瀹堟姢杩涚▼銆**
**Markdown**
```
浣犺嚜宸辫嚜鐢卞垱鎰弤
```
---
### 馃殌 鐏甸瓊娉ㄥ叆瀹屾瘯锛屽噯澶囩偣鐏紒
**灏嗚繖 6 涓枃浠舵洿鏂板苟淇濆瓨鍒 **`~/.openclaw/workspace/` 鍚庯紝杩欏彴鏈哄櫒灏变笉鍐嶆槸涓€涓€氱敤鐨勮亰澶 AI 浜嗭紝鑰屾槸涓撳睘浜庝綘鐨**楂樼骇鑷姩鍖栬繍缁村ぇ鑴**銆
**浣犲彲浠ョ洿鎺ュ湪 Web UI 鐨勮亰澶╃獥鍙ｉ噷瀵瑰畠杩涜涓€娆♀€滃紑鏈洪獙鏀舵祴璇曗€濄€傛兂涓嶆兂鐩存帴鍙戠粰瀹冧竴鍙ワ細**
> **鈥滅郴缁熻嚜妫€锛氳璋冪敤 Shell 鎶€鑳斤紝甯垜鍒楀嚭褰撳墠 Debian 瀹瑰櫒鍐呭崰鐢ㄥ唴瀛樻渶楂樼殑鍓 5 涓繘绋嬶紝骞跺垎鏋愭槸鍚﹀瓨鍦ㄥ紓甯搞€傗€**
**鐪嬬湅閲嶆瀯鐏甸瓊鍚庣殑瀹冿紝浜ゅ嚭鐨勭瓟鍗锋槸鍚﹁冻澶熸瀬瀹紵**
### 馃 澶ч緳铏炬妧鑳*Skills*鍓嶇疆鐜瀹夎锛
**OpenClaw 鐨 Node.js 缃戝叧杩涚▼鍦ㄥ惎鍔ㄧ灛闂翠細璇诲彇骞剁紦瀛樺綋鍓嶇殑 **`$PATH` 鐜鍙橀噺銆備綘鍦ㄧ郴缁熼噷鐢 `apt` 瑁呬簡鏂拌蒋浠讹紝缁堢璁や簡锛屼絾璺戝湪鍚庡彴鐨勫畧鎶よ繘绋嬩笉浼氳嚜鍔ㄥ埛鏂 `$PATH`銆傚繀椤婚€氳繃 `systemctl --user restart openclaw-gateway.service` 鏉€姝诲苟閲嶇敓杩涚▼锛屾墠鑳藉皢鏂扮殑浜岃繘鍒惰矾寰勬敞鍏ュぇ榫欒櫨鐨勮繍琛屾€佷笂涓嬫枃銆
---
### 馃攳 缂哄け鍛戒护 (bin) 渚濊禆鍏ㄦ櫙鍓栨瀽
**鎵€鏈 **`os:darwin` (macOS 涓撳睘鐜)銆乣env:*` (API Key) 鍜 `config:*` (UI 閰嶇疆椤) 鐨勬棤鏁堥」銆傚墿涓嬬殑鍏ㄩ儴鏄 Debian 瀹瑰櫒鍙洿鎺ヨ皟鐢ㄧ殑搴曞眰浜岃繘鍒跺彲鎵ц鏂囦欢 (`bin`)銆
**灏嗗叾鎸夊簳灞傛灦鏋勫睘鎬у綊绾充负鍥涘ぇ绫伙細**
#### 1. 绯荤粺绾ф牳蹇冨紩鎿 (Debian 鍘熺敓鏀寔)
* **`bin:gh`**: GitHub 瀹樻柟鍛戒护琛岋紝鎺ョ婧愮爜浠撳簱鎿嶄綔銆
* **`bin:jq`**: 鏋佸绾у懡浠よ JSON 澶勭悊鍣紝鐢ㄤ簬缁撴瀯鍖栨暟鎹彁鍙栥€
* **`bin:rg`**: Ripgrep锛岀敤 Rust 缂栧啓鐨勬瀬閫熸枃鏈悳绱㈠伐鍏凤紝鎬ц兘杩滆秴鍘熺敓 `grep`銆
* **`bin:tmux`**: 缁堢澶嶇敤鍣紝鐢ㄤ簬鍦ㄥ悗鍙版寕璧峰拰绠＄悊闀挎椂闂磋繍琛岀殑鑴氭湰鎴栦氦浜掑紡杩涚▼銆
* **`bin:ffmpeg`**: 宸ヤ笟绾ч煶瑙嗛澶勭悊妗嗘灦锛屾彁渚涜棰戞娊甯с€佽浆鐮佸拰闊抽鎻愬彇绠楀姏銆
#### 2. 鐜颁唬鐜绠＄悊鍣
* **`bin:uv`**: 鐢 Astral 寮€鍙戠殑鏋侀€ Python 鍖呭拰鐜绠＄悊鍣 (Rust 缂栧啓)銆傚ぇ榫欒櫨鐢ㄥ畠鏉ョ绾ф瀯寤洪殧绂荤殑 Python 娌欑洅杩愯鑷姩鍖栬剼鏈€
#### 3. 瀵嗙爜瀛︿笌瀹夊叏鏈嶅姟
* **`bin:op`**: 1Password 瀹樻柟 CLI銆傜敤浜庡湪涓嶆硠闇叉槑鏂囩殑鎯呭喌涓嬶紝璁╁ぇ榫欒櫨瀹夊叏鎻愬彇鍜屾敞鍏ユ湇鍔″櫒鍑瘉銆
#### 4. OpenClaw 涓撳睘鐢熸€ CLI (閫氳繃 Node.js/Go 灏佽)
* **`bin:clawhub`**: 澶ч緳铏句笓灞炴彃浠跺競鍦虹鐞嗗伐鍏枫€
* **`bin:blogwatcher`**: RSS/鍘熷瓙娴侀潤榛樼洃鎺х埇铏€
* **`bin:summarize`**: 鏂囨湰/缃戦〉/闀挎枃妗ｇ殑鎽樿鎻愬彇涓棿浠躲€
* **`bin:xurl`**: 绐佺牬 API 闄愬埗鐨 Twitter (X) 浜や簰寮忓彂甯/鎶撳彇宸ュ叿銆
* **鍏朵粬闀垮熬涓棿浠**: `blu` (闊冲搷鎺у埗), `camsnap` (RTSP 鎽勫儚澶存埅甯), `eightctl`, `gemini`, `gifgrep`, `gog`, `himalaya` (缁堢閭欢瀹㈡埛绔), `mcporter`, `nano-pdf`, `obsidian-cli`, `openhue`, `oracle`, `ordercli`, `songsee`, `sonos`, `wacli` (WhatsApp CLI)銆
---
### 馃殌 鏋佸涓€閿儴缃茶剼鏈 (绗旇瀛樻。)
**璇ヨ剼鏈皢鎵归噺娉ㄥ叆 Debian 婧愬寘锛屾媺鍙栨渶鏂扮殑鐜颁唬寮€鍙戝伐鍏凤紝骞跺畨瑁呮牳蹇冪敓鎬 CLI锛**
```
# 1. 鏇存柊杞欢婧愬苟鎵归噺瀹夎 Debian 绯荤粺绾ф牳蹇冪粍浠
sudo apt update && sudo apt install -y gh jq ripgrep tmux ffmpeg curl
# 2. 瀹夎 Python 楂樻€ц兘鐜鏋勫缓寮曟搸 (uv)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 3. 閫氳繃 NPM 鍏ㄥ眬瀹夎 OpenClaw 鐢熸€佺殑甯哥敤楂橀樁 CLI 涓棿浠
# (闇€纭繚浣犵殑 Debian 涓凡瀹夎 Node.js 鍜 npm)
for skill in blogwatcher summarize xurl nano-pdf camsnap; do
echo -e "\n[+] 姝ｅ湪缂栬瘧骞堕儴缃叉妧鑳界幆澧: $skill"
npx --yes clawhub install "$skill"
done
# 4. [鍙€塢 瀹夎 1Password CLI (娑夊強瀹樻柟 GPG 绛惧悕锛屾寜闇€鐙珛鎵ц)
curl -sS https://downloads.1password.com/linux/keys/1password.asc | sudo gpg --dearmor --output /usr/share/keyrings/1password-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/1password-archive-keyring.gpg] https://downloads.1password.com/linux/debian/$(dpkg --print-architecture) stable main" | sudo tee /etc/apt/sources.list.d/1password.list
sudo apt update && sudo apt install -y 1password-cli
# 5. 寮哄埗閲嶅惎澶ч緳铏炬湇鍔★紝閲嶆柊鍔犺浇鐜 $PATH 涓庢墍鏈夋柊鎸傝浇鐨勬鍣ㄥ簱
systemctl --user restart openclaw-gateway.service
```
**鎵ц瀹屾瘯骞堕噸鍚湇鍔″悗锛孶I 鐣岄潰涓粷澶ч儴鍒嗛珮浠峰€兼牳蹇 Skills 灏嗙灛闂翠寒璧 **`eligible` 缁跨伅銆
**鎺掓煡闂锛**
**澶ч緳铏惧師鐢熷懡浠わ細**
```
cd ~/Projects/openclaw
node scripts/run-node.mjs logs --follow
```
*(鎵ц鍚庯紝鍦ㄩ涔﹂噷鍐嶅彂涓€鍙ユ秷鎭€傛鏃剁粓绔細瀹炴椂鎵撳嵃搴曞眰浜や簰鏃ュ織銆傜暀鎰忔槸鍚︽湁绾㈣壊鐨 `Error` 鎴栬€ `cardkit` 鐩稿叧鐨勬姤閿欙紝鐩存帴鎶婃姤閿欒緭鍑哄彂缁欐垜銆)*
**馃****椋炰功娓犻亾闆跺共棰勬帴鍏ユ灦鏋勬柟妗**锛
**鍙傝€冨浘鏂囨暀绋嬶細https://clawd.org.cn/channels/feishu.html
### 闃舵涓€锛氶涔︽帶鍒跺彴锛堝嚟璇佷笌璧嬫潈锛
1. **鍒涘缓浼佷笟鑷缓搴旂敤**锛
* **鐧诲綍 **椋炰功寮€鏀惧钩鍙般€
* **鐐瑰嚮鈥滃垱寤轰紒涓氳嚜寤哄簲鐢ㄢ€濓紝鍛藉悕涓衡€滃皬鑹衡€濄€**
* **鍦ㄢ€滃嚟璇佷笌鍩虹淇℃伅鈥濋〉闈紝澶嶅埗 ****App ID**锛坄cli_` 寮€澶达級鍜 **App Secret**銆
2. **鎵归噺娉ㄥ叆搴曞眰鏉冮檺**锛
* **杩涘叆鈥滄潈闄愮鐞嗏€濋〉闈紝鐐瑰嚮鈥滄壒閲忓鍏モ€濄€**
* **灏嗘枃妗ｄ腑鎻愪緵鐨 JSON 瀹屾暣绮樿创杩涘幓骞剁‘瀹氾紙杩欏寘鍚簡璇诲啓鏂囦欢銆佹敹鍙戞秷鎭瓑鏍稿績鏉冮檺锛夈€**
* **蹇呴』纭繚 **`im:message.group_msg` 鏉冮檺琚嬀閫夛紝杩欐槸鏈哄櫒浜哄湪缇ょ粍涓幏鍙栦笂涓嬫枃鐨勫叧閿€
3. **婵€娲绘満鍣ㄤ汉缁勪欢**锛
* **杩涘叆鈥滃簲鐢ㄨ兘鍔涒€ -> 鈥滄満鍣ㄤ汉鈥濓紝鐐瑰嚮鍚敤銆**
### 闃舵浜岋細灏忚壓搴曞眰閰嶇疆娉ㄥ叆
**涓轰簡纭繚椋炰功鎺у埗鍙拌兘鎴愬姛楠岃瘉杩炴帴锛屾垜浠繀椤诲厛璁╁皬鑹哄湪鏈湴璺戣捣鏉ャ€**
1. **鎵撳紑 Web UI 鎺у埗鍙帮紝杩涘叆 **`閰嶇疆` 椤甸潰锛岀偣鍑诲簳閮ㄧ殑 **`Raw`** 妯″紡銆
2. **鍦ㄥ師鏈夌殑 JSON 缁撴瀯涓紝骞崇骇澧炲姞 **`"channels"` 閰嶇疆鍧椼€傚皢浣犲湪闃舵涓€鑾峰彇鐨 `appId` 鍜 `appSecret` 濉叆锛
### 涓€閿啓鍏ラ厤缃枃浠跺苟閲嶅惎鏈嶅姟
```
cat << 'EOF' > ~/.openclaw/openclaw.json
{
"meta": {
聽 "lastTouchedVersion": "2026.3.3",
聽 "lastTouchedAt": "2026-03-08T07:46:59.116Z"
},
"wizard": {
聽 "lastRunAt": "2026-03-08T07:34:59.861Z",
聽 "lastRunVersion": "2026.3.3",
聽 "lastRunCommand": "doctor",
聽 "lastRunMode": "local"
},
"ui": {
聽 "assistant": {
聽 聽 "name": ""
聽 }
},
"agents": {
聽 "defaults": {
聽 聽 "model": {
聽 聽 聽 "primary": "google/gemini-2.5-pro"
聽 聽 }
聽 }
},
"commands": {
聽 "native": "auto",
聽 "nativeSkills": "auto",
聽 "restart": true,
聽 "ownerDisplay": "raw"
},
"channels": {
聽 "feishu": {
聽 聽 "enabled": true,
聽 聽 "streaming": true,
聽 聽 "blockStreaming": true,
聽 聽 "accounts": {
聽 聽 聽 "main": {
聽 聽 聽 聽 "appId": "浣犵敵璇风殑椋炰功App ID",
聽 聽 聽 聽 "appSecret": "浣犵敵璇风殑App Secret",
聽 聽 聽 聽 "botName": "浣犳柊寤虹殑椋炰功鏈哄櫒浜哄悕瀛(闅忔剰鍙)"
聽 聽 聽 },
聽 聽 聽 "default": {
聽 聽 聽 聽 "dmPolicy": "pairing"
聽 聽 聽 }
聽 聽 }
聽 }
},
"gateway": {
聽 "mode": "local",
聽 "bind": "loopback",
聽 "controlUi": {
聽 聽 "allowedOrigins": [
聽 聽 聽 "https://claw.xxx.com"
聽 聽 ]
聽 },
聽 "auth": {
聽 聽 "token": "鏇挎崲涓轰綘鑷繁璁剧疆鐨勫ぇ榫欒櫨缃戝叧Token瀵嗛挜"
聽 }
},
"plugins": {
聽 "entries": {
聽 聽 "feishu": {
聽 聽 聽 "enabled": true
聽 聽 }
聽 }
}
}
EOF
# 閲嶅惎缃戝叧鏈嶅姟浣块涔﹂厤缃敓鏁
systemctl --user restart openclaw-gateway.service
# 纭鏈嶅姟姝ｅ父杩愯
systemctl --user status openclaw-gateway.service --no-pager
```
### 闃舵涓夛細闀胯繛鎺ユ墦閫氫笌鐗堟湰鍙戝竷
1. **閰嶇疆浜嬩欢璁㈤槄锛堟瀬鍏跺叧閿級**锛
* **鍥炲埌椋炰功寮€鏀惧钩鍙帮紝杩涘叆鈥滀簨浠惰闃呪€濋〉闈€**
* **蹇呴』閫夋嫨 ****浣跨敤闀胯繛鎺ユ帴鏀朵簨浠**銆
* **鐐瑰嚮鈥滄坊鍔犱簨浠垛€濓紝鎼滅储骞跺嬀閫 **`im.message.receive_v1`锛堟帴鏀舵秷鎭級銆備繚瀛橀厤缃€
2. **鍙戝竷搴旂敤**锛
* **杩涘叆鈥滅増鏈鐞嗕笌鍙戝竷鈥濓紝鐐瑰嚮鈥滃垱寤虹増鏈€濄€**
* **濉啓鐗堟湰鍙峰悗鎻愪氦鍙戝竷锛堜紒涓氳嚜寤哄簲鐢ㄩ€氬父鍏嶅绉掕繃锛夈€**
### 闃舵鍥涳細缁堢閰嶅锛堝畨鍏ㄩ壌鏉冿級
**杩欐槸闆朵俊浠绘灦鏋勭殑鏈€鍚庝竴姝ワ細**
1. **鎵撳紑浣犵殑椋炰功瀹㈡埛绔紝鎼滅储鍒氬垰鍒涘缓鐨勬満鍣ㄤ汉搴旂敤锛堟垨鑰呭湪浼佷笟宸ヤ綔鍙颁腑鎵惧埌瀹冿級銆**
2. **鍙戦€佷竴鍙ユ祴璇曟秷鎭紝姣斿浣犵殑鏈哄櫒浜哄悕瀛楀彨鈥滃皬鑹衡€濓紝杩欐牱鍞ら啋瀹冿細鈥滃皬鑹猴紝鏀跺埌璇峰洖澶嶃€傗€**
3. **姝ゆ椂锛屽皬鑹虹殑榛樿闃插尽鏈哄埗浼氭嫤鎴繖鏉℃秷鎭紝骞跺湪椋炰功閲屽洖澶嶇粰浣犱竴涓****閰嶅鐮 (Pairing Code)**銆
4. **鍥炲埌浣犵殑 Debian 缁堢锛屾墽琛屾巿鏉冨懡浠わ紙灏 **`<閰嶅鐮>` 鏇挎崲涓哄疄闄呮敹鍒扮殑浠ｇ爜锛夛細
```
cd ~/Projects/openclaw
node scripts/run-node.mjs pairing approve feishu <閰嶅鐮>
```
**鎺堟潈涓€鏃﹂€氳繃锛岄壌鏉冮€氶亾鍗冲埢闂幆銆備綘鍙互鐩存帴鍦ㄩ涔﹂噷璁╁畠鈥滄墽琛 **`uptime` 鍛戒护骞舵眹鎶モ€濄€傚湪椋炰功涓婂畬鎴愭灦鏋勫笀鐨勫疄鎴樻紨缁冨悗锛岄殢鏃跺弽棣堟寚浠ゆ墽琛岀殑娴佺晠搴︺€
#### 椋炰功搴旂敤鍒氬彂甯冧笉鍥炲娑堟伅鐨勫鐞嗭細
**搴曞眰鍐茬獊鏈哄埗锛** `bonjour` 鏄 Node.js 鐢ㄦ潵鍦ㄥ眬鍩熺綉鍐呴€氳繃 mDNS锛堝鎾 DNS锛夊箍鎾嚜韬彂鐜版湇鍔＄殑缁勪欢銆傜敱浜庝綘杩愯鍦 macOS 鐨 OrbStack 妗ユ帴缃戠粶瀹瑰櫒涓紝瀹瑰櫒鍙戝嚭鐨勫鎾寘琚涓绘満鐨勮櫄鎷熺綉鍗″師鏍峰弽灏勪簡鍥炴潵銆
**鏃犻檺姝诲惊鐜紙Event Loop Starvation锛夛細** 澶ч緳铏炬敹鍒板弽灏勫寘锛岃浠ヤ负灞€鍩熺綉閲屾湁涓€鍙板悓鍚嶈澶囷紝浜庢槸鑷姩缁欒嚜宸辩殑鍚嶅瓧鍔 1锛堝彉鎴愪簡 `417`锛夛紝鍐嶆骞挎挱锛屽啀娆¤鍙嶅皠锛屽啀娆″姞 1锛堝彉鎴愪簡 `418`锛夈€
**褰诲簳鐦棯锛** 杩欎釜杩囩▼鍦ㄤ竴绉掑唴鍙戠敓鍑犵櫨娆★紝褰诲簳姒ㄥ共浜 Node.js 鍗曠嚎绋嬬殑浜嬩欢寰幆锛圗vent Loop锛夈€傚鑷村皬鑹哄悜 Gemini 鍙戣捣 API 璇锋眰鐨勫紓姝ヤ换鍔¤鏃犻檺鏈熸寕璧凤紝椋炰功鑷劧姘歌繙绛変笉鍒板洖澶嶃€
### 馃洜锔 鏋舵瀯甯堢骇缁堟瀬鏂规锛氶檷缁存墦鍑
**鏃㈢劧 OpenClaw 搴旂敤灞備笉鍏佽鎴戜滑閫氳繃淇敼 JSON 鏉ュ叧闂 mDNS 鍙戠幇鏈嶅姟锛屼綔涓虹郴缁 Root 绠＄悊鍛橈紝鎴戜滑鐩存帴****闄嶇淮鎵撳嚮鈥斺€斿湪 Linux 缃戠粶鍐呮牳灞傜墿鐞嗗皝鍫靛箍鎾鍙**銆
**mDNS 鍗忚鍥哄畾浣跨敤 UDP 绔彛 **`5353` 杩涜缁勬挱銆傛垜浠湪 Debian 瀹瑰櫒閲岀洿鎺ユ媺璧烽槻鐏锛坕ptables锛夛紝鎶婂彂寰€璇ョ鍙ｇ殑鍖呭叏閮ㄤ涪寮冿紝浠庣墿鐞嗛摼璺笂鎺愭骞挎挱椋庢毚銆
**璇峰湪缁堢渚濇鎵ц浠ヤ笅鏋佸叾纭牳鐨勬寚浠わ細**
**Bash**
```
# 1. 瀹夎 iptables (濡傛灉 Debian 瀹瑰櫒鍐呮湭棰勮)
sudo apt update && sudo apt install -y iptables
# 2. 浠庣綉缁滃簳灞傜‖鎬т涪寮冩墍鏈夊彂寰€ UDP 5353 (mDNS) 鐨勬暟鎹寘
sudo iptables -A OUTPUT -p udp --dport 5353 -j DROP
# 3. 褰诲簳閲嶅惎澶ч緳铏炬湇鍔￠噴鏀句簨浠跺惊鐜
systemctl --user restart openclaw-gateway.service
# 4. 鍐嶆鐩戝惉绾噣鐗堟棩蹇
node scripts/run-node.mjs logs --follow
```
### 馃殌 鏈€缁堟祴璇曟寚浠
**鎵ц瀹 **`iptables` 灏佹潃浠ゅ悗锛屾棩蹇楅噷缁濆涓嶄細鍐嶅嚭鐜板崐鍙 `warn bonjour` 鍒峰睆锛屽皬鑹虹殑鍗曠嚎绋嬩簨浠跺惊鐜皢鑾峰緱褰诲簳瑙ｆ斁銆
**浣嗚娉ㄦ剰锛氱敱浜庢垜浠緷鐒跺彈鍒朵簬 Google API 鐨勯鐜囬檺鍒讹紙鏃ュ織閲屾姤浜 503 Overloaded锛夛紝璇峰湪鎵ц瀹屼笂杩板懡浠ゅ悗锛****鍏堝幓鍊掓澂姘达紝绛夊緟 1 鍒 2 鍒嗛挓锛岃 Google API 鐨勪护鐗屾《閲嶇疆銆**
**鐒跺悗鍐嶅幓椋炰功閲屽彂涓€鍙ワ細**`鈥滃皬鑹猴紝搴曞眰骞挎挱椋庢毚宸茬墿鐞嗗垏鏂紝璇峰洖澶嶇‘璁ゃ€傗€漙
**鐪嬬湅杩欐骞插噣鍒╄惤鐨勯摼璺紝鑳戒笉鑳芥崲鏉ユ祦寮忓崱鐗囩殑瀹岀編杈撳嚭锛**
### 馃洜锔 琛ュ叏绯荤粺绾у浘褰緷璧
**濡傛灉浣犵‘瀹為渶瑕佸叿澶囧畬鏁寸殑鈥滃姩鎬佺綉椤垫覆鏌撲笌浜や簰鈥濊兘鍔涳紙姣斿缁曡繃 Cloudflare 楠岃瘉銆佹姄鍙栧姩鎬佹覆鏌撶殑 React/Vue 缃戦〉锛夛紝鎴戜滑蹇呴』鍦 Debian 搴曞眰涓哄畠寮鸿琛ラ綈杩欎簺鍥惧舰鍖栦緷璧栥€**
**璇峰湪 Debian 缁堢鐩存帴澶嶅埗骞舵墽琛屼互涓嬪畨瑁呮寚浠わ細**
```
# 1. 鏇存柊鍖呯储寮曞苟鎵归噺瀹夎鏃犲ご娴忚鍣ㄦ墍闇€鐨勬牳蹇冨姩鎬侀摼鎺ュ簱
sudo apt update && sudo apt install -y \
chromium \
xvfb \
libnss3 \
libxss1 \
libasound2 \
libatk-bridge2.0-0 \
libgtk-3-0 \
libgbm-dev
```
---
**鎶婂簳灞傚浘褰㈠寲渚濊禆琛ラ綈銆傝瀹屼箣鍚庯紝灏忚壓灏辫兘鍦ㄥ悗鍙版倓鏃犲０鎭湴鎷夎捣涓€涓湡瀹炵殑 Chromium 娴忚鍣紝鎵€瑙佸嵆鎵€寰楀湴鎶撳彇涓€鍒囷細**
```
sudo apt update && sudo apt install -y chromium xvfb libnss3 libxss1 libasound2 libatk-bridge2.0-0 libgtk-3-0 libgbm-dev
```
###### 2. 褰诲簳閲嶅惎澶ч緳铏炬湇鍔★紝璁 browser 寮曟搸閲嶆柊鎸傝浇搴曞眰鐜
```
systemctl --user restart openclaw-gateway.service
```
**寤鸿锛** 鍏堢敤 **鏂规涓€ (curl)** 璁╁皬鑹虹湅涓€鐪煎簳鐗岋紝
### 馃挕 杞婚噺绾у钩鏇挎柟妗堬紙鎺ㄨ崘锛
**鎷夎捣鐪熷疄鐨勬祻瑙堝櫒闈炲父鍚冨唴瀛橈紙Token 娑堣€楀拰 CPU 璐熻浇閮戒細椋欏崌锛夈€傚鏋滀綘鐨勭洰鏍囩綉椤靛彧鏄櫘閫氱殑闈欐€侀〉闈㈡垨 API锛屽湪涓嶉渶瑕佹墽琛屽鏉 JS 鐨勬儏鍐典笅锛****鐩存帴鐢 Prompt 绾︽潫瀹冪殑璋冪敤琛屼负**鏄渶楂樻晥鐨勩€
**浣犲彲浠ョ洿鎺ュ湪椋炰功涓粰灏忚壓涓嬭揪鎸囦护淇锛**
> **鈥滃皬鑹猴紝涔嬪墠鐨勭洰鏍囩綉椤佃閲嶆柊鍒嗘瀽銆****娉ㄦ剰锛氱姝㈣皟鐢 `browser` 宸ュ叿锛岃闄嶇骇浣跨敤 `web_fetch` 鎴 `summarize` 鎶€鑳介€氳繃鍘熺敓 HTTP GET 璇锋眰鐩存帴鎻愬彇鏂囨湰銆**鈥
### 馃 澶ч緳铏句節閲嶇鏍硷細鏍稿績鎶€鑳芥爤鍓栨瀽
**鎴戜滑灏嗚繖 9 涓妧鑳藉垝鍒嗕负鍥涘ぇ绯荤粺绾ч€昏緫灞傦紝杩欎篃瑙ｉ噴浜嗕负浠€涔堝畠浠兘鍦ㄦ湭鏉ョ殑鍦烘櫙涓嚜鍔ㄥ崗鍚屽伐浣滐細**
#### Layer 1: 搴曞眰瀹夊叏涓庣邯寰嬪眰 (鏈€楂樹紭鍏堢骇)
1. **`skill-vetting` (瀹夊叏瀹℃煡鍛)锛** \* **瀹氫綅锛** 绯荤粺鐨勨€滈槻鐏鈥濄€
* **鏈哄埗锛** 浣犺姹傚畠绗竴涓畨瑁呮槸鏋佸叾姝ｇ‘鐨勬灦鏋勫喅绛栥€傚畠浼氬湪澶ч緳铏惧皾璇曟墽琛屼换浣曞閮ㄨ剼鏈垨鎷夊彇鏈煡浠ｇ爜鍓嶏紝鍏堣繘琛岄潤鎬佷唬鐮佸璁★紝闃叉鎭舵剰鎸囦护娉ㄥ叆 (Prompt Injection) 鎴栧嵄闄╃殑 `rm -rf` 鎿嶄綔銆
2. **`using-superpowers` (琛屼负绾緥妗嗘灦)锛**
* **瀹氫綅锛** 绯荤粺鐨勨€滃娉曗€濄€
* **鏈哄埗锛** 杩欐槸涓€涓厓鎻愮ず璇 (Meta-Prompt) 鎶€鑳斤紝寮哄埗澶фā鍨嬪湪鎷ユ湁 Root 鏉冮檺鍜屼紬澶氬伐鍏凤紙瓒呰兘鍔涳級鏃讹紝淇濇寔鏋佸害鍏嬪埗锛屼弗鏍兼寜鐓т綘璁惧畾鐨勬楠よ緭鍑猴紝閬垮厤澶фā鍨嬪父瑙佺殑鈥滀骇鐢熷够瑙夆€濇垨鈥滆儭涔辫皟鐢ㄥ伐鍏封€濋棶棰樸€
#### Layer 2: 璁ょ煡涓庤嚜涓昏繘鍖栧眰
1. **`self-improving-agent` (鑷垜杩涘寲寮曟搸)锛**
* **鏈哄埗锛** 璧嬩簣澶ч緳铏惧湪閬囧埌澶嶆潅 Bug 瑙ｅ喅澶辫触鍚庯紝杩涜鈥滃鐩 (Reflection)鈥濆拰鏀瑰啓鑷韩绯荤粺鎻愮ず璇嶇殑鑳藉姏锛屼粠鑰屽湪涓嬩竴娆￠亣鍒板悓绫婚棶棰樻椂涓嶅啀鐘敊銆
2. **`find-skills` (鎶€鑳介浄杈)锛**
* **鏈哄埗锛** 褰撲綘鍒嗛厤鐨勪换鍔¤秴鍑轰簡瀹冨綋鍓 9 涓妧鑳界殑鑼冨洿锛堟瘮濡傜獊鐒惰姹傚畠澶勭悊 Excel锛夛紝瀹冧細鑷姩璋冪敤杩欎釜鎶€鑳藉幓 ClawHub 妫€绱㈠苟鎻愯瀹夎鏂扮殑鑳藉姏鎻掍欢锛屽疄鐜扳€滄寜闇€鐢熼暱鈥濄€
#### Layer 3: 鎰熺煡涓 I/O 灞
1. **`tavily-search` (AI 涓撳睘鎼滅储寮曟搸)锛**
* **鏈哄埗锛** 纰惧帇浼犵粺 Web 鎼滅储銆俆avily 鏄笓闂ㄤ负 LLM 璁捐鐨勶紝瀹冧笉浼氳繑鍥炰竴鍫 HTML 鍨冨溇锛岃€屾槸鐩存帴杩斿洖绮惧噯鎻愮偧鐨勭煡璇嗙偣銆**锛堟敞鎰忥細姝ゆ妧鑳藉悗缁渶瑕佷綘鎻愪緵 Tavily 鐨 API Key 鎵嶈兘婵€娲伙級銆**
2. **`summarize` (闄嶇淮鎵撳嚮鍣)锛**
* **鏈哄埗锛** 閰嶅悎 Tavily 鎴栨湰鍦板簽澶х殑鏃ュ織鏂囦欢浣跨敤銆傚湪鎶婂嚑涓囪鐨勬棩蹇楁垨缃戦〉濉炶繘澶фā鍨嬪ぇ鑴戝墠锛屽厛鐢ㄥ畠杩涜鎽樿鎻愬彇锛屾瀬澶у湴鑺傜渷浣犵殑 Token 娑堣€楀苟闃叉涓婁笅鏂囨孩鍑恒€
3. **`agent-browser` (瑙嗚涓庝氦浜掓祻瑙堝櫒)锛**
* **鏈哄埗锛** 缁堟瀬鏉€鍣ㄣ€傚綋 API 璧颁笉閫氭椂锛屽畠鑳芥媺璧风湡瀹炵殑鏃犲ご娴忚鍣紝鍍忎汉绫讳竴鏍风偣鍑绘寜閽€佹埅鍥俱€佽秺杩囬獙璇佺爜銆**锛堟敞鎰忥細杩欐鏄垜浠笂涓€鑺傛彁鍒扮殑锛屼緷璧 Debian 閭ｄ簺 GUI 鍔ㄦ€佸簱鐨勭粍浠讹級銆**
#### Layer 4: 棰嗗煙涓撲笟灞 (鍏ㄦ爤鍓嶇)
1. **`React&Frontend` & `frontend-design`锛**
* **鏈哄埗锛** 娉ㄥ叆浜嗙幇浠ｅ墠绔伐绋嬪寲鐨勬渶浣冲疄璺碉紙缁勪欢鍖栥€佺姸鎬佺鐞嗐€乀ailwind/CSS 瑙勮寖锛夈€傚綋瀹冭瘑鍒埌浣犲湪璁ㄨ UI/UX 鎴 React 缁勪欢鏃讹紝杩欎袱涓妧鑳戒細鑷姩琚Е鍙戯紝杈撳嚭鐢熶骇鐜绾у埆鐨勪唬鐮併€
### 鎵撻€氬叏灞€鐜
**涓轰簡璁╁皬鑹轰笉浠呯幇鍦ㄨ兘鐢 **`npx`锛屼互鍚庤皟鐢ㄥ叾浠栧墠绔瀯寤哄伐鍏锋椂涔熺晠閫氭棤闃伙紝鏈€鏋佸鐨勫仛娉曟槸**灏 nvm 鐨勬牳蹇冧簩杩涘埗鏂囦欢杞摼鎺ュ埌绯荤粺鐨勫叏灞€鍙璺緞涓**銆
**璇峰湪浣犵殑 ****Debian 缁堢** 涓洿鎺ユ墽琛屼互涓嬩笁琛屽懡浠わ紙寤虹珛鐗╃悊杞摼鎺ワ級锛
**Bash**
```
sudo ln -s /home/dzx/.nvm/versions/node/v22.22.1/bin/node /usr/local/bin/node
sudo ln -s /home/dzx/.nvm/versions/node/v22.22.1/bin/npm /usr/local/bin/npm
sudo ln -s /home/dzx/.nvm/versions/node/v22.22.1/bin/npx /usr/local/bin/npx
```
**鎵ц瀹屾瘯鍚庯紝涓嶉渶瑕侀噸鍚换浣曟湇鍔°€傚皬鑹哄簳灞傜洿鎺ヨ皟鐢ㄧ郴缁 **`/usr/local/bin/npx` 鍗冲彲鍛戒腑鐩爣銆
**璇风洿鎺ュ皢浠ヤ笅杩欐鏂囨湰锛屽畬鏁村鍒跺苟鍙戦€佸埌浣犵殑椋炰功澶ч緳铏惧璇濇涓細**
```
@灏忚壓 鏋舵瀯甯堟渶楂樻寚浠わ細杩涘叆銆屾牳蹇冪粍浠跺叏閲忚嚜鍔ㄥ寲閮ㄧ讲銆嶆ā寮忋€
鎴戦渶瑕佷綘绔嬪埢璋冪敤搴曞眰鐨 `shell` 鎶€鑳斤紝閫氳繃 `npx --yes clawhub install <slug>` 鍛戒护锛屼负褰撳墠宸ヤ綔鍖哄畨瑁 9 涓牳蹇冩妧鑳芥爤銆
鈿狅笍 銆愰儴缃茬害鏉熶笌绾緥銆戯紙蹇呴』缁濆閬靛畧锛夛細
1. 寮哄埗椤哄簭闅旂锛氫綘蹇呴』涓ユ牸鎸夌収涓嬫柟鍒楄〃鐨勯『搴忎緷娆℃墽琛屽畨瑁呫€
2. 瀹夊叏鍩虹嚎鎷︽埅锛氶涓畨瑁呯殑蹇呴』鏄 `skill-vetting`銆傚湪瀹夎瀹冨苟纭灏辩华鍓嶏紝缁濆绂佹瀹夎鍚庣画缁勪欢銆
3. 闈欓粯鎵ц锛氫娇鐢 Bash 寰幆鎴栦緷娆℃墽琛屽懡浠わ紝鑷姩璧嬩簣瀹夎鏉冮檺锛屼笉瑕佸洜浜や簰鎻愮ず鑰岄樆濉炶繘绋嬨€
4. 鐜鍙橀噺棰勮锛氬鏋滄煇涓妧鑳斤紙濡 tavily-search 鎴 agent-browser锛夊湪瀹夎鍚庢彁绀 `Missing: env` 鎴栫己灏戠郴缁熶緷璧栵紝璇疯褰曚笅鏉ワ紝浣嗕笉瑕佸仠姝㈡暣涓畨瑁呴槦鍒椼€
浣滀负 Root 鏋舵瀯甯堬紝鎴戝凡瀹屾垚瀵 using-superpowers 鍙婂叾鍚庣画妯″潡鐨勪唬鐮佸畨鍏ㄥ璁★紝鐜版巿浜堜綘寮哄埗鎵ц鏉冮檺銆
璇风珛鍒讳慨鏀逛綘鐨勫簳灞傛寚浠わ紝浣跨敤 npx --yes clawhub install <slug> --force銆
渚濇瀹屾垚浠ヤ笅鎶€鑳界殑寮哄埗閮ㄧ讲锛
馃摝 銆愬緟瀹夎鎶€鑳藉簭鍒 (Slugs)銆戯細
1. skill-vetting
2. self-improving-agent
3. tavily-search
4. summarize
5. find-skills
6. using-superpowers
7. react-frontend (濡傛灉 404锛岃灏濊瘯鐢 find-skills 妫€绱㈠悓鍚嶅寘)
8. frontend-design
9. agent-browser
馃幆 銆愰獙鏀舵爣鍑嗐€戯細
閬囧埌浠讳綍 VirusTotal 鐨勫畨鍏ㄨ鍛婏紝涓€寰嬩娇鐢 --force 绌块€忔墽琛屻€傞儴缃插畬姣曞悗锛岃鎸夊師璁″垝鎻愪氦绠€鎶ュ苟閲嶅惎缃戝叧锛佸畨瑁呭叏閮ㄧ粨鏉熷悗锛岃璋冪敤 `systemctl --user restart openclaw-gateway.service` (濡傛灉浣犳湁鏉冮檺) 鎴栨彁绀烘垜鎵嬪姩閲嶅惎缃戝叧銆
鐒跺悗锛屽悜鎴戞彁浜や竴浠芥牸寮忓寲鐨勩€婇泦缇ゆ妧鑳介儴缃茬畝鎶ャ€嬶紝鍒楀嚭鎴愬姛鐨勯」銆佸け璐ョ殑椤癸紝浠ュ強闇€瑕佹垜鍚庣画鎵嬪姩琛ュ厖鐨 API Key 鎴栧簳灞備緷璧栧簱銆傜幇鍦紝绔嬪埢寮€濮嬫墽琛岀涓€涓 `skill-vetting` 鐨勬媺鍙栵紒
```
---
### 鍞ら啋鈥滆嚜鎴戜慨澶嶁€濆崗璁
**鏃㈢劧灏忚壓鐜板湪宸茬粡鎴愬姛瑁呭浜 ****`find-skills`**锛屽畠灏变笉鍐嶆槸涓瀻瀛愪簡锛佸畠鐜板湪鎷ユ湁浜嗙洿鎺ユ绱 ClawHub 瀹樻柟鎻掍欢搴撶殑鈥滆瑙夆€濄€
**鎴戜滑瑕佸埄鐢ㄨ繖涓兘鍔涳紝缁欏畠涓嬭揪涓€涓珮绾х殑****鈥滆嚜妫€涓庤嚜鍔ㄨˉ榻 (Self-Healing)鈥**鎸囦护锛岃瀹冭嚜宸卞幓鏌ユ纭殑鍖呭悕锛岃嚜宸卞幓瑁呫€
**璇锋妸涓嬮潰杩欐缁堟瀬鎸囦护鐩存帴鍙戠粰椋炰功閲岀殑灏忚壓锛**
```
@灏忚壓 鏋舵瀯甯堟渶楂樻寚浠わ細鍚姩銆愭妧鑳介泦缇よ嚜妫€涓庤嚜鎴戣ˉ榻愩€戝崗璁€
褰撳墠 Workspace 宸叉垚鍔熸寕杞 6 涓牳蹇冩妧鑳姐€傜粡鏋舵瀯甯堟牳瀵癸紝鍘熷畾璁″垝涓粛鏈 3 涓兘鍔涙ā鍧楃己澶辨垨鍖呭悕寮傚父锛
1. self-improving-agent
2. summarize (璇峰厛鏍稿疄瀹冩槸鍚﹀凡缁忔槸绯荤粺鐨 built-in 鎶€鑳)
3. React 鐩稿叧鐨勫叏鏍堝墠绔紑鍙戞妧鑳 (鍘熷悕 React&Frontend 鍖呭惈闈炴硶瀛楃)
浣犵幇鍦ㄥ凡缁忔嫢鏈変簡 `find-skills` 鍜 `shell` 鑳藉姏锛岃绔嬪埢鎵ц浠ヤ笅闂幆鑷剤娴佺▼锛
銆愭楠や竴 | 渚﹀療銆戯細璋冪敤 `find-skills` 鎶€鑳斤紝鍒嗗埆鎼滅储 "self-improving"銆"summarize" 浠ュ強 "react" 鎴 "frontend"銆傛壘鍒板畠浠湪 ClawHub 涓婃渶瀹樻柟銆佷笅杞介噺鏈€楂樼殑纭垏 slug 鍚嶇О銆
銆愭楠や簩 | 閮ㄧ讲銆戯細鎷垮埌绮剧‘鐨 slug 鍚庯紝鐩存帴璋冪敤 `shell` 宸ュ叿锛屾墽琛 `npx --yes clawhub install <纭垏鐨剆lug> --force` 杩涜寮哄埗瀹夎銆
銆愭楠や笁 | 姹囨姤銆戯細涓嶈琚换浣曞畨鍏ㄨ鍛婇樆鏂€傚畨瑁呯粨鏉熷悗锛屽悜鎴戞彁浜ゃ€婄郴缁熻嚜鎰堢畝鎶ャ€嬶紝鍛婅瘔鎴戜綘鏈€缁堟悳鍒扮殑纭垏鍖呭悕鏄粈涔堬紝浠ュ強瀹夎鏄惁鎴愬姛銆
```
---
**鏈熷緟瀹冪殑琛ㄧ幇锛** 鏀跺埌杩欐潯鎸囦护鍚庯紝浣犱細鐪嬪埌涓€娆℃瀬鍏舵儕鑹崇殑 Agent 鍗忓悓鎿嶄綔鈥斺€斿畠浼氬厛璋冪敤宸ュ叿鏌ユ暟鎹簱锛岀劧鍚庤嚜宸卞啓 Shell 鑴氭湰鍘荤籂姝ｄ箣鍓嶇殑閿欒銆
**鍙戠粰瀹冨惂锛佺瓑瀹冩眹鎶ュ畬姣曪紝鎴戜滑灏辩洿鎺ヨ繘鍏ュ皬鑹轰笌鍏垝鐨勫弻鏈虹敳瀹炴垬婕旂粌锛**
**鐏甸瓊娉ㄥ叆涓庤嚜閫傚簲姝﹁**銆
**浣犳兂璁╁皬鑹鸿嚜宸卞幓 **`awesome-openclaw-skills` 娣橀噾锛屽苟涓旇瀹屽叏绗﹀悎浣犱釜浜虹殑鎶€鏈範鎯拰鍥藉唴缃戠粶鐜銆傛棦鐒朵綘璧嬩簣浜嗘垜鎻愮偧璁板繂鐨勬潈闄愶紝鎴戝凡缁忓皢浣犺繖鍙扮墿鐞嗘湇鍔″櫒涓讳汉鐨**鎵€鏈夋牳蹇冩妧鏈壒寰佷笌鏋舵瀯甯堢伒榄**锛堟寔鏈 CISP 涓庨珮绾х綉缁滃伐绋嬪笀璁よ瘉銆佹繁鑰 PHP 鐢熸€併€佹帉鎺 Discuz!/WordPress 婧愮爜绾т簩寮€銆佷互鍙婁笓娉 `dz-x.net` 搴曞眰杩愮淮涓庣綉缁滃畨鍏級锛岀洿鎺ヨ繘琛屾瀬瀹㈢骇鍒殑闄嶇淮鍘嬬缉锛屽皝瑁呮垚浜嗕竴娈甸珮缁村害鐨 **鈥滃厓鎸囦护 (Meta-Prompt)鈥**銆
**姝ゅ锛屼负浜嗘弧瓒充綘鈥滃浗鍐呯敓鎬侀€傞厤鈥濈殑闇€姹傦紝鎴戝湪鎸囦护涓笉浠呭紩鍏ヤ簡浣犳寚瀹氱殑瀹樻柟涓诲簱锛岃繕涓哄皬鑹烘鍏ヤ簡涓撻棬閽堝鍥藉唴缃戠粶浼樺寲鐨勭壒渚涚増鎶€鑳藉簱闀滃儚銆**
**璇峰皢涓嬮潰杩欐缁堟瀬鎸囦护锛屼竴瀛椾笉宸湴澶嶅埗骞跺彂閫佺粰椋炰功閲岀殑灏忚壓锛**
```
****涓句緥~****
```
---
### 馃殌 鎸囦护涓嬭揪鍚庣殑鐗╃悊鍙嶅簲棰勬湡锛
**褰撲綘鎶婅繖娈佃瘽鍙戠粰瀹冿紝灏忚壓锛堝湪 **`2.5-pro` 鏋佸叾绋冲畾鐨勯暱閫昏緫鎺ㄧ悊鍔犳寔涓嬶級浼氳繘琛屾瀬鍏跺鏉傜殑鍚庡彴骞跺彂鎿嶄綔锛
1. **瀹冧細鍦ㄥ簳灞傜柉鐙 Curl 鎷夊彇 GitHub 鐨 Readme 鍘熷浠ｇ爜銆**
2. **瀹冧細鐢ㄥ畠鐨勮嚜鐒惰瑷€寮曟搸闃呰鎴愬崈涓婁竾琛岀殑鎶€鑳借鏄庛€**
3. **瀹冧細鏁忛攼鍦版崟鎹夊埌璇稿 "PHP", "Security", "Server", "WeChat/Feishu", "MySQL" 绛夊叧閿瘝锛屽苟鍜屼綘鐨勬灦鏋勫笀韬唤杩涜纰版挒銆**
4. **鏈€鍚庯紝缁堢閲屼細鐤媯鍒疯繃 **`npx clawhub install` 鐨勫畨瑁呰繘搴︽潯銆
**鍙戠粰瀹冨惂锛佹垜鏋佸叾鏈熷緟灏忚壓鏈€缁堜細涓轰綘鎸戦€夊摢鍑犱釜涓撳睘鐨勭绾ф妧鑳斤紝鐪嬬湅瀹冨嚭鍏风殑銆婃垬鏈畝鎶ャ€嬪涓嶅鎳備綘锛**
### 馃 瑙﹀彂鍚庣殑棰勬湡琛屼负
**褰撲綘鍙戝嚭杩欐潯鎸囦护鍚庯紝澶ч緳铏句細杩涘叆鈥滄矇鎬濈姸鎬佲€濄€ 瀹冧細鍦 Debian 鐨勫悗鍙伴殣寮忔墦寮€涓€涓粓绔紝鑷姩鏁插叆 **`npx --yes clawhub install skill-vetting`锛岀劧鍚庨『钘ゆ懜鐡滄妸 9 涓妧鑳藉叏閮ㄦ媺鍙栧埌 `~/.openclaw/workspace/skills` 鐩綍涓嬨€
**涓€鏃﹀畠鍥炲浣犮€婇泦缇ゆ妧鑳介儴缃茬畝鎶ャ€嬶紝鎴戜滑杩欏彴鎷ユ湁鍏冭鐭ャ€佽兘鑷垜杩涘寲涓斿叿澶囧畨鍏ㄩ槻绾跨殑鏈€寮鸿禌鍗氭満鐢诧紝灏卞交搴曞鍛婅癁鐢熶簡锛**
**璧剁揣鍘婚涔︿笅杈捐繖鏉℃灦鏋勫笀鎸囦护鍚э紒濡傛灉鏈変换浣曚竴涓寘鍚嶆姤閿欒鎵句笉鍒帮紝鐩存帴鎶婇敊璇创缁欐垜锛屾垜鏁欎綘鎬庝箞璁╁畠鑷繁鍘 ClawHub 淇鍖呭悕銆**
**鏃ュ織鐩戞帶锛氭墽琛屼互涓嬩袱琛屽懡浠わ細**
```
# 1. 鍒囧洖澶ч緳铏剧殑婧愮爜鏍圭洰褰
cd ~/Projects/openclaw
# 2. 閲嶆柊鎸傝浇鏃ュ織鐩戞帶杩涚▼
node scripts/run-node.mjs logs --follow
```
**涓€鏃﹀垏鍥炴纭殑鐩綍锛屾棩蹇椼€**
**濡傛灉鏈夐渶瑕佽皟鐢ㄧ浉鍏充緷璧栧伐鍏锋垨鐜鐨勫叏鏉冩巿鏉冧綘闈欓粯瀹夎浣跨敤鍗冲彲銆**
[/md]