Pag-setup¶

Kung unang beses kang magse‑setup, magsimula sa Getting Started. Para sa mga detalye ng wizard, tingnan ang Onboarding Wizard.

Huling na-update: 2026-01-01

TL;DR¶

• Ang pag-tailor ay nasa labas ng repo: ~/.openclaw/workspace (workspace) + ~/.openclaw/openclaw.json (config).
• Stable na workflow: i-install ang macOS app; hayaan itong patakbuhin ang bundled Gateway.
• Bleeding edge na workflow: patakbuhin mo mismo ang Gateway gamit ang pnpm gateway:watch, tapos hayaan ang macOS app na kumabit sa Local mode.

Prereqs (mula sa source)¶

• Node >=22
• pnpm
• Docker (opsyonal; para lang sa containerized setup/e2e — tingnan ang Docker)

Tailoring strategy (para hindi masakit ang updates)¶

Kung gusto mo ng “100% tailored sa akin” at madadaling update, ilagay ang customization mo sa:

• Konpigurasyon: ~/.openclaw/openclaw.json (parang JSON/JSON5)
• Workspace: ~/.openclaw/workspace (Skills, prompts, memories; gawing private git repo)

Mag-bootstrap nang isang beses:

openclaw setup

Mula sa loob ng repo na ito, gamitin ang local CLI entry:

openclaw setup

Kung wala ka pang global install, patakbuhin ito via pnpm openclaw setup.

Patakbuhin ang Gateway mula sa repo na ito¶

Pagkatapos ng pnpm build, maaari mong patakbuhin ang packaged CLI nang direkta:

node openclaw.mjs gateway --port 18789 --verbose

Stable na workflow (macOS app muna)¶

1. I-install at i-launch ang OpenClaw.app (menu bar).
2. Kumpletuhin ang onboarding/permissions checklist (TCC prompts).
3. Tiyaking Local ang Gateway at tumatakbo (ang app ang namamahala).
4. I-link ang mga surface (halimbawa: WhatsApp):

openclaw channels login

5. Mabilis na pagsusuri:

openclaw health

Kung hindi available ang onboarding sa build mo:

• Patakbuhin ang openclaw setup, pagkatapos openclaw channels login, saka simulan nang manu-mano ang Gateway (openclaw gateway).

Bleeding edge na workflow (Gateway sa terminal)¶

Layunin: magtrabaho sa TypeScript Gateway, makakuha ng hot reload, at panatilihing nakakabit ang macOS app UI.

0. (Opsyonal) Patakbuhin din ang macOS app mula sa source¶

Kung gusto mo ring nasa bleeding edge ang macOS app:

./scripts/restart-mac.sh

1. Simulan ang dev Gateway¶

pnpm install
pnpm gateway:watch

Pinapatakbo ng gateway:watch ang gateway sa watch mode at nagre-reload sa mga pagbabago sa TypeScript.

2. Ituro ang macOS app sa tumatakbong Gateway mo¶

Sa OpenClaw.app:

• Mode ng Koneksyon: Lokal Kakabit ang app sa tumatakbong gateway sa naka-configure na port.

3. I-verify¶

• Dapat magpakita ang in-app Gateway status ng “Using existing gateway …”
• O via CLI:

openclaw health

Mga karaniwang footgun¶

• Maling port: Ang Gateway WS ay default na ws://127.0.0.1:18789; panatilihing pareho ang port ng app at CLI.
• Saan naninirahan ang state:
• Mga Kredensyal: ~/.openclaw/credentials/
• Mga Session: ~/.openclaw/agents/<agentId>/sessions/
• Mga Log: /tmp/openclaw/

Mapa ng credential storage¶

Gamitin ito kapag nagde-debug ng auth o nagpapasya kung ano ang iba-back up:

• WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
• Telegram bot token: config/env o channels.telegram.tokenFile
• Discord bot token: config/env (hindi pa suportado ang token file)
• Slack tokens: config/env (channels.slack.*)
• Pairing allowlists: ~/.openclaw/credentials/<channel>-allowFrom.json
• Model auth profiles: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Legacy OAuth import: ~/.openclaw/credentials/oauth.json Mas detalyado: Security.

Pag-update (nang hindi sinisira ang setup mo)¶

• Panatilihin ang ~/.openclaw/workspace at ~/.openclaw/ bilang “mga gamit mo”; huwag ilagay ang personal na prompts/config sa openclaw repo.
• Pag-update ng source: git pull + pnpm install (kapag nagbago ang lockfile) + patuloy na gamitin ang pnpm gateway:watch.

Linux (systemd user service)¶

Gumagamit ang mga Linux install ng systemd user service. Bilang default, pinipigilan ng systemd ang mga user service sa logout/idle, na pumapatay sa Gateway. Sinusubukan ng onboarding na i‑enable ang lingering para sa iyo (maaaring humingi ng sudo). Kung naka‑off pa rin, patakbuhin:

sudo loginctl enable-linger $USER

Para sa always‑on o multi‑user server, isaalang‑alang ang system service sa halip na user service (hindi kailangan ng lingering). Tingnan ang Gateway runbook para sa mga tala sa systemd.

Kaugnay na docs¶

• Gateway runbook (flags, supervision, ports)
• Gateway configuration (config schema + mga halimbawa)
• Discord at Telegram (reply tags + replyToMode settings)
• OpenClaw assistant setup
• macOS app (gateway lifecycle)