Best first path
Member portal command
Copy the Mac install command from your secure portal or welcome email, paste it into Terminal, and press Enter. It includes your access token, so copy the whole line exactly.
Mac install help
Stuck on setup? Start here.
Use the member portal command first. The ZIP/manual path is only the fallback when the command is unavailable or support asks you to use it.
After install
Quick Start
Quick Start is the first-run guide after the files are installed. It helps you answer setup prompts, connect a model, and say hello to your agent.
Fallback
ZIP/manual path
Use the ZIP if the portal command is not available, if you already downloaded files, or if support asks you to recover manually.
What the command does
What “automatic” means
The command downloads a small installer script from TheAgentKit, verifies your access token, downloads the right kit files, starts setup on your Mac, and checks for OpenClaw. If a tool like Node.js or npm is missing, it will pause and tell you what to install next.
It does not silently take over your computer. You stay in Terminal, see what is happening, and can stop with Control + C. Your agent files live locally on your Mac.
Safe copying
Before you paste into Terminal
- Use the command from your secure portal or welcome email, not a screenshot or example.
- Make sure it starts with
TAK_ACCESS_TOKEN=and includestheagentkit.io. - Do not share the command publicly. It contains your access token.
- If anything looks different from the portal command, go back to the portal and copy it again.
“command not found”
You may be missing Node.js, npm, Homebrew, or OpenClaw. Follow the message in Terminal, then run the portal command again. If it mentions OpenClaw, the installer can usually install it once npm is available.
“permission denied”
You are probably in the wrong folder or macOS blocked a downloaded helper file. Use the portal command again, or use the manual ZIP path with bash setup.sh from inside the extracted folder.
“Apple cannot verify”
This usually happens with downloaded app or command files. The portal command avoids the unsigned-app warning. If using the ZIP, Control-click the launcher and choose Open, or run bash setup.sh.
Token or access error
Open the secure portal from your welcome email, copy the command again, and try once more. If the portal says access is missing, email support@theagentkit.io and we will resend or repair access.
Download failed
Check Wi-Fi, VPN, ad blockers, and corporate security tools. Then rerun the same portal command. The installer is safe to retry.
Setup stopped halfway
Copy the last 10–20 lines from Terminal, open Snag or support, and ask for a diagnosis. Do not guess through repeated random commands.
Manual recovery
If you need the ZIP path
- Download the ZIP from your portal.
- Double-click it to extract the folder.
- Open Terminal: Cmd + Space, type Terminal, press Enter.
- Type
cdwith a space after it, drag the extracted folder into Terminal, then press Enter. - Run
bash setup.sh.
bash setup.sh
Still stuck?
Send one useful support message
Include your Mac model if you know it, your macOS version, whether you used the portal command or ZIP, and the last 10–20 Terminal lines. Remove any access token before posting in Discord.