OpenClaw LogoShipClawFast
  • Introduction
  • Prerequisites
  • Clone And Install
  • Supabase Setup
  • Llm Api Keys
  • Vercel
  • Polar Setup
  • Flyio Setup
  • Deploy Api
  • Push Agent Image
  • Environment Variables
  • Going Live
  • How To Customize

How To Customize

Everything is live. Now you just need to make it look and act like your specific business.

Because you followed the Cloud Direct method, you only ever have to change code on your computer in VS Code, and then type one deploy command to push the changes permanently to the internet.


How to Change the Website Colors & Text

1. Open your VS Code window. Navigate to the apps/web/ folder. 2. The website is built using standard Next.js, React, and TailwindCSS. 3. If you want to change the text on the landing page, open apps/web/app/desired-page-to-change/page.tsx and type whatever you want. 4. If you want to change colors, open apps/web/tailwind.config.ts. 5. To push your changes to the internet:

  1. Open terminal inside VS Code.
  2. Type git add .
  3. Type git commit -m "changed text"
  4. Type git push Vercel will immediately see the push and automatically update your live .vercel.app domain in 60 seconds without you doing anything!
Tick the checkbox if you completed the step successfully.

How to Change the AI Personality & Skills

By default, the Starter Kit creates a very basic AI in the customer's cloud container. You want to make it amazing.

1. Open VS Code and navigate to agent/entrypoint.sh. 2. Look around line 7. You will see a massive block of text bounded by EOF. 3. This is exactly where you can type your custom "Prompt Engineering"! You can describe the AI's exact personality, its rules, and its job. 4. Look at the - web_search skills array. You can add or remove skills from the OpenClaw catalog here! 5. To push your upgraded AI Brain to the internet:

  1. Open the terminal and go to the root folder (cd shipclawfast-starter-kit).
  2. Type fly deploy -a your-agent-name --image-label latest (Extracted from your .env file, usually shipclawfast-agent).

From now on, whenever a customer buys a subscription, Fly will stamp out an Agent clone using this new super-smart brain!

Tick the checkbox if you completed the step successfully.

How to Enable OpenAI or Claude if you didn't add the keys initially

Right now, your backend relies entirely on the llm provider based on your keys. If you want to offer your customers the premium ChatGPT or Claude brains:

1. Open your root .env file in VS Code. 2. Add OPENAI_API_KEY=sk-proj... or ANTHROPIC_API_KEY=sk-ant... 3. Open your terminal, change directory to your backend cd apps/api. 4. Shove the new passwords into the cloud vault:

  • Run: pnpm run secrets:push 5. Restart the engine to catch the new keys: fly deploy -a your-api-name 6. Finally, open your Admin Dashboard on your live website, click Models, and toggle gpt-5.2 or claude-sonnet-4.6 to "Enabled"!
Tick the checkbox if you completed the step successfully.

How to Link a Custom Domain (Namecheap, GoDaddy, etc.)

Your website currently lives on a free .vercel.app domain. You probably want it to live on your own official .com.

1. Go to your Vercel Dashboard and open your project. 2. Click Settings at the top, then Domains on the left. 3. Type your newly purchased domain (e.g., shipclawfast.com) and click Add. 4. Vercel will show you a screen with DNS Records (A Records and CNAMEs). 5. Log into where you bought your domain (Namecheap, GoDaddy, Cloudflare, etc.). 6. Find the DNS Settings or Advanced DNS page for your domain. 7. Copy and paste the records exactly as Vercel shows them to you. 8. Wait 5-10 minutes. Vercel will automatically verify the domain and attach a free SSL certificate.

Important Reminder! If you change your domain to a .com, your Live App will momentarily break because Vercel, Fly.io, Supabase, and Polar will all still be looking for your old .vercel.app domain!

You MUST complete these 4 steps to fix it:

  1. Go into your VS Code .env file and change WEB_URL to your new https://www.yournewdomain.com.
  2. Restart Fly.io: Open your terminal in apps/api and push the new .env file to your cloud backend natively the exact same way you did in Step 9:
    • Run: pnpm run secrets:push
    • Then redeploy it: fly deploy -a your-api-name
  3. Go into Supabase Authentication -> URL Configuration and update both the Site URL and the Redirect URLs to use your new .com.
  4. Go into Polar Checkout Links and update the Success/Return URLs to your new .com.
Tick the checkbox if you completed the step successfully.

(Optional) Do I need a custom domain for my API?

Right now, your frontend lives on a beautiful .com, but your backend still lives at https://your-api-name.fly.dev.

Is this a problem? No! Because Vercel and Telegram talk directly to Fly.io behind the scenes, your customers will never actually see the API URL. Everything will work perfectly fine exactly as it is.

However, if you want your backend to look completely professional (e.g. api.shipclawfast.com), you can map it to your custom domain:

1. Open your terminal and navigate to apps/api. 2. Tell Fly to create an SSL certificate for your new subdomain, using your API App Name (the FLY_API_APP_NAME from your .env file, like shipclawfast-api):

fly certs add api.your-new-domain.com -a your-api-name

Note: Only do this for your API App (e.g., shipclawfast-api). Do NOT do this for your Agent machine (e.g., shipclawfast-agent). Customers talk to the API, and the API talks to the Agent!

3. Fly will output a CNAME record (it usually looks like a long string ending in .flycast or your fly app URL). 4. Go to your DNS provider (Namecheap, GoDaddy, Vercel) and create a new CNAME record:

  • Name/Host: api
  • Value: [The value Fly.io just gave you] 5. Once the certificate is verified by Fly, you must go to Vercel and change NEXT_PUBLIC_API_URL to your new https://api.your-new-domain.com.
Tick the checkbox if you completed the step successfully.
Category: cloud-directShipClawFast Engine